> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md).

# Анализ данных

Диагностируйте потоки данных IoT-устройств в реальном времени с помощью инструмента «Анализ данных». Проверяйте значения атрибутов, целостность данных и просматривайте TCP-дампы и журналы узлов.

**Анализ данных** Это специализированный инструмент устранения неполадок, который обеспечивает диагностику передачи данных IoT-устройств в реальном времени. Когда ваши устройства не передают данные так, как ожидается, этот мощный инструмент позволяет немедленно выполнять проверку и отладку всего автопарка, независимо от производителя или протокола. Для эффективного устранения проблем вы можете:

* Выполняйте проверку работоспособности передачи данных устройств в реальном времени без участия производителя
* Отлаживайте отдельные атрибуты с помощью сфокусированного анализа потока данных
* Проверяйте целостность данных с помощью полного логирования значений (включая значения null)
* Проверяйте процессы преобразования данных и вычисляемые атрибуты
* Получайте доступ к дампам TCP и логам узлов для углубленной технической диагностики
* Сопоставляйте несколько источников данных, чтобы выявлять проблемы интеграции

В отличие от традиционных решений, привязанных к конкретному вендору, **Анализ данных** обеспечивает универсальную совместимость с устройствами и возможности удаленного устранения неполадок через единый технический интерфейс, значительно сокращая время и сложность диагностики устройств.

{% hint style="info" %}
Чтобы открыть Анализ данных:

1. Откройте IoT Logic. Стартовая страница открывается с **Созданные потоки** таблица.
2. Нажмите имя потока, который хотите проанализировать, или откройте его **...** меню и выберите **Редактировать**. Поток откроется на холсте.
3. Нажмите **Анализ данных** вкладка в верхней части холста.
   {% endhint %}

![Представление «Анализ данных»](https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-64233e70edebf9a9953d056d4c33d2d3aa1a3792%2FData_Analyzer_big.png?alt=media)

Давайте подробнее рассмотрим все возможности и функции, которые здесь доступны.

## Основная рабочая область

Основные элементы управления инструментом «Анализ данных» собраны в верхнем меню.

**Поток данных**: Этот список позволяет выбрать уже созданный поток из вашего аккаунта. Это основной параметр группировки, поэтому вы сможете искать только устройства и атрибуты, принадлежащие выбранному потоку.

**Режим**: В инструменте есть два режима, и вид зависит от выбранного режима.

* **Табличный вид** (по умолчанию): Этот режим отображает декодированные данные с устройств в табличном виде.
* **Журналы потоков** (скоро будет доступно): Этот режим отображает общие журналы, дампы TCP и логи узлов в выбранном потоке. Он будет добавлен в следующих итерациях.

{% hint style="info" %}
Приведенные выше параметры сейчас неактивны и содержат значения по умолчанию. Они станут доступны после дальнейшего расширения функциональности IoT Logic. Следите за обновлениями!
{% endhint %}

При нажатии на **Закрыть** кнопка возвращает вас на главный экран IoT Logic.

Теперь давайте подробнее рассмотрим разделы интерфейса и доступную в них информацию.

## Табличный вид

### Верхняя строка меню

![Элементы управления верхней строки меню](https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ee5bbc0ade92cf35375b25b2265c0863fb7dd3b7%2FMenu_bar.png?alt=media)

В верхнем меню находятся основные элементы управления табличным видом.

* **Переключатель «Исключать null»**: Этот параметр позволяет переключаться между двумя режимами отображения данных:
  * **Выключено**: Отображает все значения на основе пакетов, полученных от устройства, включая те, в которых выбранный атрибут имеет значения null (отсутствующие значения). Этот режим обеспечивает полное представление всех данных пакетов.
  * **Включено**: Отображает только те пакеты, в которых по выбранному атрибуту были фактически получены данные с устройств и содержатся корректные, не-null значения. Иными словами, он отфильтровывает неполные данные.
* **Глубина**: Этот параметр отвечает за глубину истории данных и определяет диапазон последних данных, которые нужно отображать. Например, на сколько шагов в прошлое нужно уйти, чтобы показать значения атрибута. Максимум — 12 шагов в прошлое. Вы можете выбрать, сколько шагов хотите видеть, и посмотреть, как меняются значения. Например, если установить глубину = 4, вы увидите значения за три шага в прошлом \[3], \[2], \[1] и последние полученные значения \[0].
* **Пуск/пауза**: Эта кнопка позволяет начать получать обновления значений в таблице в реальном времени или приостановить их.
* **Поиск значения**: Это поле используется для поиска конкретного значения среди всех атрибутов в таблице. Максимум — 100 символов для поиска. Например, если вы проверяете работу событий и ищете конкретное событие, которое должно сработать на устройстве, искомое значение будет выделено.
* **Экспорт**: Вы можете экспортировать все журналы с помощью кнопки экспорта, чтобы поделиться информацией с другими специалистами. Информация будет в формате JSON, чтобы ее было легче читать.

