Cloud Logging для Matter

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

Журналы доступа

Чтобы перейти к Cloud Logging из Google Cloud Console, нажмите Посмотреть все продукты, а затем выберите Наблюдаемость > Ведение журналов.

Перейти: Cloud Logging

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

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

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

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

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

Журналы выполнения

В таблице ниже приведена схема записи 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 в проекте, можно узнать из следующих статей:

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