플랫폼 로그 사용

이 페이지에서는 App Lifecycle Manager에서 생성된 플랫폼 로그를 보는 방법을 설명합니다. 의 플랫폼 로그는 사용 중인 서비스를 더 잘 이해하고 문제를 디버깅하고 해결하는 데 사용할 수 있는 서비스별 로그입니다. Google Cloud Google Cloud

지원되는 App Lifecycle Manager 플랫폼 로그에 대한 자세한 내용은 Google Cloud 플랫폼 로그를 참조하세요. 플랫폼 로그 테이블의 데이터를 이해하는 방법에 대한 자세한 내용은 로그 항목 구조를 참조하세요.

시작하기 전에

  1. 콘솔의 프로젝트 선택기 페이지에서 프로젝트를 선택하거나 만듭니다. Google Cloud Google Cloud
  2. 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. Google Cloud
  3. App Lifecycle Manager API를 사용 설정합니다.
  4. 로그를 보고 알림을 만드는 데 필요한 권한을 얻으려면 관리자에게 문의해서 프로젝트에 대해 다음 Identity and Access Management (IAM) 역할을 부여해 달라고 요청하세요.
    • 로그 뷰어 (roles/logging.viewer)
    • 모니터링 편집자 (roles/monitoring.editor)

로그 기반 알림 만들기

로그 기반 알림을 만들려면 로그 탐색기에서 알림을 받을 로그 항목을 반환하는 쿼리를 작성한 후 알림 정책을 구성합니다.

  1. 콘솔에서 로그 탐색기 페이지로 이동합니다. Google Cloud

    로그 탐색기로 이동

  2. 쿼리 편집기에서 선택한 로그 항목을 필터링하는 쿼리를 입력합니다. 쿼리 예시는 다음 섹션을 참고하세요.

  3. 알림 만들기 를 클릭합니다.

  4. 알림 정책의 이름과 설명을 입력합니다.

  5. 알림 채널을 비롯한 알림 세부정보를 구성합니다.

  6. 알림 저장 을 클릭합니다.

자세한 안내는 로그 기반 알림 만들기를 참고하세요.

플랫폼 로그의 쿼리 예시

이 섹션에서는 App Lifecycle Manager 플랫폼 로그를 기반으로 하는 일반적인 알림 시나리오의 쿼리 예시를 제공합니다.

SaaS 작업 알림

단위 프로비저닝 작업이 실패할 때 알림을 만들려면 다음 쿼리를 사용하세요.

protoPayload.methodName="google.cloud.saasplatform.saasservicemgmt.v1beta1.SaasDeployments.CreateUnitOperation"
protoPayload.response.state="UNIT_OPERATION_STATE_FAILED"

단위 프로비저닝 작업이 종료 상태 (성공, 실패 또는 취소)에 도달할 때 알림을 만들려면 다음 쿼리를 사용하세요.

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.UnitOperationLog"
AND (jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_SUCCEEDED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_FAILED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_CANCELLED")
AND jsonPayload.unit_operation_type="PROVISION"

롤아웃 알림

롤아웃이 PAUSED 상태 (App Lifecycle Manager에서 롤아웃이 비정상으로 식별했기 때문) 또는 FAILED 상태로 전환될 때 로그 알림을 만들려면 다음 쿼리를 사용하세요.

resource.type = "saasservicemgmt.googleapis.com/Rollout"
(jsonPayload.currentState = "PAUSED" AND jsonPayload.reason = "SYSTEM_PAUSE")
  OR
jsonPayload.currentState = "FAILED"

롤아웃이 PAUSED 상태 (App Lifecycle Manager에서 롤아웃이 비정상으로 식별했기 때문) 또는 FAILED 상태로 전환될 때 롤아웃 상태 측정항목의 측정항목 알림을 만들려면 다음 쿼리를 사용하세요.

saasservicemgmt_googleapis_com:rollout_state
{state_name="PAUSED", reason="SYSTEM_PAUSE"}
OR
saasservicemgmt_googleapis_com:rollout_state{state_name="FAILED"}

다음 단계