MCP Server Google Logging

🚀 gcloud ログ取得ツール

このツールは、gcloud CLI を使用してプロジェクト関連のログ情報を取得するためのものです。前提条件を満たすことで、様々なログ管理操作が可能です。

🚀 クイックスタート

前提条件

• gcloud CLI を使用できること
• gcloud アカウントにログイン済みであること
• IAM 権限を持っていること

要求事項

• YAML 形式で返す --> --format yaml
• ログ内容は基本的な必要情報にする（クエリを調整可）。
  • 内容, リソース名, タイムスタンプ
• 起動パラメータ：
  • プロジェクト ID

✨ 主な機能

ログ取得の背景

問題

プロジェクト関連のログ情報をどのように取得するか？YS4B、無印、独栋などの異なる文脈では、ログ出力方法とドメイン知識が異なります。これらの違いをどのように反映させるか？

アイデア

• a. gcloud logging の MCP Server をリソースとして設定し、取得可能にする
  • この場合、MCP Server は一定の業務知識を前提とする必要があります --> 許容可能
  • 内容: データベース構造、ログ、クエリテクニックなどの知識
• b. 他のドメイン知識を取得するための専用の MCP Server を作成する
  • 疎結合は利点ですが、管理が複雑になる可能性があります

まずは a 案を試し、MCP Server をリソースとして取得可能にします。

リソース

• OCPP 関連：
  • トランザクション、状態、接続状態
• サービス関連：
  • 予約
  • 使用ログ
  • 管理者

制限事項

• SELECT のようなフィルタリングはできません

gcloud 機能

ログの読み取りと表示

• 🔵 gcloud logging read - 指定されたフィルタ条件に基づいて一致するログエントリを取得します。- リソースタイプ、タイムスタンプ、ログレベル（severity）などの条件を設定でき、AND、OR を組み合わせて複雑なフィルタリングも可能です。
• 出力形式は JSON または表形式などに調整でき、gcloud の標準オプションを使用して実現します。

リアルタイムログ監視

• ❌ gcloud logging tail - ログの書き込み状況をリアルタイムで追跡できます。

ログリストの表示と管理

• gcloud logging logs list - プロジェクト内のすべてのログをリストします。
• ❌ gcloud logging logs delete - 不要なログを削除できます。ただし、この操作は元に戻せないことに注意してください。

ログストレージバケットの管理

• gcloud logging buckets list - ログが保存されているストレージバケットのリストを表示します。
• gcloud logging buckets describe / update - 各ストレージバケットの詳細情報を表示したり、保持期間などの設定を調整したりします。

ログエクスポートの管理

• gcloud logging sinks list - ログを自動的に Cloud Storage、BigQuery、Pub/Sub などの外部場所にエクスポートするターゲット（エクスポートターゲット）のリストを表示します。
• gcloud logging sinks create / update / delete - 新しいエクスポート先を作成したり、既存のエクスポート先の設定を変更したり、不要なエクスポート先を削除したりします。

ログベースのメトリクスの管理

• gcloud logging metrics list - ログに基づいて作成されたすべてのメトリクスをリストします。
• gcloud logging metrics create / update / delete - 特定のログ条件に基づいてメトリクスを作成、変更、または削除します。
• これらのメトリクスを使用して、監視やアラートのトリガーを設定できます。

💻 使用例

基本的な使用法

node -- /path/to/mcp-server-google-logging/dist/index.js --project=<プロジェクト-id>

📚 ドキュメント

関連情報

gcloud CLI を使用したログエントリの書き込みとクエリ