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