Доступ к журналам событий с помощью Cloud Logging

Вы можете получить доступ к журналам событий для своих интеграций из Google Cloud Logging . Используйте Cloud Logging для изучения журналов, создания показателей и оповещений или экспорта журналов в другие приложения с помощью Google Cloud Pub/Sub .

Доступ к журналу

Чтобы получить доступ к Cloud Logging из Google Cloud Console , нажмите «Просмотреть все продукты» , затем выберите «Операции » > «Журналирование» .

Перейти к Cloud Logging

Доступ к данным журналов управляется с помощью управления идентификацией и доступом (IAM) для пользователей вашего проекта Actions. Дополнительные сведения о ролях и разрешениях для регистрации данных см. в разделе Управление доступом к облачным журналам.

Записи журнала хранятся в течение 30 дней в соответствии с политикой хранения облачных журналов, а затем планируются к удалению. Вы также можете удалять записи по требованию, используя интерфейс обозревателя журналов.

Подробнее о том, как эффективно использовать журналы, можно узнать в разделе «Поиск журналов » руководства по устранению неполадок .

Cloud Logging предоставляет следующие типы ресурсов:

Тип ресурса Отображаемое имя Описание Этикетки
assistant_action_project Проект действий Google Ассистента Контейнер для проекта Google Cloud, связанного с действием Ассистента.
  • project_id : идентификатор вашего текущего проекта, связанного с этим ресурсом, например my-project .

Журналы событий

Проекты 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 по умолчанию настроены на получение журналов ошибок, и разработчики также могут согласиться на получение журналов успеха. Это особенно полезно на этапе разработки, когда вы планируете собирать все журналы нескольких агентов. Если вы превысите квоту на регистрацию , с вашего проекта может взиматься дополнительная плата.

Вы можете контролировать уровень журнала для вашего проекта:

  1. В Actions on Google Console перейдите на страницу «Проекты».

    Перейдите в «Действия в консоли Google».

  2. Выберите проект умного дома.

  3. Выберите вкладку «Разработка» и нажмите «Действия» на боковой панели.

  4. Выберите «Все» в раскрывающемся списке «Прием элементов управления журналом» .

Исключения журналов

Разработчики могут создавать исключения журналов , используя язык запросов журналов , чтобы более гибко настраивать свои журналы. Язык запросов ведения журналов также используется обозревателем журналов, поэтому вы можете использовать обозреватель журналов для создания запросов.

Вы можете выполнить действия по созданию фильтров исключений, описанные в этом руководстве (настроить фильтр исключений для приемника _Default ).

Метрики на основе журналов

Разработчики могут использовать метрики на основе журналов для отслеживания и анализа закономерностей в своих журналах. Также можно создавать собственные диаграммы и настраивать оповещения на основе показателей на основе журналов.

Чтобы начать использовать метрики на основе журналов для умного дома, ознакомьтесь с созданием руководства по метрикам на основе журналов счетчиков .

Чтобы узнать больше об использовании Cloud Logging в вашем проекте, см. следующую документацию :

  • Цены : Подробная информация о выделенных участках и излишних затратах.
  • Квоты и ограничения . Подробная информация об ограничениях и политиках хранения для журналирования использования.
  • Расширенные запросы журналов : руководство по использованию расширенных выражений для запроса и анализа данных журналов.