> 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/pt-br/guide/account/iot-logic/data-stream-analyzer.md).

# Analisador de dados

Diagnostique fluxos de dados de dispositivos IoT em tempo real usando o Analisador de dados. Valide valores de atributos, verifique a integridade dos dados e acesse dumps TCP e logs de nós.

**Analisador de dados** é uma ferramenta especializada de solução de problemas que fornece diagnósticos em tempo real para a transmissão de dados de dispositivos IoT. Quando seus dispositivos não estão reportando como esperado, esta poderosa ferramenta permite verificação e depuração imediatas em toda a sua frota, independentemente do fabricante ou protocolo. Para resolver problemas de forma eficiente, você pode:

* Realize verificações de integridade em tempo real da transmissão de dados do dispositivo sem intervenção do fornecedor
* Depure atributos específicos por meio de uma análise focada do fluxo de dados
* Valide a integridade dos dados com registro abrangente de valores (incluindo valores nulos)
* Verifique os processos de transformação de dados e os atributos calculados
* Acesse dumps TCP e registros de nó para diagnósticos técnicos aprofundados
* Cruze informações de múltiplas fontes de dados para identificar problemas de integração

Diferentemente das soluções convencionais específicas de um fornecedor, **Analisador de dados** oferece compatibilidade universal com dispositivos e recursos de solução remota de problemas por meio de uma única interface técnica, reduzindo significativamente o tempo e a complexidade dos diagnósticos de dispositivos.

{% hint style="info" %}
Para abrir o Analisador de dados:

1. Abra o IoT Logic. A página inicial é aberta com a **Fluxos criados** tabela.
2. Clique no nome do fluxo que você deseja analisar ou abra o seu **...** menu e selecione **Editar**. O fluxo é aberto no canvas.
3. Clique na **Analisador de dados** aba na parte superior do canvas.
   {% endhint %}

![Exibição do Analisador de dados](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-64233e70edebf9a9953d056d4c33d2d3aa1a3792%2FData_Analyzer_big.png?alt=media)

Vamos nos aprofundar em todas as possibilidades e funções que você encontra aqui.

## Área de trabalho principal

As principais opções de controle da ferramenta do Analisador de dados estão reunidas no menu superior.

**Fluxo de dados**: Esta lista permite selecionar um fluxo já criado da sua conta. Este é o principal parâmetro de agrupamento, então você poderá pesquisar apenas dispositivos e atributos que pertençam ao fluxo escolhido.

**Modo**: Há dois modos na ferramenta, e a visualização dela depende do modo escolhido.

* **Visualização em tabela** (padrão): Este modo mostra os dados decodificados dos dispositivos em formato tabular.
* **Registros de fluxo** (em breve): Este modo mostra registros gerais, dumps TCP e registros de nó no fluxo escolhido. Ele será adicionado nas próximas iterações.

{% hint style="info" %}
As opções acima estão inativas no momento e contêm as seleções padrão. Elas ficarão disponíveis com novas melhorias na funcionalidade do IoT Logic. Fique atento!
{% endhint %}

Clicar no **Fechar** botão leva você de volta à tela principal do IoT Logic.

Agora vamos analisar mais de perto as seções da interface e as informações disponíveis nelas.

## Visualização em tabela

### Barra de menu superior

![Controles da barra de menu superior](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ee5bbc0ade92cf35375b25b2265c0863fb7dd3b7%2FMenu_bar.png?alt=media)

O menu superior contém os principais controles para a visualização em tabela.

* **Alternância de exclusão de nulos**: Esta configuração permite alternar entre dois modos de exibição de dados:
  * **Desativado**: Exibe todos os valores com base nos pacotes recebidos do dispositivo, inclusive aqueles em que o atributo selecionado tem valores nulos (ausentes). Este modo oferece uma visão completa de todos os dados dos pacotes.
  * **Ativado**: Exibe apenas os pacotes em que realmente houve recebimento de informação dos dispositivos para o atributo selecionado, com valores válidos e não nulos. Em outras palavras, filtra os dados incompletos.
* **Profundidade**: Este controle é responsável pela profundidade dos dados históricos e define o intervalo dos dados recentes a exibir. Por exemplo, quantas etapas no passado precisamos percorrer para mostrar os valores dos atributos. O máximo é 12 etapas no passado. Você pode escolher quantas etapas deseja ver e conferir como os valores mudam. Por exemplo, se você definir profundidade=4, verá os valores de três etapas passadas \[3], \[2], \[1] e os últimos valores recebidos \[0].
* **Reproduzir/Pausar**: Este botão permite iniciar a atualização dos valores na tabela em tempo real ou pausar as atualizações.
* **Valor da pesquisa**: Este campo é usado para encontrar um valor específico entre todos os atributos da tabela. O máximo é de 100 caracteres para pesquisa. Por exemplo, se você estiver verificando o funcionamento de eventos e procurando um específico de um dispositivo que deveria ser acionado, o valor pesquisado fica destacado.
* **Exportar**: Você pode exportar todos os registros usando o botão de exportação para compartilhar informações com outros especialistas. As informações estarão em formato JSON para facilitar a leitura.

