Мониторинг работы навыка

  1. Статистика
  2. Отчеты
  3. Как работать с аналитикой
  4. Полезные видео

Платформа умного дома Яндекса позволяет анализировать работу вашего навыка — просматривать статистику запросов и получать отчеты об ошибках. Это поможет своевременно выявлять проблемы в обработке запросов от платформы умного дома.

Статистика

Статистика доступна только для опубликованных навыков.

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

Вкладка Мониторинг в консоли разработчика
1. Период отчета

Период, за который будет построен отчет. По умолчанию выбраны сутки. Можно установить интервал дат, не превышающий полгода.

2. Источник
Для каких источников строить отчет. Под источником имеется в виду интерфейс, с помощью которого отправлялись команды в навык. Список доступных источников:

Содержимое отчета можно настраивать — включать и выключать каждый тип данных под графиком. Например, показывать нужный перцентиль или только ошибки error_http_5xx.

3. Тип запроса
Для каких запросов получать статистику:

Отчеты

Доступны следующие отчеты:

HTTP-запросы к Endpoint URL

Первый график показывает количество запросов от платформы умного дома к навыку — среднее число запросов в секунду за определенную минуту. Например, на графике ниже — 12 ноября в 21:18 было отправлено в среднем 0,15 запроса в секунду (в среднем за эту минуту).

Второй график показывает общее количество ошибок за указанный интервал времени (на графике ниже — за сутки).

Ошибки обращения к устройствам

Первый график показывает среднее число обращений к устройствам (в секунду), которые завершились с ошибкой. Коды ошибок можно посмотреть в разделе Коды ответа.

Второй график также показывает среднее число ошибок при обращении к устройствам — но с группировкой по интервалу времени.

Ошибки обновления списка устройств

Отчет показывает количество ошибок, которые возникли при обновлении списка устройств. Эти ошибки могут возникнуть из-за некорректного описания устройств (validation_error), а также в результате некорректного ответа навыка на запрос платформы умного дома (bad_response). Подробнее о формате ответа см. в разделе Протокол работы платформы умного дома.

Тайминги

График показывает, в какое время укладывается соответствующая выбранному перцентилю доля запросов. Время для каждого запроса считается от отправки запроса платформой умного дома до получения ответа от навыка. Например, если 75-перцентиль для запроса на разъединение аккаунтов (unlink_75) равен 3 секундам, значит 75% от этих запросов уложились в 3 секунды.

Внимание.

Время ожидания ответа от навыка — 3 секунды. Если платформа умного дома не получит ответ в течение этого времени, Алиса сообщит пользователю, что устройства долго не отвечают. При управлении через Умный дом → Устройства пользователь увидит сообщение об ошибке и ID запроса.

В 3 секунды входят:

  • установка сетевого соединения;
  • время доставки запроса до сервера навыка;
  • собственное время работы навыка;
  • время доставки ответа до серверов Алисы.
Внимание. Длина ответа не должна превышать 5000 символов, длина OAuth-токена и refresh-токена — 2048 символов. Время жизни токенов (свойство expires_in) должно быть числом от 1 до 4 294 967 296.

Как работать с аналитикой

Полезные видео

Публикация и продвижение навыков
Разработка прототипа голосового приложения

Служба поддержки