Google Cloud Logging에서 통합에 대한 이벤트 로그에 액세스할 수 있습니다. Cloud Logging를 사용하여 로그를 탐색하거나, 측정항목과 알림을 만들거나, Google Cloud Pub/Sub를 사용하여 다른 애플리케이션으로 로그를 내보낼 수 있습니다.
액세스 로깅
Google Cloud Console에서 Cloud Logging에 액세스하려면 모든 제품 보기를 클릭한 후 작업 > Logging으로 이동합니다.
로깅 데이터에 대한 액세스는 작업 프로젝트 사용자의 Identity and Access Management (IAM)를 통해 관리됩니다. 데이터 로깅 역할 및 권한에 대한 자세한 내용은 Cloud Logging 액세스 제어를 참조하세요.
로그 항목은 Cloud Logging 보관 정책에 따라 30일 동안 보관된 후 삭제가 예약됩니다. 로그 탐색기 인터페이스를 사용하여 필요에 따라 항목을 삭제할 수도 있습니다.
문제 해결 가이드의 로그 검색 섹션에서 로그를 효과적으로 사용하는 방법을 자세히 알아볼 수 있습니다.
Cloud Logging는 다음과 같은 리소스 유형을 제공합니다.
| 리소스 유형 | 표시 이름 | 설명 | 라벨 |
|---|---|---|---|
assistant_action_project |
Google 어시스턴트 작업 프로젝트 | 어시스턴트 작업과 연결된 Google Cloud 프로젝트의 컨테이너입니다. |
|
실행 로그
아래 표에는 executionLog 항목의 스키마가 나열되어 있습니다.
| 속성 | 설명 |
|---|---|
requestId |
고유한 요청 ID입니다(예: 5325511189174727525). |
latencyMsec |
응답을 받기까지 경과한 시간입니다. 예: 6000. |
executionType |
요청에 사용되는 전송입니다(예: 통합에 따라 CLOUD 또는 MATTER). |
actionType |
실행된 사용자 작업을 나타내는 선택적 표시기입니다(예: QUERY 또는 EXECUTE).
EXECUTE 작업의 경우 지원되는 특성(예: ONOFF_OFF)과 관련하여 fulfillment에 발행되는 명령어가 포함됩니다.
|
trait |
이 사용자 작업과 관련된 트레잇입니다(선택사항). |
deviceTypes |
이벤트의 영향을 받는 기기 유형 목록입니다(예: LIGHT). |
isSuccess |
요청이 성공적인 응답을 받았는지 여부입니다. |
fallbackToCloud |
로컬 fulfillment에서 오류 발생 후 요청이 클라우드 fulfillment로 라우팅되었는지 여부입니다. |
statusType |
인텐트 응답의 상태를 나타냅니다(예: SUCCESS, PENDING 또는 OFFLINE). ERROR 응답의 경우 이 속성에는 fulfillment에서 제공하는 errorCode가 포함됩니다.
|
externalDebugString |
이 사용자 작업과 연결된 자세한 디버깅 메시지입니다(선택사항). |
locale |
요청과 연결된 언어 코드입니다. |
로그 제외
개발자는 로깅 쿼리 언어로 로그 제외를 만들어 로그를 보다 유연하게 맞춤설정할 수 있습니다. 로깅 쿼리 언어는 로그 탐색기에서도 사용되므로 로그 탐색기를 사용하여 쿼리를 만들 수 있습니다.
이 가이드의 제외 필터 만들기 단계를 따르면 됩니다(_Default 싱크의 제외 필터 구성).
로그 기반 측정항목
개발자는 로그 기반 측정항목을 사용하여 로그 내의 패턴을 추적하고 분석할 수 있습니다. 또한 커스텀 차트를 만들고 로그 기반 측정항목에 대한 알림을 설정할 수 있습니다.
스마트 홈에 로그 기반 측정항목을 사용하려면 카운터 로그 기반 측정항목 만들기 가이드를 참고하세요.
관련 리소스
프로젝트에서 Cloud Logging을 사용하는 방법에 관한 자세한 내용은 다음 문서를 참조하세요.