Вы можете получить доступ к журналам событий для ваших интеграций из Google Cloud Logging . Используйте Cloud Logging для просмотра журналов, создания метрик и оповещений или экспорта журналов в другие приложения с помощью Google Cloud Pub/Sub .
Журналирование доступа
Чтобы получить доступ к Cloud Logging из Google Cloud Console , нажмите «Просмотреть все продукты» , затем перейдите в раздел «Операции» > «Журналирование» .
Доступ к данным журналов управляется системой управления идентификацией и доступом (IAM) для пользователей вашего проекта Actions. Более подробную информацию о ролях и разрешениях для доступа к данным журналов см. в разделе « Управление доступом к Cloud Logging».
Согласно политике хранения данных Cloud Logging, записи журналов хранятся в течение 30 дней, после чего планируется их удаление. Вы также можете удалять записи по запросу, используя интерфейс Logs Explorer.
Более подробную информацию об эффективном использовании журналов можно найти в разделе «Поиск в журналах» руководства по устранению неполадок .
Cloud Logging предоставляет следующие типы ресурсов:
| Тип ресурса | Отображаемое имя | Описание | Метки |
|---|---|---|---|
assistant_action_project | Проект действий Google Ассистента | Контейнер для проекта Google Cloud, связанный с действием Google Assistant. |
|
Журналы выполнения
В таблице ниже приведена схема записи в журнале 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 | Языковой код, связанный с запросом. |
Исключения из журналов
Разработчики могут создавать исключения для логов, используя язык запросов логирования , что позволяет более гибко настраивать отображение логов. Язык запросов логирования также используется в Logs Explorer, поэтому вы можете использовать Logs Explorer для создания запросов.
Вы можете выполнить действия по созданию фильтров исключения, описанные в этом руководстве (настройте фильтр исключения для приемника _Default ).
Метрики на основе логов
Разработчики могут использовать метрики на основе логов для отслеживания и анализа закономерностей в своих журналах. Также можно создавать пользовательские диаграммы и настраивать оповещения на основе метрик логов.
Чтобы начать использовать метрики на основе логов для умного дома, ознакомьтесь с руководством по созданию счетчика на основе метрик .
Связанные ресурсы
Чтобы узнать больше об использовании Cloud Logging в вашем проекте, ознакомьтесь со следующей документацией :
- Цены : Подробная информация о распределении квот и дополнительных расходах.
- Квоты и лимиты : Подробная информация об ограничениях и политике хранения данных для ведения журналов.
- Расширенные запросы к журналам : руководство по использованию сложных выражений для запроса и анализа данных журналов.