# Salvar dados de IoT em arquivo CSV Em certas situações, prestadores de serviços de telemetria (TSPs), integradores e desenvolvedores precisam ver os dados originais e não alterados de seus rastreadores GPS. Esses dados não adulterados são frequentemente chamados de "raw data". Consultar raw data permite obter uma compreensão mais profunda dos dados coletados e uma perspectiva mais clara sobre suas características. Examinar raw data também pode reduzir o tempo necessário para descobrir por que os dispositivos não estão funcionando corretamente. Isso significa que você pode ajudar os usuários a corrigir problemas mais rapidamente, o que pode aumentar a confiança deles em seu produto. Além disso, isso permite que você dedique mais tempo à criação de novas soluções para seus clientes. Além disso, os avanços recentes em tecnologia, inteligência artificial e machine learning estão criando novas formas de usar esses dados. Você pode obter esses raw data e utilizá-los em outros sistemas (isto é, CRM, ERP, etc.) para análises adicionais ou em diferentes áreas do seu negócio. Dessa forma, você consegue recuperar raw data em uma única etapa, em vez de coletar dados de dispositivos e sensores por meio de diferentes chamadas de API. Vamos nos aprofundar em "raw data". Com base no valioso feedback fornecido por nossos parceiros, bem como em experimentos realizados no Navixy Lab, elaboramos a definição concisa abaixo. {% hint style="info" %} Raw data parseado é o resultado obtido após a decodificação (parsing) dos pacotes de dados recebidos, considerando o protocolo e as especificidades do modelo do dispositivo de origem. Após a decodificação, o pacote é armazenado como parâmetros universais da plataforma, como latitude, longitude, can\_fuel\_liters, etc. {% endhint %} ## Exportação de raw data Com base em nossa pesquisa e desenvolvimento, criamos uma nova ferramenta. Essa ferramenta permite que TSPs, integradores, desenvolvedores e até usuários avançados obtenham raw data parseado de qualquer um de seus dispositivos. Eles podem coletar dados sobre quaisquer parâmetros dos últimos 30 dias em formato CSV. Para facilitar o uso, adicionamos uma seção de exportação de raw data à interface do usuário em "Devices and Settings". Escolhemos o formato de arquivo CSV por sua simplicidade e uso comum. É fácil convertê-lo em tabelas ou fornecê-lo a programas que usam inteligência artificial ou machine learning.

Exportação de raw data

### Recursos da exportação de raw data Vamos explorar os recursos desta nova ferramenta: * Ela permite fazer upload de raw data parseado de qualquer rastreador GPS em nossa plataforma. * Você pode escolher quaisquer parâmetros de todos os modelos de dispositivos disponíveis para incluí-los em seu arquivo. Além disso, você pode selecionar apenas os parâmetros que são úteis para sua tarefa específica. Para escolher parâmetros, você pode pesquisar facilmente na lista de opções disponíveis para o rastreador GPS selecionado. * Não é necessário ativar o armazenamento de dados antes de desejar obtê-los. Todos os dados de todos os dispositivos são registrados automaticamente. Você pode baixar esses dados quando quiser. * Você pode acessar até 30 dias de raw data parseado de qualquer rastreador GPS. * Para grandes clientes que operam em diferentes países e fusos horários, tornamos mais fácil trabalhar com informações. A ferramenta pode ajustar os carimbos de data e hora dos pacotes para corresponder ao fuso horário selecionado. ## Casos de uso típicos para exportação de raw data Como mencionamos antes, esta nova ferramenta é útil para qualquer pessoa que use rastreadores GPS. Agora, vamos falar sobre algumas das formas de usar esta ferramenta. ### Análise, Machine Learning e IA Você pode usar os dados recebidos dos rastreadores GPS em um formato legível por máquinas. Esses dados podem ser fornecidos à inteligência artificial ou ao machine learning para processamento. As formas de usar esses dados são infinitas. Por exemplo, a IA poderia verificar e apontar quando veículos, seus recursos e combustível estão sendo usados de forma inadequada, ou poderia criar heatmaps. ### Verificações de configuração do rastreador GPS Você pode verificar como seus rastreadores estão configurados observando os dados dos parâmetros. É possível ver se um parâmetro está configurado para enviar dados à plataforma e se seus dados estão sendo recebidos nos pacotes do dispositivo. Por exemplo, se não houver dados, isso significa que o parâmetro não está configurado para enviar dados ou que o sensor foi desconectado do dispositivo GPS e está enviando um código de erro ou nenhuma informação. ### Diagnóstico de dados de sensores Você pode verificar como o sensor está funcionando lendo informações sem multiplicadores ou tabelas de calibração. Por exemplo, se os contatos do sensor de combustível estiverem enferrujados, a plataforma pode receber leituras distorcidas do nível de combustível. É muito mais difícil identificar essas mudanças usando dados calibrados e relatórios de variação do nível de combustível do que raw data. Portanto, os dados baixados serão muito úteis para o ajuste fino e a correção de operação incorreta. Os dados também podem ser usados para recalibrar o sensor se ele estiver apresentando dados incorretos. ### Diagnóstico de acionamento de regras Você pode verificar como os dispositivos processam eventos acompanhando os IDs de evento. Você pode tentar acionar manualmente um evento e testar se a plataforma o dispara e se o dispositivo enviou dados sobre ele. ### Diagnóstico de dispositivo offline Você pode descobrir com mais precisão por que um dispositivo está offline. Assim como nos outros casos, esta é uma situação comum. Por exemplo, se o dispositivo parou de aparecer na plataforma, exportar raw data permite ver quais dados sobre intensidade do sinal e nível da bateria interna e externa estavam sendo enviados à plataforma antes da desconexão. Pode ter havido alguns eventos de desconexão, mas nenhuma regra foi criada. Sem esta ferramenta, você só poderia reunir informações sobre a bateria externa por meio de um relatório e, para eventos sem regra, teria de consultar o suporte. Agora, você pode acompanhar leituras históricas de todos os parâmetros ao mesmo tempo para encontrar possíveis motivos para a desconexão do dispositivo ou para a falta de recebimento de dados do dispositivo. ### Soluções personalizadas para clientes Você pode criar soluções personalizadas para seus clientes. Por exemplo, um cliente frequentemente precisa de dados para análise de diferentes leituras do dispositivo em um único relatório. Agora, você pode fazer isso usando raw data do dispositivo. Você também pode usar esses dados no Grafana ou no PowerBi para criar análises avançadas. ## Como usar a exportação de raw data Primeiro, você precisa ir para a seção "devices and settings" e localizar o dispositivo de seu interesse na interface do usuário:

