Unified Maintenance ログスキーマ

アラート ポリシーを作成してログをフィルタするには、Logging クエリ言語を使用する必要があります。次の表に、統合メンテナンス リソース ResourceMaintenance のフィールドの詳細を示します。これらのフィールドを使用して、統合メンテナンス リソースのクエリ オペレーションを記述します。

ResourceMaintenance ログスキーマ

フィールド
resource MonitoredResource
resource.type string

ターゲット リソースのモニタリング対象リソースタイプに設定します。たとえば、Cloud SQL インスタンス: cloudsql_database
resource.labels map (key: string, value: string)

ターゲット リソースを一意に識別するラベル（モニタリング対象リソースタイプのラベルのリストを参照）。
labels map (key: string, value: string)

ログエントリのフィルタリングに使用される Key-Value ペア。使用可能なキー:

maintenance.googleapis.com/new_resource_maintenance - ResourceMaintenance の最初のログエントリの場合は True に設定します。

maintenance.googleapis.com/updated_fields - 更新された ResourceMaintenance フィールドのリスト（例:
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"）
insertId string

ログエントリの一意の識別子。
timestamp string (Timestamp format)

ログエントリが表すイベントの発生日時。この時間は、ログエントリの経過時間を計算し、ログの保持期間を適用するために使用されます。
receiveTimestamp string (Timestamp format)

ロギングがログエントリを受信した時刻。
jsonPayload ResourceMaintenance

リソース メンテナンスの詳細を含むペイロード。
jsonPayload.@type string

ペイロードの型定義。
は type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog と等しい
jsonPayload.name string

ID。resourceMaintenance リソースの名前。形式: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

出力専用。name は、メンテナンスの影響を受けるコンシューマー リソースへの参照です。使用可能な値については、アセット名をご覧ください。
jsonPayload.resource.location string

出力専用。リソースのロケーション。形式: us-central1。
jsonPayload.resource.type string

出力専用。リソースのタイプ。使用可能な値については、サポートされているサービスのリソースタイプをご覧ください。
jsonPayload.maintenance object

出力専用。メンテナンスの詳細。
jsonPayload.maintenance.maintenanceName string

標準の命名規則 "{maintenance-id}" に従った、対応するメンテナンス リソースの名前。
jsonPayload.maintenance.title string

出力専用。メンテナンスのタイトル。
jsonPayload.maintenance. description string

出力専用。メンテナンスの説明。
jsonPayload.state enum

メンテナンスの状態:
SCHEDULED - 特定のウィンドウにスケジュールされています。中断を伴うメンテナンスでは、メンテナンス ポリシーが適用されます。たとえば、利用可能なウィンドウ、除外、通知期間などです。
STARTED - メンテナンスが進行中です。
CANCELLED - 計画が中止された。通常、他のメンテナンス（新しいバージョンへのアップグレードなど）がすでに実施されている場合や、ユーザーがメンテナンスをスキップした場合。
SUCCEEDED - 正常に完了しました。
jsonPayload.maintenanceScheduledStartTime string

出力専用。リソースのメンテナンスが SCHEDULED になる時刻。
は RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。
例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceScheduledEndTime string

出力専用。リソースのメンテナンスが終了する予定の時刻。
は RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。
例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceStartTime string

出力専用。リソース メンテナンスが STARTED になった時刻。
は RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。
例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceEndTime string

出力専用。リソース メンテナンスが SUCCEEDED になった時刻。
は RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。
例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceCancelTime string

出力専用。リソース メンテナンスが CANCELLED された時刻。
は RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。
例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
jsonPayload.userControllable boolean

出力専用。ユーザーがメンテナンスを制御できるかどうかを示します。メンテナンス ポリシーでメンテナンスがスケジュールされる前にプロアクティブに制御できるか、スケジュールされた後にリアクティブに制御できるか（controls フィールドを参照）。
jsonPayload.controls object（MaintenanceControl）

出力のみ。メンテナンスの制御。

ログフィールドの例

次の例は、ResourceMaintenance リソースを示しています。

"insertId": "proj-1-us-west1-db-1-830d851d-2adf-4fb0-8f5b-1e18e16530d9",
"timestamp": "2023-09-14T16:00:00Z",
"receiveTimestamp": "2023-09-14T16:00:01Z",
"logName":"projects/proj-1/logs/maintenance.googleapis.com%2Fmaintenance_events",
"resource": {
  "type":"cloudsql_database",
  "labels": {
    "project_id": "proj-1",
    "database_id":"db-1",
    "region": "us-west1",
  },
},
"labels": {
  "maintenance.googleapis.com/new_resource_maintenance": "False",
  "maintenance.googleapis.com/updated_fields": "['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
},
"jsonPayload": {
  "@type": "type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog",
  "name": "projects/proj-1/locations/us-west1/resourceMaintenances/db-1-a8307daa-5e1f-4974-b6a5-61fceb8331c0",
  "resource": {
    "resourceName": "//sqladmin.googleapis.com/projects/proj-1/instances/db-1",
    "location": "us-west1",
    "type": "sqladmin.googleapis.com/Instance"
  },
  "maintenance": {
    "maintenanceName": "830d851d-2adf-4fb0-8f5b-1e18e16530d9",
    "title": "Cloud SQL upgrade to v2",
    "description": "An upgrade to v2 release. New features... Release notes: https://..."
  },
  "state": "SCHEDULED",
  "maintenanceScheduledStartTime": "2023-09-21T16:00:00Z",
  "maintenanceScheduledEndTime": "2023-09-21T20:00:00Z"
}

次のステップ