스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.

Cloud Logging으로 이벤트 로그에 액세스

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Google Cloud Logging 에서 통합의 이벤트 로그에 액세스할 수 있습니다. Cloud Logging를 사용하여 로그를 탐색하거나, 측정항목과 알림을 만들거나, Google Cloud Pub/Sub를 사용하여 다른 애플리케이션으로 로그를 내보낼 수 있습니다.

액세스 로깅

Google Cloud Platform Console 에서 Cloud Logging에 액세스하려면 모든 제품 보기를 클릭한 다음 작업 > Logging으로 이동합니다.

Cloud Logging로 이동

로깅 데이터에 대한 액세스는 작업 프로젝트의 사용자에 대해 Identity and Access Management (IAM)를 통해 관리됩니다. 데이터 로깅의 역할과 권한에 대한 자세한 내용은 Cloud Logging 액세스 제어를 참조하세요.

로그 항목은 Cloud Logging 보관 정책에 따라 30일 동안 보관된 후 삭제되도록 예약됩니다. 로그 탐색기 인터페이스를 사용하여 필요에 따라 항목을 삭제할 수도 있습니다.

문제 해결 가이드의 로그 검색 섹션에서 로그를 효과적으로 사용하는 방법을 자세히 알아보세요.

Cloud Logging는 다음 리소스 유형을 제공합니다.

리소스 유형 표시 이름 설명 라벨
assistant_action_project Google 어시스턴트 작업 프로젝트 어시스턴트 작업과 연결된 Google Cloud 프로젝트의 컨테이너입니다.
  • project_id: 이 리소스와 연결된 현재 프로젝트의 식별자입니다(예: my-project).

이벤트 로그

프로젝트는 Cloud Logging에서 다음 이벤트를 지원합니다.

Cloud Logging 리소스 이벤트
Google 어시스턴트 작업 프로젝트 SYNC 인텐트 오류
QUERY 인텐트 오류
EXECUTE 인텐트 오류
알림 오류
계정 연결 오류
로컬 홈 SDK HandlerError

로그 동기화

아래 표에는 syncLog 항목의 스키마가 나와 있습니다.

속성 설명
requestId 스마트 홈 인텐트 요청 ID입니다.
httpLatencyMsec 응답을 받기까지 경과한 시간입니다.
status 인텐트 응답의 상태를 나타냅니다.

실행 로그

아래 표에는 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 요청과 연결된 언어 코드입니다.

알림 로그

아래 표에는 notificationLog 항목의 스키마가 나와 있습니다.

속성 설명
requestId 알림 요청 ID입니다.
structName 알림 구조체의 이름입니다(예: 'ObjectDetection').
status 알림의 상태를 나타냅니다.

로그 수준 설정

프로젝트는 기본적으로 오류 로그를 받도록 설정되며, 개발자가 성공 로그를 수신하도록 선택할 수도 있습니다. 몇 가지 에이전트에서 모든 로그를 캡처하려는 경우, 개발 단계에서 특히 유용합니다. 로깅 할당량을 초과하면 프로젝트에 추가 요금이 부과될 수 있습니다.

다음 방법으로 프로젝트의 로그 수준을 제어할 수 있습니다.

  1. 작업 콘솔에서 프로젝트 페이지로 이동합니다.

    Actions 콘솔 열기

  2. 스마트 홈 프로젝트를 선택합니다.

  3. 개발 탭을 선택하고 사이드바에서 작업을 클릭합니다.

  4. 로그 제어 수집 드롭다운 목록에서 모두를 선택합니다.

로그 제외

개발자는 로깅 쿼리 언어를 사용하여 로그 제외를 만들어 로그를 더 유연하게 맞춤설정할 수 있습니다. 로깅 쿼리 언어는 로그 탐색기에서도 사용되므로 로그 탐색기를 사용하여 쿼리를 만들 수 있습니다.

이 가이드에서 제외 필터를 만드는 단계를 따르면 됩니다(_Default 싱크의 제외 필터 구성).

로그 기반 측정항목

개발자는 로그 기반 측정항목을 사용하여 로그 내의 패턴을 추적하고 분석할 수 있습니다. 커스텀 차트를 만들고 로그 기반 측정항목에 대한 알림을 설정할 수도 있습니다.

스마트 홈에 로그 기반 측정항목을 사용하려면 카운터 로그 기반 측정항목 만들기 가이드를 참조하세요.

프로젝트에서 Cloud Logging을 사용하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

  • 가격 책정: 할당량 및 초과분 비용에 관한 세부정보입니다.
  • 할당량 및 한도: 로깅 사용량의 한도 및 보관 정책에 대한 세부정보입니다.
  • 고급 로그 쿼리: 고급 표현식을 사용하여 로그 데이터를 쿼리하고 분석하는 방법을 안내합니다.