플랫폼 로그 사용

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

지원되는 SaaS 런타임 플랫폼 로그에 관한 자세한 내용은 Google Cloud 플랫폼 로그를 참고하세요. 플랫폼 로그 테이블의 데이터를 이해하는 방법에 관한 자세한 내용은 로그 항목 구조를 참고하세요.

시작하기 전에

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

로그 기반 알림 만들기

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

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

    로그 탐색기로 이동

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

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

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

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

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

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

플랫폼 로그의 쿼리 예

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

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 또는 FAILED 상태가 되면 알림을 만들려면 다음 쿼리를 사용하세요.

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.reason!="USER_PAUSE"
AND jsonPayload.root_rollout_id != resource.labels.rollout_id

전역 출시가 PAUSED 또는 FAILED 상태가 되면 알림을 만들려면 다음 쿼리를 사용하세요.

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.root_rollout_id == resource.labels.rollout_id

SaaS 런타임에서 출시를 비정상으로 식별하여 출시가 PAUSED 상태가 되거나 FAILED 상태가 될 때 로그 알림을 만들려면 다음 쿼리를 사용하세요.

logName:"rollout_events" 
(jsonPayload.currentState="PAUSED" jsonPayload.reason="SYSTEM_PAUSE")
OR 
jsonPayload.currentState="FAILED

출시가 PAUSED 상태 (SaaS 런타임에서 출시가 비정상으로 식별됨) 또는 FAILED 상태로 전환될 때 출시 상태 측정항목에 대한 로그 알림을 만들려면 다음 쿼리를 사용하세요.

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

다음 단계