Связь между облаками имеет значение
Вы можете получить доступ к журналам событий для ваших интеграций из Google Cloud Logging . Используйте Cloud Logging для просмотра журналов, создания метрик и оповещений или экспорта журналов в другие приложения с помощью Google Cloud Pub/Sub .
Журналирование доступа
Чтобы получить доступ к Cloud Logging из Google Cloud Console , нажмите «Просмотреть все продукты» , затем перейдите в раздел «Операции» > «Журналирование» .
Доступ к данным журналов управляется системой управления идентификацией и доступом (IAM) для пользователей вашего проекта Actions. Более подробную информацию о ролях и разрешениях для доступа к данным журналов см. в разделе « Управление доступом к Cloud Logging».
Согласно политике хранения данных Cloud Logging, записи журналов хранятся в течение 30 дней, после чего планируется их удаление. Вы также можете удалять записи по запросу, используя интерфейс Logs Explorer.
Более подробную информацию об эффективном использовании журналов можно найти в разделе «Поиск в журналах» руководства по устранению неполадок .
Cloud Logging предоставляет следующие типы ресурсов:
| Тип ресурса | Отображаемое имя | Описание | Метки |
|---|---|---|---|
assistant_action_project | Проект действий Google Ассистента | Контейнер для проекта Google Cloud, связанный с действием Google Assistant. |
|
Журналы событий
В проектах Cloud-to-cloud в Cloud Logging поддерживаются следующие события:
| Ресурс по облачному логированию | Событие |
|---|---|
| Проект действий Google Ассистента | Ошибки намерения SYNC |
| ошибки намерения запроса | |
| Ошибки намерения ВЫПОЛНИТЬ | |
| Ошибки уведомлений | |
| Ошибки привязки учетных записей | |
| Local Home SDK HandlerError |
Журналы синхронизации
В таблице ниже приведена схема записи syncLog :
| Свойство | Описание |
|---|---|
requestId | Идентификатор запроса намерения для умного дома. |
httpLatencyMsec | Время, прошедшее до получения ответа. |
status | Указывает на статус ответа на запрос. |
Журналы выполнения
В таблице ниже приведена схема записи в журнале 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 | Языковой код, связанный с запросом. |
Журналы уведомлений
В таблице ниже приведена схема записи в файле notificationLog :
| Свойство | Описание |
|---|---|
requestId | Идентификатор запроса на уведомление. |
structName | Название структуры уведомления, например, "ObjectDetection". |
status | Указывает статус уведомления. |
настройка уровня лога
В проектах, Cloud-to-cloud по умолчанию настроено получение журналов ошибок, однако разработчики могут дополнительно включить получение журналов успешных операций. Это особенно полезно на этапе разработки, когда планируется сбор всех журналов от нескольких агентов. За превышение квоты на ведение журналов может взиматься дополнительная плата.
Вы можете управлять уровнем логирования для своего проекта следующим образом:
В разделе Actions on Google Console перейдите на страницу «Проекты».
Выберите свой проект «умного дома».
Выберите вкладку «Разработка» и нажмите «Действия» на боковой панели.
Выберите «Все» в раскрывающемся списке «Прием данных для управления журналами» .
Исключения из журналов
Разработчики могут создавать исключения для логов, используя язык запросов логирования , что позволяет более гибко настраивать отображение логов. Язык запросов логирования также используется в Logs Explorer, поэтому вы можете использовать Logs Explorer для создания запросов.
Вы можете выполнить действия по созданию фильтров исключения, описанные в этом руководстве (настройте фильтр исключения для приемника _Default ).
Метрики на основе логов
Разработчики могут использовать метрики на основе логов для отслеживания и анализа закономерностей в своих журналах. Также можно создавать пользовательские диаграммы и настраивать оповещения на основе метрик логов.
Чтобы начать использовать метрики на основе логов для умного дома, ознакомьтесь с руководством по созданию счетчика на основе метрик .
Связанные ресурсы
Чтобы узнать больше об использовании Cloud Logging в вашем проекте, ознакомьтесь со следующей документацией :
- Цены : Подробная информация о распределении квот и дополнительных расходах.
- Квоты и лимиты : Подробная информация об ограничениях и политике хранения данных для ведения журналов.
- Расширенные запросы к журналам : руководство по использованию сложных выражений для запроса и анализа данных журналов.