You can access event logs for your integrations from Google Cloud Logging . Use Cloud Logging to explore logs, create metrics and alerts, or export logs to other applications using Google Cloud Pub/Sub .
Журналирование доступа
To access Cloud Logging from the Google Cloud Console , click View all products , then go to Operations > Logging .
Доступ к данным журналов управляется системой управления идентификацией и доступом (IAM) для пользователей вашего проекта Actions. Более подробную информацию о ролях и разрешениях для доступа к данным журналов см. в разделе « Управление доступом к Cloud Logging».
Согласно политике хранения данных Cloud Logging, записи журналов хранятся в течение 30 дней, после чего планируется их удаление. Вы также можете удалять записи по запросу, используя интерфейс Logs Explorer.
Более подробную информацию об эффективном использовании журналов можно найти в разделе «Поиск в журналах» руководства по устранению неполадок .
Cloud Logging предоставляет следующие типы ресурсов:
| Тип ресурса | Отображаемое имя | Описание | Метки |
|---|---|---|---|
assistant_action_project | Проект действий Google Ассистента | Контейнер для проекта Google Cloud, связанный с действием Google Assistant. |
|
Журналы событий
В проектах Cloud-to-cloud в 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 | Optional indicator of the user action taken, for example QUERY or EXECUTE . For EXECUTE actions, includes the command issued to fulfillment for supported traits, for example ONOFF_OFF |
trait | Необязательный параметр, связанный с этим действием пользователя. |
deviceTypes | List of device types affected by the event, for example LIGHT . |
isSuccess | Уточнялось, был ли получен успешный ответ на запрос. |
fallbackToCloud | Был ли запрос перенаправлен в облачное хранилище после ошибки, возникшей при локальном хранилище? |
statusType | Указывает статус ответа на запрос, например, SUCCESS , PENDING или OFFLINE . Для ответов ERROR это свойство содержит errorCode предоставленный при выполнении запроса. |
externalDebugString | Дополнительное подробное отладочное сообщение, связанное с этим действием пользователя. |
locale | Языковой код, связанный с запросом. |
Журналы уведомлений
В таблице ниже приведена схема записи в файле notificationLog :
| Свойство | Описание |
|---|---|
requestId | Идентификатор запроса на уведомление. |
structName | Название структуры уведомления, например, "ObjectDetection". |
status | Указывает статус уведомления. |
настройка уровня лога
В проектах, Cloud-to-cloud по умолчанию настроено получение журналов ошибок, однако разработчики могут дополнительно включить получение журналов успешных операций. Это особенно полезно на этапе разработки, когда планируется сбор всех журналов от нескольких агентов. За превышение квоты на ведение журналов может взиматься дополнительная плата.
Вы можете управлять уровнем логирования для своего проекта следующим образом:
В разделе Actions on Google Console перейдите на страницу «Проекты».
Выберите свой проект «умного дома».
Выберите вкладку «Разработка» и нажмите «Действия» на боковой панели.
Select All in the Log control ingestion dropdown list.
Исключения из журналов
Разработчики могут создавать исключения для логов, используя язык запросов логирования , что позволяет более гибко настраивать отображение логов. Язык запросов логирования также используется в Logs Explorer, поэтому вы можете использовать Logs Explorer для создания запросов.
You can follow the steps for creating exclusion filters at this guide (configure the exclusion filter for the _Default sink).
Метрики на основе логов
Разработчики могут использовать метрики на основе логов для отслеживания и анализа закономерностей в своих журналах. Также можно создавать пользовательские диаграммы и настраивать оповещения на основе метрик логов.
To start using log-based metrics for smart home, check out creating a counter log-based metric guide .
Связанные ресурсы
Чтобы узнать больше об использовании Cloud Logging в вашем проекте, ознакомьтесь со следующей документацией :
- Цены : Подробная информация о распределении квот и дополнительных расходах.
- Квоты и лимиты : Подробная информация об ограничениях и политике хранения данных для ведения журналов.
- Расширенные запросы к журналам : руководство по использованию сложных выражений для запроса и анализа данных журналов.