> 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/expert-center/pt-br/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md).
# Análise de dados de Combustível com Grafana por meio da integração da API da Navixy
Visualize dados de Combustível e telemática no Grafana conectando-se à API da Navixy. Configuração passo a passo de painéis para Monitor do consumo histórico.
## Introdução
Às vezes, nossos parceiros e integradores encontram situações em que precisam de uma análise mais aprofundada dos dados brutos de combustível e dos parâmetros relacionados. Essa análise pode envolver a verificação do nível de combustível, velocidade, tensão ou status da ignição em períodos específicos e áreas no mapa para identificar quaisquer eventos anormais. Ela também pode fornecer insights sobre as configurações dos sensores, diagnosticar problemas e monitorar o desempenho em tempo real. Neste artigo, vamos explorar como integrar as APIs do Grafana e da Navixy para recuperar e visualizar facilmente os dados de controle de combustível.
Grafana é uma ferramenta de visualização de dados de código aberto que oferece uma ampla variedade de opções de visualização personalizáveis. Ela pode ser facilmente instalada e configurada até mesmo no seu PC ou laptop. O processo de instalação normalmente leva cerca de 30 minutos.
## Conectando a Navixy ao Grafana
Seguindo este guia passo a passo, você pode integrar a Navixy ao Grafana sem problemas, permitindo visualizar e analisar seus dados de telemetria de forma eficaz.
### Etapa 1: obter a chave de API da Navixy
Comece fazendo login na sua conta Navixy e acessando **Configurações de conta**. Localize a **Chaves de API** seção e gere uma chave de API exclusiva. Essa chave, como `"8f6a4353bc5114d97e2068b4e398"`, será usada para autenticar a conexão entre a Navixy e o Grafana.
### Etapa 2: iniciar o Grafana
O Grafana oferece 2 tipos de acesso: em nuvem ou implantado. O acesso em nuvem pode ser obtido no site oficial . A seguir, vamos explorar como instalar o pacote no seu próprio servidor ou computador local.
Para implantar o Grafana em uma máquina Windows local, siga estas etapas simples:
1. Baixe o instalador mais recente do Grafana para Windows na página oficial de download.
2. Execute o instalador baixado (por exemplo, grafana-xx.x.x.windows-amd64.msi, em que xx.x.x é o número da versão) e conclua a instalação seguindo as instruções.
3. Quando a instalação for concluída, inicie o Grafana executando o arquivo grafana-server.exe localizado na pasta bin do diretório de instalação (por exemplo, C:\Program Files\GrafanaLabs\grafana\bin).
4. Abra um navegador da web e acesse [http://localhost:3000](http://localhost:3000/). Use as credenciais de login padrão "admin" tanto para o nome de usuário quanto para a senha.
5. Depois de fazer login, você pode começar imediatamente a criar e personalizar painéis, utilizando várias fontes de dados para visualizar e analisar seus dados.
Para instalações em Linux/Mac ou se você preferir usar a versão Docker do Grafana, consulte a documentação oficial do Grafana para instruções detalhadas adaptadas à sua configuração específica.
### Etapa 3: instalar o plugin de fonte de dados JSON API
Quando o Grafana for iniciado, vá para o **Conexões** ou **Plugins** menu na interface do Grafana. Procure o plugin de fonte de dados JSON API e selecione-o. Instale o plugin seguindo as instruções fornecidas. Esse plugin é crucial para estabelecer a comunicação entre o Grafana e a API da Navixy. **JSON API** fonte de dados e selecione-a. Instale o plugin seguindo as instruções fornecidas. Esse plugin é crucial para estabelecer a comunicação entre o Grafana e a API da Navixy.
### Etapa 4: configurar a conexão da fonte de dados JSON API
Depois de instalar o **JSON API** plugin, sua instância do Grafana está pronta para se conectar à API da Navixy usando a chave de API.
Siga estas etapas para configurar a conexão:
1. Ir para **Conexões** menu no lado esquerdo
2. Procure por **JSON API** e escolha esta fonte
3. Clique **Criar uma API JSON** fonte de dados
4. Preencha os campos a seguir:
* Nome: Escolha um nome de sua preferência para a fonte de dados
* URL: Insira a URL da API da Navixy. Dependendo da localização da sua plataforma, use uma das URLs a seguir:
* `https://api.eu.navixy.com/v2/` para a Europa
* `https://api.us.navixy.com/v2/` para a América do Norte
* `` para instalações auto-hospedadas (On-Premise). O formato padrão normalmente é `http(s)://your_configured_domain/api/`
* String de consulta: Use uma string de consulta no formato `hash=[YOUR_API_KEY]&iso_datetime=true`. Por exemplo: `hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true`.
5. Personalize quaisquer configurações adicionais conforme necessário e, em seguida, clique em **Salvar e testar** para verificar a conexão.
### Etapa 5: importar o modelo de dashboard da Navixy
Para agilizar o processo de configuração, importe o [modelo de dashboard](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) para o Grafana. Acesse a seção de gerenciamento de dashboards do Grafana, crie um novo dashboard e selecione a opção de importar o dashboard. Faça upload do arquivo de modelo de dashboard da Navixy fornecido. Revise as configurações de importação, incluindo a fonte de dados atribuída, e conclua o processo de importação.
## Analisando dados de telemetria com o Grafana
O Grafana oferece um conjunto completo de objetos e ferramentas de visualização, permitindo que profissionais de telemetria analisem e interpretem facilmente dados complexos de telemetria. Vamos analisar os principais elementos do dashboard de demonstração oferecido pela Navixy, que estão marcados em azul.
### Dispositivos e sensores para analisar
Para começar, no dashboard de demonstração, selecione o dispositivo desejado usando o **Rastreador** seletor. Depois de selecionado, você pode criar vários gráficos de linha na mesma tela escolhendo os sensores desejados nos seletores correspondentes. Selecione a opção correspondente em **Dados brutos 1** / **Dados brutos 2** menus suspensos se quiser analisar os dados brutos dos sensores.
### Intervalo de tempo
No canto superior direito, você encontrará a opção para selecionar o intervalo de datas para sua análise. Isso oferece flexibilidade para escolher entre intervalos rápidos, que fornecem intervalos de tempo predefinidos, ou um intervalo de tempo absoluto, em que você pode especificar datas de início e fim específicas.
### Gráficos de linha
O Grafana oferece uma variedade de opções poderosas de visualização e, entre elas, o gráfico de linha se destaca. Esse gráfico permite uma análise abrangente das leituras dos sensores ao longo do tempo, o que é inestimável para profissionais de telemetria. Ao plotar dados de telemetria como nível de combustível, velocidade do veículo etc. em um gráfico de linha, os usuários ganham a capacidade de identificar padrões, tendências e anomalias que podem afetar o desempenho da frota. Os recursos interativos, como zoom e deslocamento, permitem que os profissionais se aprofundem em períodos específicos, extraindo assim insights mais profundos dos dados.
### Tabelas
As tabelas do dashboard fornecem um formato estruturado e fácil de usar para explorar dados brutos dos sensores. Cada valor é acompanhado por um carimbo de data/hora, permitindo que os usuários acompanhem facilmente quando os dados foram gerados. Essa apresentação organizada facilita uma análise abrangente de pontos de dados individuais, possibilitando um exame detalhado e insights. O dashboard de demonstração da Navixy tem 2 tabelas: dados brutos do sensor por carimbos de data/hora e trajetos concluídos com detalhes.
### Mapa
As exibições de mapa do Grafana facilitam o monitoramento de objetos e eventos em um mapa, fornecendo insights valiosos sobre as localizações dos veículos e as viagens em um intervalo de tempo selecionado. Esse recurso poderoso oferece uma visualização abrangente dos movimentos anteriores dos veículos, capacitando os usuários a analisar dados históricos e desenvolver uma compreensão mais profunda das operações da frota. Complementando a representação visual, uma tabela acompanhante apresenta métricas precisas como o comprimento do trajeto e a velocidade média, aprimorando a análise geral.
## Resultado e próximos passos
A integração das APIs do Grafana e da Navixy oferece uma solução poderosa para visualizar e analisar dados de telemetria relacionados ao controle de combustível. Ao aproveitar os recursos de visualização de dados de código aberto do Grafana e a ampla API da Navixy, os usuários podem obter insights valiosos sobre o consumo de combustível da frota, monitorar eventos anormais e solucionar problemas com eficiência.
### Personalização do dashboard
Como integrador, você tem a flexibilidade de personalizar os elementos do dashboard para atender aos seus requisitos específicos. O Grafana fornece vários objetos de visualização que podem ser configurados para acessar um conjunto abrangente de dados de telemetria das APIs da Navixy. Isso inclui selecionar e configurar diversas [visualizações do Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/) para analisar séries temporais e outros tipos de dados, permitindo que você explore os dados de uma forma mais significativa. Ao utilizar dashboards personalizáveis, os usuários podem criar visualizações personalizadas que atendem às suas necessidades específicas de análise. Isso capacita os gestores de frota e as partes interessadas a monitorar o desempenho em tempo real, diagnosticar problemas e tomar decisões informadas com base nos dados analisados. A personalização do dashboard exige experiência no uso das APIs da Navixy e no trabalho com o formato JSON.
### Compartilhamento de dashboards do Grafana
Compartilhar seu dashboard personalizado com outras pessoas no Grafana é um processo tranquilo. Ao compartilhar dashboards personalizados com membros da equipe, clientes ou partes interessadas, a colaboração e a troca de conhecimento são aprimoradas. Para começar, você pode exportar seu dashboard como um arquivo JSON, que inclui todas as informações essenciais necessárias para replicar o dashboard em outra instância do Grafana. Esse recurso simplificado de compartilhamento garante que todos os envolvidos possam acessar e se beneficiar dos insights e análises do dashboard.
---
# 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/expert-center/pt-br/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md?ask=&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.