Cloud Storage FUSE ログを Cloud Logging に転送する

このページでは、Cloud Storage FUSE ログを Cloud Logging に転送する方法について説明します。

概要

Cloud Storage FUSE ログは、Cloud Storage FUSE の動作を把握し、問題のトラブルシューティングとパフォーマンスのモニタリングに役立ちます。--log-severity CLI オプションまたは logging:severity 構成フィールドを使用してログを生成すると、Cloud Storage FUSE によってログが生成され、Cloud Storage FUSE が実行されているマシンの標準出力またはローカル ログファイルとして表示できます。

Cloud Storage FUSE ログを Cloud Logging に転送することもできます。これには次のようなメリットがあります。

  • Trusted Cloud コンソールの 1 か所で Cloud Storage FUSE のすべてのログを表示できます。これにより、Cloud Storage FUSE の動作を包括的に把握し、さまざまなコンポーネント間のイベントを関連付けやすくなります。

  • 重大度レベル、タイムスタンプ、リソースタイプなどのフィールドで Cloud Storage FUSE ログをフィルタリングすると、エラーやパフォーマンスの問題を特定できます。

  • 特定のログイベントによってトリガーされる指標ベースのアラートを作成します。たとえば、Cloud Storage FUSE からの error または warning ログメッセージが検出されるたびに通知されるようにアラートを設定すると、問題に事前に対処できます。

  • ログを構成可能な期間 Cloud Logging に保存し、長期保存、アーカイブ、詳細な分析のために Cloud Storage にエクスポートします。

料金

Cloud Logging の料金については、Cloud Logging の費用をご覧ください。

必要なロールを取得する

Cloud Logging を使用して Cloud Storage FUSE ログを表示するために必要な権限を取得するには、指標を収集するプロジェクトに ログ書き込み（roles/logging.logWriter）IAM ロールを付与します。

この事前定義ロールには、Cloud Logging の使用に必要な権限が含まれています。ログ書き込みロールの詳細については、roles/logging.logWriter に関する IAM のドキュメントをご覧ください。

プロジェクトにロールを付与する手順については、プロジェクトへのアクセス権を管理するをご覧ください。

始める前に

  1. Cloud Storage API を有効にします。

    Cloud Storage API に移動

  2. Cloud Logging API を有効にします。

    Cloud Logging API に移動

  3. ログと指標を収集するための Trusted Cloud by S3NSのプライマリ エージェントである Cloud Ops エージェントをインストールします。使用している仮想マシンのタイプに基づいてインストール方法を選択します。

  4. --log-severity CLI オプションまたは severity フィールドを trace に設定して、ロギングの重大度を trace に設定します。

Cloud Storage FUSE ログを Cloud Logging に転送する

  1. gcsfuse マウントに /gcsfuse.log を指定します。

    logging:
  file-path: "/gcsfuse.log"
  severity: trace

  2. 次の構成を使用して、/gcfuse.log ファイルから Cloud Logging にログを転送するように Cloud Ops エージェントを構成します。この構成では、gcsfuse_trace_logs は /gcsfuse.log ファイルからログを受信する receiver 要素です。service 要素は、パイプライン内の receiver 要素をリンクします。

    logging:
 receivers:
  gcsfuse_trace_logs:
  type: files
  include_paths:
  - /gcsfuse.log
service:
 pipelines:
   gcsfuse_pipeline:
     receivers: [gcsfuse_trace_logs]

    その他のロギング構成については、Cloud Logging の構成をご覧ください。

  3. Cloud Ops エージェントの構成は、オペレーティング システムに基づくパスに配置します。構成を配置するパスを選択するには、ユーザー指定の構成に関する Google Cloud Observability のドキュメントをご覧ください。

  4. systemctl restart コマンドを使用して Cloud Ops エージェントを再起動し、新しい構成の変更を読み込みます。

    sudo systemctl restart google-cloud-ops-agent`

  5. Trusted Cloud コンソールで Cloud Logging に移動します。

  6. fuse_debug フィルタリング クエリを実行して、Cloud Logging に転送される gcsfuse トレースログを検証します。

次のステップ