> 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 com a API do Navixy
## 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, da velocidade, da tensão ou do 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 Grafana e Navixy para recuperar e visualizar dados de controle de combustível com facilidade.
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 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 o Navixy ao Grafana de forma transparente, permitindo visualizar e analisar seus dados de telemetria de maneira eficaz.
### Etapa 1: obtendo a chave de API do Navixy
Comece fazendo login na sua conta Navixy e navegando até **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 . Abaixo, 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 na tela.
3. Depois que 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 obter instruções detalhadas adaptadas à sua configuração específica.
### Etapa 3: instalando o plugin de fonte de dados JSON API
Depois que o Grafana for iniciado, acesse o **Connections** ou **Plugins** menu na interface do Grafana. Procure o **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 Navixy.
### Etapa 4: configurando a conexão da fonte de dados JSON API
Depois de instalar o **JSON API** plugin, sua instância do Grafana estará pronta para se conectar à API Navixy usando a chave de API.
Siga estas etapas para configurar a conexão:
1. Vá para **Connections** menu no lado esquerdo
2. Procure por **JSON API** e escolha esta fonte
3. Clique **Criar uma JSON API** fonte de dados
4. Preencha os seguintes campos:
* Nome: escolha um nome de sua preferência para a fonte de dados
* URL: insira a URL da API 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 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 **Save & Test** para verificar a conexão.
### Etapa 5: importando o modelo de dashboard do Navixy
Para acelerar o processo de configuração, importe o [modelo de dashboard](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) do Navixy no Grafana. Acesse a seção de gerenciamento de dashboard do Grafana, crie um novo dashboard e selecione a opção de importar o dashboard. Faça upload do arquivo de modelo de dashboard do 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 oferece 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 nos aprofundar nos principais elementos do dashboard de demonstração oferecido pelo Navixy, que estão marcados em azul.
### Dispositivos e sensores a analisar
Para começar, no dashboard de demonstração, selecione o dispositivo desejado usando o **Tracker** seletor. Depois de selecionado, você pode criar vários gráficos de linhas na mesma tela escolhendo os sensores desejados nos seletores resultantes. Selecione os itens resultantes em **Raw Data 1** / **Raw data 2** menus suspensos se quiser analisar os dados brutos dos sensores.
### Período de tempo
No canto superior direito, você encontrará a opção de selecionar o intervalo de datas para sua análise. Isso oferece flexibilidade na escolha 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 término específicas.
### Gráficos de linhas
O Grafana oferece uma variedade de opções poderosas de visualização, e entre elas o gráfico de linhas se destaca. Esse gráfico permite uma análise abrangente das leituras dos sensores ao longo do tempo, o que se mostra 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 linhas, 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 dashboard fornecem um formato estruturado e fácil de usar para explorar os dados brutos dos sensores. Cada valor vem acompanhado de um timestamp, 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, permitindo exame detalhado e obtenção de insights. O dashboard de demonstração do Navixy tem 2 tabelas: dados brutos dos sensores por timestamps 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 dentro de um intervalo de tempo selecionado. Esse recurso poderoso oferece uma visualização abrangente dos movimentos anteriores do veículo, 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 de apoio 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 Grafana e 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 diagnosticar problemas com eficácia.
### 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 oferece vários objetos de visualização que podem ser configurados para acessar um conjunto abrangente de dados de telemetria das APIs 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 Navixy e no trabalho com o formato JSON.
### Compartilhando dashboards do Grafana
Compartilhar seu dashboard personalizado com outras pessoas no Grafana é um processo simples. 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 da análise 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 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.