Журналы событий для интеграций доступны на странице Google Cloud Logging. Используйте Cloud Logging, чтобы просматривать журналы, создавать показатели и оповещения или экспортировать журналы в другие приложения с помощью Google Cloud Pub/Sub.
Журналы доступа
Чтобы перейти к Cloud Logging из Google Cloud Console, нажмите Посмотреть все продукты, а затем выберите Наблюдаемость > Ведение журналов.
Доступ к данным журналов регулируется с помощью системы управления учетными данными и доступом (IAM) для пользователей проекта Actions. Подробнее о ролях и разрешениях для данных журнала…
Записи журналов хранятся в течение 30 дней в соответствии с правилами хранения Cloud Logging, а затем удаляются. Вы также можете удалять записи по запросу, используя интерфейс обозревателя журналов.
Подробнее о том, как эффективно использовать журналы, рассказывается в разделе "Поиск в журналах" руководства по устранению неполадок.
Cloud Logging предоставляет следующие типы ресурсов:
| Тип ресурса | Отображаемое название | Описание | Ярлыки |
|---|---|---|---|
assistant_action_project |
Проект с действием Google Ассистента | Контейнер для проекта Google Cloud, связанного с действием Ассистента. |
|
Журналы событий
Проекты Cloud-to-cloud поддерживают следующие события в Cloud Logging:
| Ресурс Cloud Logging | Событие |
|---|---|
| Проект с действием Google Ассистента | Ошибки намерения SYNC |
| Ошибки намерения QUERY | |
| Ошибки намерения EXECUTE | |
| Уведомления ошибки | |
| Ошибки при связывании аккаунтов | |
| Local Home 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 |
Указывает статус уведомления. |
Настройка уровня журнала
В проектах Cloud-to-cloud по умолчанию включена отправка журналов ошибок, но разработчики могут также включить отправку журналов успешных операций. Это особенно полезно на этапе разработки, когда вы планируете собирать все журналы от нескольких агентов. Если вы превысите квоту на ведение журналов, с вашего проекта может взиматься дополнительная плата.
Вы можете управлять уровнем журнала для своего проекта, выполнив следующие действия:
В Actions on Google Console перейдите на страницу проектов.
Выберите проект умного дома.
Выберите вкладку Разработка и нажмите Действия на боковой панели.
В раскрывающемся списке Загрузка журналов выберите Все.
Исключения из журналов
Разработчики могут создавать исключения из журналов с помощью языка запросов для ведения журналов, чтобы более гибко настраивать журналы. Язык запросов к журналам также используется в Logs Explorer, поэтому вы можете использовать Logs Explorer для создания запросов.
Чтобы создать фильтр исключений, следуйте инструкциям из этого руководства (настройте фильтр исключений для приемника _Default).
Показатели на основе журналов
Разработчики могут использовать показатели на основе журналов, чтобы отслеживать и анализировать закономерности в журналах. Также можно создавать специальные диаграммы и настраивать оповещения на основе показателей журнала.
Чтобы начать использовать показатели на основе журналов для умного дома, ознакомьтесь с руководством по созданию показателей на основе журналов счетчиков.
Информация по теме
Подробнее о том, как использовать Cloud Logging в проекте, можно узнать из следующих статей:
- Цены: Подробная информация о квотах и стоимости превышения лимитов.
- Квоты и лимиты: подробная информация о лимитах и правилах хранения данных об использовании.
- Расширенные запросы к журналам. Руководство по использованию расширенных выражений для запроса и анализа данных журналов.