> 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 se deparam com 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, da velocidade, da tensão ou do status da ignição em intervalos de tempo específicos e em á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 dados de controle de combustível com facilidade.
O 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. Ele pode ser instalado e configurado facilmente até mesmo no seu PC ou notebook. O processo de instalação normalmente leva cerca de 30 minutos.
## Conectando Navixy com Grafana
Seguindo este guia passo a passo, você pode integrar perfeitamente a Navixy com o Grafana, permitindo visualizar e analisar seus dados de telemetria de forma eficaz.
### Etapa 1: obtendo 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 Navixy e Grafana.
### Etapa 2: iniciando 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 exibidas.
3. Quando a instalação estiver 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 web e acesse [http://localhost:3000](http://localhost:3000/). Use as credenciais padrão de login "admin" tanto para o nome de usuário quanto para a senha.
5. Após 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 no 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: instalando o plugin de Fonte de Dados JSON API
Quando o Grafana for iniciado, prossiga para o **Connections** Ou **Plugins** menu na interface do Grafana. Procure por **JSON API** plugin de Fonte de Dados 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.
### Etapa 4: configurando a conexão da Fonte de Dados JSON API
Após 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 **Connections** menu no lado esquerdo
2. Procure por **JSON API** e escolha essa fonte
3. Clique em **Crie uma** Fonte de Dados JSON API
4. Preencha os seguintes campos:
* 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 seguintes URLs:
* `https://api.eu.navixy.com/v2/` para a Europa
* `https://api.us.navixy.com/v2/` para a América do Norte
* `` para instalações autohospedadas (On-Premise). O formato padrão geralmente é `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 **Save & Test** para verificar a conexão.
### Etapa 5: importando o modelo de painel da Navixy
Para agilizar o processo de configuração, importe o Navixy [modelo de painel](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) no Grafana. Acesse a seção de gerenciamento de painéis do Grafana, crie um novo painel e selecione a opção de importar o painel. Envie o arquivo de modelo de painel 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 Grafana
O Grafana fornece um conjunto completo de objetos e ferramentas de visualização, permitindo que profissionais de telemetria analisem e interpretem com facilidade dados complexos de telemetria. Vamos explorar os principais elementos do painel de demonstração oferecido pela Navixy, marcados em azul.
### Dispositivos e sensores para análise
Para começar, no painel de demonstração, selecione o dispositivo desejado usando o **Tracker** seletor. Depois de selecionado, você pode criar vários gráficos de linha na mesma área escolhendo os sensores desejados nos seletores resultantes. Selecione **Raw Data 1** / **Raw Data 2** nos menus suspensos se quiser analisar os dados brutos dos sensores.
### Intervalo de tempo
No canto superior direito, você encontrará a opção de selecionar o intervalo de datas para a sua análise. Isso lhe dá 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 de visualização poderosas 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 é extremamente valioso 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 possam impactar o desempenho da frota. Os recursos interativos, como zoom e deslocamento, permitem que os profissionais se aprofundem em períodos de tempo específicos, extraindo assim insights mais profundos dos dados.
### Tabelas
As tabelas do painel 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 exame detalhado e insights. O painel de demonstração da Navixy tem 2 tabelas: dados brutos dos sensores por carimbo de data/hora e trajetos concluídos com detalhes.
### Mapa
As visualizaçõ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. Como complemento à representação visual, uma tabela associada apresenta métricas precisas como a duração 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 API abrangente da Navixy, os usuários podem obter insights valiosos sobre o consumo de combustível da frota, monitorar eventos anormais e diagnosticar problemas com eficácia.
### Personalização do painel
Como integrador, você tem flexibilidade para personalizar os elementos do painel de acordo com seus requisitos específicos. O Grafana oferece 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 maneira mais significativa. Ao utilizar painéis personalizáveis, os usuários podem criar visualizações personalizadas que atendem às suas necessidades específicas de análise. Isso capacita os gerentes 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 painel exige experiência no uso das APIs da Navixy e no trabalho com o formato JSON.
### Compartilhando painéis do Grafana
Compartilhar seu painel personalizado com outras pessoas no Grafana é um processo simples. Ao compartilhar painéis personalizados com membros da equipe, clientes ou partes interessadas, a colaboração e a troca de conhecimento são ampliadas. Para começar, você pode exportar seu painel como um arquivo JSON, que inclui todas as informações essenciais necessárias para replicar o painel em outra instância do Grafana. Esse recurso de compartilhamento simplificado garante que todos os envolvidos possam acessar e se beneficiar dos insights e da análise do painel.
---
# 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/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 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.