Мониторинг работы навыка
Платформа умного дома Яндекса позволяет анализировать работу вашего навыка — просматривать статистику запросов и получать отчеты об ошибках. Это поможет своевременно выявлять проблемы в обработке запросов от платформы умного дома.
Статистика
Статистика доступна только для опубликованных навыков.
Чтобы посмотреть статистику, откройте консоль разработчика, перейдите на страницу навыка и откройте вкладку Мониторинг.
- 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.