ログベースの指標にラベルを構成する

このドキュメントでは、ログベースの指標ラベルについて検討し、ログベースの指標にラベルを作成して使用する方法について説明します。

ラベルについてよく理解している場合は、このページのラベルを作成するに直接進むことができます。

ログベースの指標のラベルの概要

ラベルを使用すると、ログベースの指標に、ラベル値の組み合わせごとに 1 つずつ、複数の時系列を含めることができます。すべてのログベースの指標には、デフォルトのラベルがあります。

抽出式を指定すると、カウンタタイプと分布タイプの両方の指標で追加のラベルを作成できます。抽出式によって、Cloud Logging に、ログエントリからラベルの値を抽出する方法が指示されます。ラベルの値には、次のいずれかを指定できます。

• LogEntry オブジェクトの名前付きフィールドの内容全体。
• 正規表現（regexp）に一致する名前付きフィールドの一部。

ラベルは、httpRequest.status などの LogEntry の組み込みフィールドから抽出することも、textPayload、jsonPayload、protoPayload のいずれかのペイロード フィールドから抽出することもできます。

正規表現の詳細については、RE2 構文をご覧ください。

機密情報を抽出式に入力したり、センシティブ データをラベル内に抽出したりしないでください。これらはサービスデータとして扱われます。

ユーザー定義ラベルの制限

ユーザー定義ラベルには次の制限があります。

• 指標 1 つあたり最大 10 個のユーザー定義ラベルを作成できます。

• ラベルを作成した後に削除することはできません。

  • 作成したラベルの抽出式と説明は変更できます。

  • 作成したラベルの名前と値の型は変更できません。

• ラベル値の最初の 1,024 文字だけが保持されます。

• ログベースの各指標は、約 30,000 個のアクティブ時系列に制限されています。これは、デフォルト ラベルを含む各ラベルに有効な値の数に依存します。

  たとえば、ログエントリの取得元が VM インスタンスなどの 100 個のリソースで、20 個の有効な値でラベルを定義する場合、指標に対して最大 2,000 個の時系列を格納できます。

時系列が多すぎたり、データポイントが多すぎたりすると、コストが上昇し、アクティビティが抑制される可能性があります。ログベースの指標の費用の詳細については、Cloud Monitoring の料金: 課金対象指標をご覧ください。ログベースの指標に適用される上限については、割り当てと上限: ログベースの指標とログベースの指標のトラブルシューティングをご覧ください。

デフォルト ラベル

すべてのログベースの指標には、定義済みのラベルが付与されています。

• リソースラベル: すべての指標は、モニタリング対象のリソース オブジェクトを使用して時系列データのソースを識別します。リソースタイプは、タイプ名と 1 つ以上のラベルから構成されます。リソースのタイプとしては、たとえば VM インスタンス、Cloud SQL データベース、ロードバランサなどがあります。

  リソースとそのラベルは、Cloud Monitoring の他の指標ラベルとは別に表示されますが、効果は同じです。指標に追加の時系列が作成されます。詳細については、指標、時系列、リソースをご覧ください。

• ログ: このラベルは、ログエントリの logName フィールドの LOG_ID 部分に含まれる値を保持します。

• 重大度: このラベルは、ログエントリの severity フィールドの値を保持します。 重大度ラベルは、システム ログベースの指標でのみデフォルトで提供されます。

例: Metrics Explorer を使用する

Metrics Explorer の次のスクリーンショットは、システム ログベースの指標の 1 つのラベルを示しています。[フィルタ] ボックス内をクリックすると、ラベルリストが表示されます。

スクリーンショットには、次の情報が表示されます。

• Metrics Explorer は、logging/log_entry_count 指標と gce_instance リソースタイプ（Compute Engine VM インスタンス）の時系列を使用しています。

  この指標には他のリソースタイプの時系列も含まれますが、Metrics Explorer では一度に 1 つのリソースタイプのみを表示できます。

• gce_instance リソースタイプには、3 つのリソースラベル（project_id、instance_id、zone）があります。

• この指標には 2 つの指標ラベル（log と severity）があります。このセクションには、ユーザー定義のラベルも表示されます。

ラベルを作成する

指標を作成するときに、ユーザー定義のラベルを作成します。カウンタ指標と分散指標の両方にラベルを付けることができます。システム ログベースの指標にラベルを追加することはできません。

gcloud logging metrics create METRIC_NAME --config-from-file FILENAME

{
  ...
  metricDescriptor: {
      labels: [
        { key: LABEL_NAME, valueType: LABEL_TYPE,
          description: LABEL_DESCRIPTION },
        ...
      ]
  },
  labelExtractors: {
    LABEL_NAME: EXTRACTOR_EXPRESSION,
    ...
  },
}

{
  ...
  metricDescriptor: {
      labels: [
        { key: "label_name_a", valueType: STRING },
        { key: "label_name_b", valueType: INT64 },
      ]
  },
  labelExtractors: {
    "label_name_a":
      "REGEXP_EXTRACT(jsonPayload.field_a, \"before ([a-zA-Z ]+) after\")",
    "label_name_b": "EXTRACT(jsonPayload.field_b)",
  },
}