# Сохранение данных IoT в CSV-файл В некоторых случаях TSP, интеграторам и разработчикам необходимо видеть исходные, не изменённые данные со своих GPS-трекеров. Эти необработанные данные часто называют «raw data». Просмотр raw data позволяет глубже понять собранные данные и получить более чёткое представление об их характеристиках. Анализ raw data также может сократить время, необходимое для выяснения причин некорректной работы устройств. Это означает, что вы сможете быстрее помогать пользователям устранять проблемы, а значит, повысить доверие к вашему продукту. Кроме того, это позволит вам больше времени уделять созданию новых решений для ваших клиентов. Более того, недавние достижения в области технологий, искусственного интеллекта и машинного обучения открывают новые способы использования этих данных. Вы можете получать эти raw data и использовать их в других системах (например, CRM, ERP и т. д.) для дальнейшего анализа или в других частях вашего бизнеса. Такой подход позволяет получать raw data за один шаг вместо сбора данных с устройств и датчиков через разные API-вызовы. Давайте подробнее разберёмся с «raw data». Опираясь на ценную обратную связь от наших партнёров, а также проводя эксперименты в Navixy Lab, мы подготовили краткое определение ниже. {% hint style="info" %} Обработанные raw data — это результат декодирования (парсинга) входящих пакетов данных с учётом протокола и особенностей модели исходного устройства. После декодирования пакет сохраняется как универсальные параметры платформы, такие как latitude, longitude, can\_fuel\_liters и т. д. {% endhint %} ## Экспорт raw data В рамках наших исследований и разработок мы создали новый инструмент. Он позволяет TSP, интеграторам, разработчикам и даже продвинутым пользователям получать обработанные raw data с любых своих устройств. Они могут собирать данные по любым параметрам за последние 30 дней в формате CSV. Чтобы упростить использование, мы добавили раздел экспорта raw data в пользовательский интерфейс в разделе «Устройства и настройки». Мы выбрали формат CSV-файла из-за его простоты и широкого распространения. Его легко преобразовать в таблицы или передать программам, использующим искусственный интеллект или машинное обучение.

Экспорт raw data

### Функции экспорта raw data Давайте рассмотрим возможности этого нового инструмента подробнее: * Он позволяет загружать обработанные raw data для любого GPS-трекера на нашей платформе. * Вы можете выбрать любые параметры из всех доступных моделей устройств для включения в файл. Кроме того, вы можете выбрать только те параметры, которые полезны для вашей конкретной задачи. Чтобы выбрать параметры, вы можете легко выполнить поиск в списке доступных опций для выбранного GPS-трекера. * Нет необходимости включать сохранение данных заранее, чтобы затем получить эти данные. Все данные по всем устройствам автоматически записываются. Вы можете скачать эти данные в любой момент. * Вы можете получить доступ к обработанным raw data за последние 30 дней для любого GPS-трекера. * Для крупных клиентов, работающих в разных странах и часовых поясах, мы упростили работу с информацией. Инструмент может корректировать временные метки пакетов в соответствии с выбранным часовым поясом. ## Типичные сценарии использования экспорта raw data Как мы уже упоминали, этот новый инструмент полезен для всех, кто использует GPS-трекеры. Теперь давайте поговорим о некоторых способах его применения. ### Аналитика, машинное обучение и ИИ Вы можете использовать входящие данные от GPS-трекеров в форме, которую могут читать машины. Эти данные можно передавать искусственному интеллекту или машинному обучению для обработки. Способы использования этих данных практически безграничны. Например, ИИ может проверять и выявлять случаи, когда транспортные средства, их ресурсы и топливо используются ненадлежащим образом, или создавать тепловые карты. ### Проверка конфигурации GPS-трекера Вы можете проверить, как настроен ваш трекер, посмотрев данные по параметрам. Вы сможете увидеть, настроен ли параметр на передачу данных на платформу и поступают ли его данные в пакетах устройства. Например, если данных нет, это означает, что параметр не настроен на передачу или датчик был отсоединён от GPS-устройства и отправляет код ошибки либо вообще не передаёт информацию. ### Диагностика данных датчиков Вы можете проверить, как работает датчик, считывая информацию без множителей или таблиц калибровки. Например, если контакты датчика топлива заржавели, платформа может получать искажённые показания уровня топлива. Такие изменения гораздо сложнее заметить с использованием откалиброванных данных и отчётов об изменении уровня топлива, чем с помощью raw data. Поэтому загруженные данные будут очень полезны для тонкой настройки и устранения некорректной работы. Эти данные также можно использовать для повторной калибровки датчика, если он показывает неверные значения. ### Диагностика срабатывания правил Вы можете проверить, как устройства обрабатывают события, отслеживая идентификаторы событий. Вы можете попробовать вручную сгенерировать событие и проверить, срабатывает ли оно на платформе и отправило ли устройство данные о нём. ### Диагностика офлайн-режима устройства Вы сможете точнее определить, почему устройство находится офлайн. Как и в других случаях, это распространённая ситуация. Например, если устройство перестало отображаться на платформе, экспорт raw data позволит увидеть, какие данные об уровне сигнала, внутреннем и внешнем заряде батареи передавались на платформу до отключения. Возможно, были события отключения, но правило не было создано. Без этого инструмента вы могли бы получать сведения о внешней батарее только через отчёт, а по событиям без правила пришлось бы обращаться в поддержку. Теперь вы можете отслеживать исторические значения всех параметров одновременно, чтобы найти возможные причины отключения устройства или отсутствия данных от него. ### Индивидуальные решения для клиентов Вы можете создавать индивидуальные решения для своих клиентов. Например, клиенту часто нужны данные для аналитики по разным показателям устройства в одном отчёте. Теперь это можно делать с использованием raw data устройства. Эти данные также можно использовать в Grafana или PowerBi для построения расширенной аналитики. ## Как использовать экспорт raw data Сначала необходимо перейти в раздел «Устройства и настройки» и найти интересующее вас устройство в пользовательском интерфейсе:

