> 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)

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

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

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

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

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

* **Табличное представление** (по умолчанию): Этот режим отображает декодированные данные с устройств в табличном виде.
* **Журналы потоков** (скоро появится): Этот режим отображает общие журналы, 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 (отсутствующие значения). Этот режим обеспечивает полный обзор всех данных пакета.
  * **Вкл.**: Отображает только те пакеты, в которых от устройств для выбранного атрибута действительно была получена информация с допустимыми, ненулевыми значениями. Иными словами, он отфильтровывает неполные данные.
* **Глубина**: Этот параметр отвечает за глубину исторических данных и определяет диапазон последних данных, которые будут отображаться. Например, на сколько шагов в прошлое нужно заглянуть, чтобы показать значения атрибутов. Максимум — 12 шагов в прошлое. Вы можете выбрать, сколько шагов хотите видеть, и проверить, как меняются значения. Например, если вы установите depth=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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