UI da aba Devices and settings

Ou encontre as configurações do rastreador de um dispositivo específico no painel administrativo:

Painel administrativo das configurações do rastreador

Em seguida, clique no botão "Export data" no bloco **Raw data** :
Isso abrirá a ferramenta "Raw data export". Aqui, você precisa escolher o intervalo de datas, o fuso horário e os parâmetros que deseja incluir em um arquivo csv.

Janela da ferramenta Raw data export

Garantimos que você não fechará a janela acidentalmente ao clicar fora da ferramenta "Raw data export". Você só pode fechá-la clicando no "X" no canto superior direito. Além disso, se você não tiver escolhido outro dispositivo nem atualizado a página, a ferramenta "Raw data export" lembrará todas as configurações selecionadas anteriormente. Isso facilita verificar quaisquer configurações de rastreador GPS ou sensor, voltar e continuar trabalhando. ### Escolhendo o intervalo de datas Esse processo é igual ao de criar um histórico de viagens. Você pode escolher no máximo os últimos 30 dias. Selecione um intervalo de datas clicando no calendário ou inserindo as datas manualmente. Você também pode definir um horário específico. Aqui estão algumas opções úteis para escolher rapidamente um período: * Ontem * Na semana passada * Últimos 30 dias Ao clicar nessas opções, a plataforma selecionará automaticamente o intervalo correto.

Seletor de intervalo de datas da exportação de raw data

Para facilitar, adicionamos um contador indicando quantos dias você selecionou. Se você tentar escolher uma data com mais de 30 dias de antecedência, receberá uma mensagem. O botão de seleção não ficará disponível. ### Escolhendo um fuso horário Você pode escolher qualquer fuso horário de que precisar. Por exemplo, se você precisar fornecer dados para IA ou ML, que exigem um mesmo fuso horário para todas as mensagens, mesmo se estiver prestando serviços em diferentes países e fusos horários. Veja como escolher o fuso horário desejado: * Selecione um em uma lista de todos os fusos horários possíveis. * Digite o nome do fuso horário. * Digite o fuso horário, por exemplo -8, +2, etc.

Seletor de fuso horário da exportação de raw data

### Selecionando parâmetros A lista de parâmetros que você pode escolher pode variar de acordo com o modelo. Ela inclui todos os parâmetros possíveis que foram integrados à plataforma para cada modelo. Você pode selecionar até 1000 parâmetros no total. Veja o que você pode fazer: * Selecione todos os parâmetros clicando na caixa de seleção à esquerda da pesquisa. * Escolha apenas os parâmetros necessários clicando na caixa de seleção à esquerda de cada parâmetro na lista. * Encontre os parâmetros de que precisa digitando o nome deles ou parte do nome. Se houver mais de uma entrada do mesmo tipo, elas serão numeradas (2, 3, 4...). Nesse caso, apenas a entrada com o maior índice é retornada. Por exemplo, se forem disponibilizados AVL IOs de 1 a 100000 para um dispositivo, apenas avl\_io\_100000 é retornado, embora AVL IOs com índices menores também existam. Depois de selecionar esse parâmetro de índice no lado direito, a plataforma solicitará que você especifique quais índices devem ser adicionados ao arquivo. Insira uma lista de números separados por vírgulas ou defina um intervalo de números com um hífen. Por exemplo, 1-2, 4, 7. Para todos os parâmetros e para cada parâmetro de índice, você verá uma contagem indicando quantos já escolheu. Cada parâmetro escolhido adicionará uma coluna extra ao arquivo.

Seleção de parâmetros da exportação de raw data

## Baixando o arquivo de raw data Depois de escolher todos os parâmetros, clique no botão "Download CSV" para iniciar o download. Você pode abrir o arquivo com qualquer editor de texto ou visualizador de tabelas. Este arquivo CSV usa vírgula para separar os dados. O nome do arquivo inclui o ID do dispositivo, o rótulo do rastreador e o intervalo de data e hora dentro do fuso horário. Cada linha, a partir da segunda, é uma mensagem do dispositivo enviada à plataforma. A primeira linha sempre mostra a hora da mensagem no fuso horário selecionado, e o restante são os parâmetros que você selecionou.

Exemplo de colunas de raw data

Para obter mais informações sobre como ler e entender o arquivo de raw data [siga nosso próximo artigo](/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md). Esperamos que esta nova ferramenta seja útil para o seu negócio e para seus clientes. Ela deve permitir que você crie muitas novas soluções usando arquivos de raw data. Lembre-se: até os menores detalhes podem levar a grandes descobertas. Boa exploração! --- # 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/pt-br/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.