Вкладка «Устройства и настройки» в интерфейсе

Или найдите настройки трекера для конкретного устройства в панели администратора:

Настройки трекера. Панель администратора

Затем нажмите кнопку «Экспорт данных» в **Raw data** блоке:
Откроется инструмент «Экспорт raw data». Здесь необходимо выбрать диапазон дат, часовой пояс и параметры, которые вы хотите включить в файл csv.

Окно инструмента экспорта raw data

Мы позаботились о том, чтобы вы случайно не закрыли окно, щёлкнув вне инструмента «Экспорт raw data». Закрыть его можно только нажатием на «X» в правом верхнем углу. Кроме того, если вы не выбрали другое устройство и не обновили страницу, инструмент «Экспорт raw data» запомнит все ранее выбранные вами настройки. Это позволяет легко проверить любые настройки GPS-трекера или датчика, вернуться назад и продолжить работу. ### Выбор диапазона дат Этот процесс аналогичен созданию истории поездок. Вы можете выбрать максимум последние 30 дней. Выберите диапазон дат, щёлкнув по календарю или введя даты вручную. Вы также можете задать конкретное время. Ниже приведены удобные варианты для быстрого выбора периода: * Вчера * Прошлая неделя * Последние 30 дней При нажатии на них платформа автоматически выберет нужный диапазон.

Выбор диапазона дат для экспорта raw data

Чтобы вам было удобнее, мы добавили счётчик количества выбранных дней. Если вы попытаетесь выбрать дату более чем 30 дней назад, появится сообщение. Кнопка выбора будет недоступна. ### Выбор часового пояса Вы можете выбрать любой нужный вам часовой пояс. Например, если вам нужно передать данные для ИИ или ML, которым требуется один и тот же часовой пояс для всех сообщений, даже если вы предоставляете услуги в разных странах и часовых поясах. Вот как можно выбрать нужный часовой пояс: * Выберите один из списка всех доступных часовых поясов. * Введите название часового пояса. * Введите смещение часового пояса, например -8, +2 и т. д.

Выбор часового пояса для экспорта raw data

### Выбор параметров Список доступных параметров может различаться в зависимости от модели. Он включает все возможные параметры, интегрированные в платформу для каждой модели. Вы можете выбрать в общей сложности до 1000 параметров. Вы можете сделать следующее: * Выбрать все параметры, нажав флажок слева от строки поиска. * Выбрать только нужные параметры, нажав флажок слева от каждого параметра в списке. * Найти нужные параметры, введя их название или часть названия. Если существует более одного входа одного типа, они нумеруются (2, 3, 4...). В этом случае возвращается только вход с наибольшим индексом. Например, если для устройства доступны AVL IO с 1 по 100000, возвращается только avl\_io\_100000, даже если AVL IO с меньшими индексами также существуют. После того как вы выберете такой индексный параметр справа, платформа попросит указать, какие индексы следует добавить в файл. Введите список чисел, разделённых запятыми, или задайте диапазон чисел через дефис. Например, 1-2, 4, 7. Для всех параметров и каждого индексного параметра вы увидите счётчик, показывающий, сколько уже выбрано. Каждый выбранный вами параметр добавит в файл дополнительный столбец.

Выбор параметров для экспорта raw data

## Скачивание файла raw data После того как вы выберете все параметры, нажмите кнопку «Скачать CSV», чтобы начать загрузку. Вы можете открыть файл в любом текстовом редакторе или табличном просмотрщике. Этот CSV-файл использует запятую в качестве разделителя данных. Имя файла включает ID устройства, метку трекера и диапазон даты и времени в пределах часового пояса. Каждая строка, начиная со второй, представляет собой сообщение от устройства, отправленное на платформу. В первой строке всегда указано время сообщения в выбранном часовом поясе, а остальные столбцы — это выбранные вами параметры.

Пример столбцов raw data

Для получения дополнительной информации о чтении и понимании файла raw data [перейдите к нашей следующей статье](/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md). Надеемся, этот новый инструмент окажется полезным для вашего бизнеса и ваших клиентов. Он должен позволить вам создавать множество новых решений с использованием файлов raw data. Помните: даже самые незначительные детали могут привести к большим открытиям. Удачных исследований! --- # Agent Instructions: 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: ``` GET https://navixy.com/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.