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