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