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

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

Регистрация доступа

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

Перейти к Cloud Logging

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

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

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

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

Тип ресурса Отображаемое имя Описание Этикетки
assistant_action_project Проект действий Google Assistant Контейнер для проекта 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 ).

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

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

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

Чтобы узнать больше об использовании облачного ведения журнала в вашем проекте, ознакомьтесь со следующей документацией :

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