> 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, essa ferramenta poderosa permite verificação e depuração imediatas em toda a sua frota, independentemente do fabricante ou protocolo. Para uma resolução eficiente de problemas, você pode:

* Realizar verificações de integridade em tempo real da transmissão de dados do dispositivo sem intervenção do fornecedor
* Depurar atributos específicos por meio de análise focada do fluxo de dados
* Validar a integridade dos dados com registro abrangente de valores (incluindo valores nulos)
* Verificar os processos de transformação de dados e os atributos calculados
* Acessar dumps de TCP e logs de nó para diagnósticos técnicos aprofundados
* Cruzar várias fontes de dados para identificar problemas de integração

Ao contrário das soluções convencionais específicas de fornecedores, **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 **...** menu e selecione **Editar**. O fluxo é aberto na tela.
3. Enviar **Analisador de dados** aba no topo da tela.
   {% endhint %}

![Visualizaçã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ê pode encontrar aqui.

## Área de trabalho principal

As principais opções de controle da ferramenta Analisador de dados ficam reunidas no menu superior.

**Fluxo de dados**: Esta lista permite que você selecione 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 os registros gerais, dumps de TCP e logs 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 novos aprimoramentos da funcionalidade do IoT Logic. Fique atento!
{% endhint %}

Clicar no **Fechar** botão retorna você à 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 da visualização em tabela.

* **Excluir nulos**: Esta configuração permite alternar entre dois modos de exibição de dados:
  * **Desligado**: Exibe todos os valores com base nos pacotes recebidos do dispositivo, inclusive aqueles em que o atributo selecionado tem valores nulos (ausentes). Este modo fornece uma visão completa de todos os dados dos pacotes.
  * **Ligado**: Exibe apenas os pacotes em que as informações foram realmente recebidas dos dispositivos para o atributo selecionado, com valores válidos e não nulos. Em outras palavras, ele filtra dados incompletos.
* **Profundidade**: Este controle é responsável pela profundidade do histórico de dados e define o intervalo de dados recentes a serem exibidos. Por exemplo, quantos passos no passado precisamos percorrer para mostrar os valores dos atributos. O máximo é 12 passos no passado. Você pode escolher quantos passos deseja ver e verificar como os valores mudam. Por exemplo, se você definir profundidade=4, verá valores de três passos no passado \[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.
* **Pesquisar valor**: Este campo é usado para localizar um valor específico entre todos os atributos na tabela. O máximo é 100 caracteres para pesquisa. Por exemplo, se você estiver verificando o funcionamento dos eventos e procurando um específico que deva ser acionado em um dispositivo, o valor pesquisado será 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** Webhook **Atributo** botões no topo da lista. Você pode pesquisar dispositivos por ID e atributos pelos 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 compatíveis com esses dispositivos são exibidos, permitindo que você escolha quantos quiser para exibir na tabela. Apenas os atributos relevantes para os dispositivos selecionados estarão disponíveis.

### Tabela dos últimos valores dos atributos

As informações sobre os valores recebidos pelos dispositivos e atributos 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 fornece informações da seguinte maneira:

* A linha de cabeçalho da tabela é uma lista dos dispositivos escolhidos para monitoramento. Esses dispositivos se tornam colunas que mostram os valores de cada dispositivo.
* As linhas com nomes de atributos agruparão os dados do atributo escolhido. As informações coletadas na profundidade escolhida desse atributo para cada dispositivo são exibidas abaixo.\
  A primeira coluna nas linhas abaixo do nome do atributo com números é responsável pela profundidade dos valores. Onde 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 e 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. Clicar em uma linha de dispositivo a expande, mostrando valores históricos limitados pela profundidade definida **Profundidade**.

#### Lendo a tabela

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

* seção 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 esse dispositivo; se não houver, certifique-se de que o dispositivo esteja conectado corretamente.
* Dispositivos **#2Teltonika FMB001** - **#5Teltonika FMB001** estão retornando valores consistentemente, indicando que estão conectados corretamente. Sua localização pode ser determinada usando **latitude** Webhook **longitude** atributos. Como suas coordenadas permanecem inalteradas em 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 precisos e atualizados em tempo real.
* seção 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 esse dispositivo provavelmente não possui o sensor relevante.

## Disponibilidade dos 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 armazena os valores em memória para diagnósticos rápidos, 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 armazenados em cache desse dispositivo. O dispositivo ainda aparece na **Dispositivos** lista, mas suas colunas na tabela permanecem vazias até que ele reporte novamente. Clique em **Reproduzir** para acompanhar novas mensagens e confirmar que o dispositivo voltou.

As fórmulas do IoT Logic leem os mesmos valores armazenados em cache, então um dispositivo que retorna após mais de 30 dias de silêncio começa sem histórico. Para 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 mostrados pelo Analisador de dados. Ela não limita o histórico de rastros 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 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/pt-br/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.