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

このドキュメントでは、Cloud Storage FUSE ログを Cloud Logging に転送する方法について説明します。

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

Cloud Storage FUSE ログを Cloud Logging に転送することもできます。これには次の利点があります。

  • Cloud Storage FUSE のすべてのログを Google Cloud コンソールの一か所に表示できます。これにより、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. Cloud Ops エージェントをインストールします。これは、ログと指標を収集するための Google Cloudのプライマリ エージェントです。使用している仮想マシンのタイプに基づいてインストール方法を選択します。

  4. --log-severity オプションまたは 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. Google Cloud コンソールで [Cloud Logging] に移動します。

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

次のステップ