Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.

Доступ к журналам событий с помощью Cloud Logging

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Вы можете получить доступ к журналам событий для ваших интеграций из Google Cloud Logging . Используйте Cloud Logging для просмотра журналов, создания метрик и предупреждений или экспорта журналов в другие приложения с помощью Google Cloud Pub/Sub .

Регистрация доступа

Чтобы получить доступ к Cloud Logging из Google Cloud Platform Console , нажмите « Просмотреть все продукты », затем выберите «Операции» > « Ведение журнала ».

Перейти к Cloud Logging

Доступ к данным журнала управляется с помощью управления идентификацией и доступом (IAM) для пользователей вашего проекта Actions. Дополнительные сведения о ролях и разрешениях для регистрации данных см. в разделе Управление доступом к облачным журналам.

Записи журнала хранятся в течение 30 дней в соответствии с политикой хранения облачных журналов, а затем удаляются по расписанию. Вы также можете удалять записи по запросу с помощью интерфейса Logs Explorer.

Подробнее об эффективном использовании журналов можно узнать в разделе «Поиск журналов» руководства по устранению неполадок .

Cloud Logging предоставляет следующие типы ресурсов:

Тип ресурса Отображаемое имя Описание Этикетки
assistant_action_project Проект действий Google Ассистента Контейнер для проекта Google Cloud, связанный с действием помощника.
  • project_id : идентификатор вашего текущего проекта, связанного с этим ресурсом, например, my-project .

Журналы событий

Ваш проект поддерживает следующие события в Cloud Logging:

Ресурс облачного ведения журнала Событие
Проект действий Google Ассистента Ошибки намерения SYNC
Ошибки намерения QUERY
Ошибки намерения EXECUTE
Ошибки уведомлений
Ошибки привязки аккаунта
Локальный домашний SDK HandlerError

Журналы синхронизации

В таблице ниже приведена схема записи syncLog :

Имущество Описание
requestId Идентификатор запроса намерения умного дома.
httpLatencyMsec Время, прошедшее до получения ответа.
status Указывает состояние ответа о намерении.

Журналы выполнения

В таблице ниже приведена схема записи в журнале executionLog :

Имущество Описание
requestId Уникальный идентификатор запроса, например 5325511189174727525 .
latencyMsec Время, прошедшее до получения ответа, например 6000 .
executionType Транспорт, используемый для запроса, например CLOUD или MATTER , в зависимости от вашей интеграции.
actionType Необязательный индикатор предпринятого действия пользователя, например, QUERY или EXECUTE . Для действий EXECUTE включает команду, выданную для выполнения поддерживаемых признаков, например ONOFF_OFF
trait Необязательный признак, связанный с этим действием пользователя.
deviceTypes Список типов устройств, затронутых событием, например LIGHT .
isSuccess Получил ли запрос успешный ответ.
fallbackToCloud Был ли запрос перенаправлен на облачное выполнение после ошибки локального выполнения.
statusType Указывает статус ответа о намерениях, например SUCCESS , PENDING или OFFLINE . Для ответов ERROR это свойство содержит errorCode , предоставленный выполнением.
externalDebugString Необязательное подробное отладочное сообщение, связанное с этим действием пользователя.
locale Код языка, связанный с запросом.

Журналы уведомлений

В таблице ниже приведена схема записи в журнале notificationLog :

Имущество Описание
requestId Идентификатор запроса уведомления.
structName Имя структуры уведомления, например "ObjectDetection".
status Указывает статус уведомления.

Настройка уровня журнала

Проекты настроены на получение журналов ошибок по умолчанию, и разработчики также могут подписаться на получение журналов успеха. Это особенно полезно на этапе разработки, когда вы планируете собирать все журналы от нескольких агентов. К вашему проекту может применяться дополнительная плата, если вы превысите квоту ведения журналов .

Вы можете контролировать уровень журнала для вашего проекта:

  1. В консоли Actions перейдите на страницу Projects.

    Откройте консоль действий

  2. Выберите свой проект умного дома.

  3. Выберите вкладку « Разработка » и нажмите « Действия » на боковой панели.

  4. Выберите « Все » в раскрывающемся списке «Прием данных управления журналом».

Исключения журнала

Разработчики могут создавать исключения из журналов, используя язык запросов ведения журналов, чтобы более гибко настраивать свои журналы. Язык запросов ведения журналов также используется обозревателем журналов, поэтому вы можете использовать обозреватель журналов для создания запросов.

Вы можете выполнить шаги по созданию фильтров исключения из этого руководства (настроить фильтр исключения для приемника _Default ).

Метрики на основе журнала

Разработчики могут использовать метрики на основе журналов для отслеживания и анализа шаблонов в своих журналах. Также можно создавать собственные диаграммы и настраивать оповещения для показателей на основе журналов.

Чтобы начать использовать метрики на основе журналов для умного дома, ознакомьтесь с руководством по созданию метрик на основе журналов счетчиков .

Чтобы узнать больше об использовании Cloud Logging в вашем проекте, см. следующую документацию :