У разработчиков появилась возможность мониторинга навыков умного дома

Как мониторить работу навыка умного дома?

Эти вопросы возникают, пожалуй, у каждого разработчика навыков Алисы. Как отслеживать работу своего продукта после успешного тестирования и публикации? Как оценить качество его работы, чтобы избежать блокировки?

Решить эти задачи поможет новый раздел консоли разработчика — Мониторинг. Теперь эта вкладка доступна на странице каждого навыка. Она содержит в себе следующие данные:

• Количество запросов от платформы умного дома Яндекса до платформы провайдера;
• Количество и тип ошибок при обработке запросов;
• Количество ошибок обновления списка устройств, которые могут появиться как из-за некорректного описания устройства, так и ошибок в протоколе ответа;
• Тайминг ответов платформы разработчика навыка на запросы со стороны умного дома.

Разработчики могут выбирать:

• Период отображения данных. Доступны временные отрезки вплоть до полугода, по умолчанию — одни сутки;
• Интерфейсы, с которых команды отправлялись в навык — поисковое приложение, Алиса, консоль разработчика;
• Типы запросов, для которых нужно отразить статистику.

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

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

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

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

1. Период отчета - Календарный период времени, за который будет построен отчет. По умолчанию выбраны сутки. Также можно установить интервал дат, не превышающий полгода.
2. Источник - Для каких источников строить отчет. Под источником имеется в виду интерфейс, с помощью которого отправлялись команды в навык. Например, с помощью Алисы, поискового приложения или через консоль разработчика в режиме тестирования.
3. Тип запроса - Для каких запросов получать статистику. Список типов запросов

Отчеты

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

• HTTP запросы к Endpoint URL
• Ошибки обращения к устройствам
• Ошибки обновления списка устройств
• Тайминги

HTTP запросы к Endpoint URL

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

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

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

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

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

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

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

Тайминги

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