Cloud Logging для Matter

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

Ведение журнала доступа

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

Перейти: Cloud Logging

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

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

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

В 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 Код языка, связанный с запросом.

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

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

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

Показатели на основе данных журналов

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

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

Дополнительную информацию об использовании Cloud Logging в проекте можно найти в документации.

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