Облачное ведение журнала для Matter

Вы можете получить доступ к журналам событий для своих интеграций из 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 .

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

В таблице ниже приведена схема записи 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 Код языка, связанный с запросом.

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

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

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

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

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

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

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

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