このドキュメントでは、バケット スコープのログベースの指標の特徴と、プロジェクト スコープのログベースの指標との違いについて説明します。
バケット スコープのログベースの指標の特性
バケット スコープのログベースの指標は、特定のログバケットに転送されたログエントリを評価するユーザー定義のログベースの指標です。バケット スコープのログベースの指標を使用すると、次の場合にログからデータを抽出するログベースの指標を作成できます。
- あるプロジェクトから別のプロジェクトのバケットに転送されるログ。
- 集約シンクを介してバケットに転送されるログ。
プロジェクト スコープのログベースの指標と同様に、バケット スコープのログベースの指標は、フォルダレベルや組織レベルではなく、Google Cloud プロジェクト内で定義されます。ログエントリがバケットに転送されたフォルダまたは組織を追跡する場合は、ログベースの指標でラベルを定義して、その情報を記録できます。
- ログベースの指標の一般的な情報については、ログベースの指標の概要をご覧ください。
- ルーティングとシンクの詳細については、ルーティングとストレージの概要をご覧ください。
バケット スコープのログベースの指標は、プロジェクト スコープのログベースの指標とはいくつかの点で異なります。
プロジェクトと指標スコープ
バケット スコープのログベースの指標は、ソースバケットを含むプロジェクトで定義されます。デフォルトでは、バケット スコープのログベースの指標を定義したプロジェクトのみが、ログバケットの指標データを表示できます。ただし、プロジェクトが他のプロジェクトの指標スコープに表示されている場合は、それらのプロジェクトも指標を表示できます。
ログをバケットに転送する Google Cloud プロジェクトは、どのプロジェクトの指標スコープにも存在する必要がありません。
ログベースの指標と指標のスコープの詳細については、指標スコープの可視性をご覧ください。
ログがバケットで受信されると、派生したログ指標データは、その指標スコープがバケットのプロジェクトを含む任意のプロジェクトに表示されます。プロジェクト ルーティング ログがどのプロジェクトの指標スコープにも含まれていない場合、ルーティング プロジェクトの他の情報は表示されません。
バケット スコープのログベースの指標を使用する場合、次のステートメントが適用されます。
- 宛先バケットを持つプロジェクトでログベースの指標を定義します。
- バケット スコープのログベースの指標は、ログがバケットと同じプロジェクトからのものか、別のプロジェクトからのものかにかかわらず、バケットに転送されたすべてのログエントリを評価します。
- 指標データは、その指標スコープがバケットを持つプロジェクトを含む他のプロジェクトに表示されます。
- ログを転送するプロジェクトは、どのプロジェクトの指標スコープにも存在する必要はありません。
モニタリング対象のリソースタイプ：logging_bucket
バケット スコープのログベースの指標は、時系列データを Cloud Monitoring に書き込むときにモニタリング対象リソースタイプ logging_bucket を使用します。logging_bucket リソースタイプには、次のラベルが含まれています。
project_id: Google Cloud プロジェクトの ID（my-test-projectなどの文字列）。bucket_id: ログベースの指標に関連付けられたログバケットの名前（my-test-bucketなどの文字列）。location: ログバケットのロケーション。monitored_resource_type: このログエントリを生成するモニタリング対象リソースのタイプ。値は、ログエントリのresourceフィールドに含まれるMonitoredResource構造のtypeフィールドから取得されます。source_resource_container: ログエントリが送信されたプロジェクト、フォルダ、または組織の ID。次のいずれかの形式の文字列。projects/PROJECT_IDorganizations/ORGANIZATION_IDfolders/FOLDER_ID