Google Cloud Logging에서 통합의 이벤트 로그에 액세스할 수 있습니다. Cloud Logging를 사용하여 로그를 탐색하고, 측정항목과 알림을 만들거나, Google Cloud Pub/Sub을 사용하여 로그를 다른 애플리케이션으로 내보냅니다.
액세스 로깅
Google Cloud Console에서 Cloud Logging에 액세스하려면 모든 제품 보기를 클릭한 다음 작업 > 로깅으로 이동합니다.
로깅 데이터에 대한 액세스는 Actions 프로젝트 사용자의 ID 및 액세스 관리 (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).
|
trait |
이 사용자 작업과 연결된 선택적 특성입니다. |
deviceTypes |
이 이벤트의 영향을 받는 기기 유형 목록입니다(예: LIGHT). |
isSuccess |
요청이 성공적인 응답을 수신했는지 여부입니다. |
fallbackToCloud |
오류가 발생한 후 요청이 로컬 이행에서 클라우드 이행으로 라우팅되었는지 여부입니다. |
statusType |
의도 응답의 상태를 나타냅니다(예: SUCCESS, PENDING, OFFLINE). ERROR 응답의 경우 이 속성에는 fulfillment에서 제공한 errorCode이 포함됩니다.
|
externalDebugString |
이 사용자 작업과 관련된 선택적 세부 디버깅 메시지입니다. |
locale |
요청과 연결된 언어 코드입니다. |
로그 제외
개발자는 로깅 쿼리 언어를 사용하여 로그 제외를 만들어 더욱 유연한 방식으로 로그를 맞춤설정할 수 있습니다. 로깅 쿼리 언어는 로그 탐색기에서도 사용되므로 로그 탐색기를 사용하여 쿼리를 만드는 데 도움을 받을 수 있습니다.
이 가이드에서 제외 필터 만들기 단계를 따르세요(_Default 싱크의 제외 필터 구성).
로그 기반 측정항목
개발자는 로그 기반 측정항목을 사용하여 로그 내의 패턴을 추적하고 분석할 수 있습니다. 로그 기반 측정항목에 대해 맞춤 차트를 만들고 알림을 설정할 수도 있습니다.
스마트 홈에 로그 기반 측정항목을 사용하려면 카운터 로그 기반 측정항목 만들기 가이드를 참고하세요.
관련 리소스
프로젝트에서 Cloud Logging을 사용하는 방법에 대해 자세히 알아보려면 다음 문서를 참고하세요.