### Блок устройств и атрибутов

В левом блоке меню содержится список устройств и атрибутов, относящихся к выбранному потоку. Чтобы переключаться между списками, используйте **Устройства** и **Атрибут** кнопки в верхней части списка. Вы можете искать устройства по ID, а атрибуты — по их названиям.

{% columns %}
{% column %}
![Добавление устройств для мониторинга](https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-6cfc30f8c71afd682ac1c4271d064d10736039a5%2FDevices_list.png?alt=media)
{% endcolumn %}

{% column %}
![Добавление атрибутов для мониторинга](https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-08c305a53836a9e7766138a2e4c111f9a0c5ba1c%2FAttributes_list.png?alt=media)
{% endcolumn %}
{% endcolumns %}

Вы можете выбрать до 10 устройств. После выбора отображаются все атрибуты, поддерживаемые этими устройствами, и вы можете выбрать любое количество для отображения в таблице. Будут доступны только атрибуты, относящиеся к выбранным устройствам.

### Таблица последних значений атрибутов

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

![Пример табличного вида](https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-1adb6be507b789d981673ac9eb1d73b1c9ea82f9%2FTable_example.png?alt=media)

Таблица предоставляет информацию следующим образом:

* Строка заголовка таблицы — это список устройств, выбранных для мониторинга. Эти устройства становятся столбцами, которые показывают значения каждого устройства.
* Строки с названиями атрибутов группируют данные выбранного атрибута. Ниже отображается информация, собранная по этому атрибуту на выбранной глубине для каждого устройства.\
  Первый столбец в строках под названием атрибута с числами отвечает за глубину значений. Где 0 — текущее значение, 1 — предыдущее и так далее.

При наведении курсора на любое значение вы увидите дополнительные данные о том, когда этот атрибут был сгенерирован устройством и когда он был получен платформой Navixy:

![Пример временной метки значения](https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5d715c21104434f1aabec1543cc579017752b9eb%2Fimage-20241204-160551.png?alt=media)

После получения новых значений от любого устройства они подсвечиваются зеленым примерно на 2 секунды. Так вы видите, какой атрибут на каком устройстве был обновлен. Нажатие на строку устройства разворачивает ее, показывая исторические значения, ограниченные заданной глубиной. **Глубина**.

#### Чтение таблицы

Давайте интерпретируем значения таблицы на примере на скриншоте выше и посмотрим, какие выводы можно сделать:

* раздел «Устройство» **#1Teltonika FMB001** не возвращает никаких значений. Это может означать, что устройство не может предоставлять именно этот тип данных. Проверьте, есть ли у этого устройства какие-либо другие атрибуты со значениями; если нет, убедитесь, что устройство подключено правильно.
* Устройства **#2Teltonika FMB001** - **#5Teltonika FMB001** стабильно возвращают значения, что указывает на корректное подключение. Их местоположение можно определить с помощью **широта** и **долгота** атрибутов. Поскольку их координаты остаются неизменными на протяжении нескольких последних **Глубина** уровней, устройства неподвижны. Это дополнительно подтверждается **в движении** атрибутом, значение которого равно **0**. Судя по этим наблюдениям, данные выглядят корректными и обновляются в реальном времени.
* раздел «Устройство» **STARLINK** предоставил значения только для одного **Глубина** уровня, что указывает на недавнее подключение. Отсутствие значений по **в движении** атрибуту, вероятно, означает, что у этого устройства, скорее всего, нет соответствующего датчика.

## Доступность данных

Анализ данных хранит последние значения устройства до 30 дней после последнего сообщения с этого устройства. Navixy хранит значения в памяти для быстрой диагностики, а не в долговременном хранилище.

Если устройство не передает ничего дольше 30 дней, Navixy сразу удаляет все кэшированные значения этого устройства. Устройство по-прежнему отображается в **Устройства** списке, но его столбцы в таблице остаются пустыми, пока оно снова не начнет передавать данные. Нажмите **Пуск** чтобы отслеживать новые сообщения и подтвердить, что устройство снова на связи.

Формулы IoT Logic читают те же кэшированные значения, поэтому устройство, вернувшееся после более чем 30 дней бездействия, начинает без истории. Подробности см. в [Полный синтаксис](/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#full-syntax).

30-дневный период применяется только к значениям, которые показывает Анализ данных. Он не ограничивает историю треков и событий в вашем аккаунте. О сроках хранения этой истории см. в [Хранение данных](/docs/user/ru/guide/account/data-retention.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.