통합 유지보수 로그 스키마

알림 정책을 만들고 로그를 필터링하려면 로깅 쿼리 언어를 사용해야 합니다. 다음 표에는 통합 유지보수 리소스 ResourceMaintenance의 필드가 자세히 설명되어 있습니다. 이러한 필드를 사용하여 통합 유지관리 리소스의 쿼리 작업을 작성합니다.

ResourceMaintenance 로그 스키마

필드
resource MonitoredResource
resource.type string

타겟 리소스의 모니터링 리소스 유형으로 설정됩니다. 예를 들어 Cloud SQL 인스턴스: cloudsql_database
resource.labels map (key: string, value: string)

타겟 리소스를 고유하게 식별하는 라벨입니다 (모니터링 리소스 유형의 라벨 목록 참고).
labels map (key: string, value: string)

로그 항목을 필터링하는 데 사용되는 키-값 쌍입니다. 가능한 키:

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

식별자입니다. 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인 시간입니다.
생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다.
예: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"
jsonPayload.maintenanceScheduledEndTime string

출력 전용입니다. 리소스의 유지보수가 종료되도록 예약된 시간입니다.
생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다.
예: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"
jsonPayload.maintenanceStartTime string

출력 전용입니다. 리소스 유지보수가 STARTED인 시간입니다.
생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다.
예: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "2014-10-02T15:01:23+05:30"
jsonPayload.maintenanceEndTime string

출력 전용입니다. 리소스 유지보수가 SUCCEEDED인 시간입니다.
생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다.
예: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"
jsonPayload.maintenanceCancelTime string

출력 전용입니다. 리소스 유지보수가 CANCELLED된 시간입니다.
생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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"
}

다음 단계