---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/monitoring.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/monitoring.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/monitoring.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741

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

<!-- source: ru/_includes/reusables/neuroexpert-button.md -->



<!-- endsource: ru/_includes/reusables/neuroexpert-button.md -->


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

## Статистика {#statistics}

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

Чтобы посмотреть статистику, откройте [консоль разработчика](https://dialogs.yandex.ru/developer/), перейдите на страницу навыка и откройте вкладку **Мониторинг**.

<div class="doc-c-imagemaps__image">
    <img src="https://yastatic.net/s3/doc-binary/docs/dev/dialogs/smart_home/images/monitoring/monitoring.png">
    <a class="doc-c-imagemaps__shape" href="#period" style="left: 15%; top: 79%; width: 6.5%; height: 22%; z-index: 2;"></a>
    <a class="doc-c-imagemaps__shape" href="#source" style="left: 26.5%; top: 79%; width: 6.5%; height: 22%; z-index: 2;"></a>
    <a class="doc-c-imagemaps__shape" href="#period" style="left: 15%; top: 79%; width: 6.5%; height: 22%; z-index: 2;"></a>
    <a class="doc-c-imagemaps__shape" href="#source-type" style="left: 77.5%; top: 79%; width: 6.5%; height: 22%; z-index: 2;"></a>

</div>

<!-- source: ru/_includes/imagemap-styles.md -->

<!-- endsource: ru/_includes/imagemap-styles.md -->


#### 1. Период отчета {#period}

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

#### 2. Источник {#source}

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

- [Алиса](https://yandex.ru/alice).
- Приложение [![](_images/smart-home-app.svg) Дом с Алисой](https://alice.yandex.ru/smart-home).
- [Режим тестирования](https://yandex.ru/dev/dialogs/smart-home/doc/ru/testing.md) в консоли.

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

#### 3. Тип запроса {#source-type}

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

- [Информация об устройствах пользователя.](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/get-devices.md)
- [Информация о состояниях устройств пользователя.](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/post-devices-query.md)
- [Изменение состояния у устройств.](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/post-action.md)
- [Оповещение о разъединении аккаунтов.](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/unlink.md)

## Отчеты {#report}

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

- [HTTP-запросы к Endpoint URL](#rps)
- [Ошибки обращения к устройствам](#err-get-devices)
- [Ошибки обновления списка устройств](#err-query)
- [Тайминги](#time-limit)

#### HTTP-запросы к Endpoint URL {#rps}

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

![](_images/monitoring/rps.png)

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

![](_images/monitoring/err-status.png)

#### Ошибки обращения к устройствам {#err-get-devices}

Первый график показывает среднее число обращений к [устройствам](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-types.md) (в секунду), которые завершились с ошибкой. Коды ошибок можно посмотреть в разделе [Коды ответа](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/response-codes.md).

![](_images/monitoring/err-get-device.png)

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

![](_images/monitoring/status-err-get-device.png)

#### Ошибки обновления списка устройств {#err-query}

Отчет показывает количество ошибок, которые возникли при обновлении списка устройств. Эти ошибки могут возникнуть из-за некорректного описания устройств (`validation_error`), а также в результате некорректного ответа навыка на запрос платформы умного дома (`bad_response`). Подробнее о формате ответа см. в разделе [Протокол работы платформы умного дома](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/resources.md).

![](_images/monitoring/err-refresh-devices.png)

#### Тайминги {#time-limit}

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

![](_images/monitoring/time-limits.png)

<!-- source: ru/_includes/reusables/id-reusables/response-time-limit.md -->
{% note alert %}

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

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

- установка сетевого соединения;
- время доставки запроса до сервера навыка;
- собственное время работы навыка;
- время доставки ответа до серверов Алисы.

{% endnote %}

<!-- source: ru/_includes/reusables/id-reusables/token-length.md -->
{% note alert %}

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

{% endnote %}
<!-- endsource: ru/_includes/reusables/id-reusables/token-length.md -->
<!-- endsource: ru/_includes/reusables/id-reusables/response-time-limit.md -->

## Как работать с аналитикой {#analytics}

<div style="
    border:1px solid #d1d5db;
    border-radius:20px;
    overflow:hidden;
    max-width:100%;
">
  <iframe src="https://runtime.strm.yandex.ru/player/video/vplvpzzubva6dvj5wixw?autoplay=0&mute=0"
    frameborder="0"
    allowfullscreen
    style="
      display:block;
      width:100%;
      height:360px;
      "></iframe>
</div>



## Полезные видео {#useful-video}


{% cut "Публикация и продвижение навыков (с 22:06)" %}

<div style="
    border:1px solid #d1d5db;
    border-radius:20px;
    overflow:hidden;
    max-width:100%;
">
  <iframe src="https://runtime.strm.yandex.ru/player/video/vplverwkt63q2a6ildqc?autoplay=0&mute=0"
    frameborder="0"
    allowfullscreen
    style="
      display:block;
      width:100%;
      height:360px;
      "></iframe>
</div>

{% endcut %}

{% cut "Разработка прототипа голосового приложения (с 11:11:47)" %}

<div style="
    border:1px solid #d1d5db;
    border-radius:20px;
    overflow:hidden;
    max-width:100%;
">
  <iframe src="https://runtime.strm.yandex.ru/player/video/vplvba3haj2wbsimewde?autoplay=0&mute=0"
    frameborder="0"
    allowfullscreen
    style="
      display:block;
      width:100%;
      height:360px;
      "></iframe>
</div>

{% endcut %}


<!-- source: ru/_includes/about/id-support/support-button.md -->
[![Служба поддержки](_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)
<!-- endsource: ru/_includes/about/id-support/support-button.md -->