### Bloco de dispositivos e atributos

O bloco do menu à esquerda contém uma lista de dispositivos e atributos pertencentes ao fluxo escolhido. Para alternar entre as listas, use os **Dispositivos** e **Atributo** botões na parte superior da lista. Você pode pesquisar dispositivos por ID e atributos pelos seus nomes.

{% columns %}
{% column %}
![Adicionar dispositivos para monitoramento](https://1308974401-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 %}
![Adicionar atributos para monitoramento](https://1308974401-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 %}

Você pode selecionar até 10 dispositivos. Depois de selecionados, todos os atributos suportados por esses dispositivos são exibidos, permitindo que você escolha qualquer quantidade para mostrar na tabela. Apenas os atributos relevantes para os dispositivos selecionados ficarão disponíveis.

### Tabela dos últimos valores dos atributos

As informações sobre os valores recebidos por dispositivo e atributo escolhidos serão exibidas nesta tabela.

![Exemplo de visualização em tabela](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-1adb6be507b789d981673ac9eb1d73b1c9ea82f9%2FTable_example.png?alt=media)

A tabela apresenta as informações da seguinte forma:

* A linha de cabeçalho da tabela é uma lista de dispositivos escolhidos para monitoramento. Esses dispositivos se tornam colunas que mostram valores de cada dispositivo.
* As linhas com nomes de atributos agruparão os dados do atributo escolhido. As informações coletadas na profundidade selecionada desse atributo para cada dispositivo são exibidas abaixo.\
  A primeira coluna nas linhas sob o nome do atributo com números é responsável pela profundidade dos valores. Em que 0 é o atual, 1 é o anterior e assim por diante.

Ao passar o mouse sobre qualquer valor, você vê dados adicionais sobre quando esse atributo foi gerado por um dispositivo e quando foi recebido pela plataforma Navixy:

![Exemplo de carimbo de data/hora do valor](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5d715c21104434f1aabec1543cc579017752b9eb%2Fimage-20241204-160551.png?alt=media)

Assim que novos valores são recebidos de qualquer dispositivo, eles ficam destacados em verde por cerca de 2 segundos. Dessa forma, você vê qual atributo em qual dispositivo foi atualizado. Ao clicar em uma linha de dispositivo, ela é expandida, mostrando valores históricos limitados pelo conjunto **Profundidade**.

#### Ler a tabela

Vamos interpretar os valores da tabela usando o exemplo na captura de tela acima e ver quais insights podemos obter:

* Dispositivo **#1Teltonika FMB001** não está retornando nenhum valor. Isso pode significar que o dispositivo não consegue fornecer esse tipo específico de dado. Verifique se há outros atributos com valores para este dispositivo; se não houver, certifique-se de que o dispositivo esteja conectado corretamente.
* Dispositivos **#2Teltonika FMB001** - **#5Teltonika FMB001** estão retornando valores de forma consistente, indicando que estão conectados corretamente. A localização deles pode ser determinada usando **latitude** e **longitude** atributos. Como as coordenadas permanecem inalteradas ao longo de vários **Profundidade** níveis recentes, os dispositivos estão parados. Isso é ainda confirmado pelo **em movimento** atributo, que tem um valor de **0**. Com base nessas observações, os dados parecem estar corretos e atualizados em tempo real.
* Dispositivo **STARLINK** forneceu valores para apenas um **Profundidade** nível, sugerindo que foi conectado recentemente. A ausência de valores para o **em movimento** atributo provavelmente indica que este dispositivo provavelmente não tem o sensor correspondente.

## Disponibilidade de dados

O Analisador de dados mantém os últimos valores de um dispositivo por até 30 dias após a mensagem mais recente desse dispositivo. A Navixy mantém os valores na memória para diagnósticos rápidos, e não em armazenamento de longo prazo.

Quando um dispositivo não envia nada por mais de 30 dias, a Navixy descarta de uma só vez todos os valores em cache desse dispositivo. O dispositivo ainda aparece na **Dispositivos** lista, mas suas colunas na tabela permanecem vazias até que ele se comunique novamente. Clique **Reproduzir** para monitorar novas mensagens e confirmar que o dispositivo voltou.

As fórmulas do IoT Logic leem os mesmos valores em cache, então um dispositivo que retorna após mais de 30 dias de silêncio começa sem histórico. Para mais detalhes, consulte [Sintaxe completa](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#full-syntax).

A janela de 30 dias se aplica apenas aos valores que o Analisador de dados mostra. Ela não limita o histórico de rotas e eventos na sua conta. Para a retenção desse histórico, consulte [Retenção de dados](/docs/user/pt-br/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/pt-br/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.