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

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

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

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

Перейти к Cloud Logging

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

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

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

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 ).

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

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

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

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

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