# Análise de dados de combustível com Grafana por meio da integração da API do Navixy
## 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 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 intervalos de tempo específicos e áreas no mapa para identificar quaisquer eventos anormais. Ela também pode fornecer insights sobre configurações de sensores, diagnosticar problemas e monitorar o desempenho em tempo real. Neste artigo, exploraremos 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 facilmente instalado e configurado até mesmo em seu PC ou laptop. O processo de instalação normalmente leva cerca de 30 minutos.
## Conectando Navixy com o Grafana
Seguindo este guia passo a passo, você pode integrar perfeitamente a Navixy ao Grafana, permitindo visualizar e analisar seus dados de telemetria com eficiência.
### Etapa 1: Obtendo a chave da API da Navixy
Comece fazendo login em sua conta da Navixy e acessando as configurações da conta. Nas configurações, localize a seção de chaves da API e gere uma chave de API exclusiva. Esta chave, como `"8f6a4353bc5114d97e2068b4e398"`, será usada para autenticar a conexão entre a Navixy e o Grafana.
### Etapa 2: Iniciando o Grafana
O Grafana oferece 2 tipos de acesso: na nuvem ou implantado. O acesso na nuvem pode ser obtido em seu site oficial . A seguir, vamos explorar como instalar o pacote em 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, onde xx.x.x é o número da versão) e conclua a instalação seguindo as instruções.
3. Assim 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. Após fazer login, você pode começar imediatamente a criar e personalizar painéis, utilizando diversas 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: Instalando o plugin de fonte de dados JSON API
Depois que o Grafana for iniciado, acesse o menu "Connections" ou "Plugins" na interface do Grafana. Procure pelo plugin de fonte de dados "JSON API" e selecione-o. Instale o plugin seguindo as instruções fornecidas. Este 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 plugin "JSON API", sua instância do Grafana estará pronta para se conectar à API da Navixy usando a chave da API.
Siga estas etapas para configurar a conexão:
1. Vá para o menu "Connections" no lado esquerdo
2. Procure por "JSON API" e escolha esta fonte
3. Clique em "Create a JSON API data source"
4. Preencha os seguintes campos:
* Name: 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 auto-hospedadas (On-Premise). O formato padrão geralmente é `http(s)://your_configured_domain/api/`
* Query string: 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 [modelo de painel](https://github.com/SquareGPS/bi-intergrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) da Navixy para o 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. Faça upload do 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 o 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 nos aprofundar nos principais elementos do painel de demonstração oferecido pela Navixy, destacados em azul.
### Rastreadores e sensores para análise
Para começar, no painel de demonstração, selecione o dispositivo desejado usando o seletor "Tracker". Depois de selecionado, você pode criar vários gráficos de linha na mesma área de trabalho escolhendo os sensores desejados nos seletores "Sensor 1" e "Sensor 2". Selecione “True” nos menus suspensos “Raw Data 1” / “Raw data 2” 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 sua análise. Isso lhe dá flexibilidade para escolher entre intervalos rápidos, que fornecem períodos de tempo predefinidos, ou um intervalo de tempo absoluto, no qual você pode especificar datas de início e término específicas.
### Gráficos de linha
O Grafana oferece uma gama 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 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 linha, os usuários ganham a capacidade de identificar padrões, tendências e anomalias que possam 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 painel fornecem um formato estruturado e fácil de usar para explorar dados brutos de sensores. Cada valor é acompanhado de um carimbo de data e 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, permitindo exame detalhado e insights. O painel de demonstração da Navixy possui 2 tabelas: dados brutos do sensor por carimbos de data e hora e trajetos concluídos com detalhes.
### Visualização do mapa
Os painéis de mapa do Grafana permitem o monitoramento de objetos e eventos em um mapa, fornecendo insights valiosos sobre a localização 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 acompanhada apresenta métricas precisas como duração da viagem e velocidade média, aprimorando a análise geral.
## Resultado e próximas etapas
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 diagnosticar problemas com eficiência.
### Personalização do painel
Como integrador, você tem a flexibilidade de personalizar os elementos do painel 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 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 painéis personalizáveis, os usuários podem criar visualizações personalizadas que atendam às suas necessidades específicas de análise. Isso capacita gerentes de frota e 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 requer 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 o compartilhamento de conhecimento são aprimorados. 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 simplificado de compartilhamento garante que todos os envolvidos possam acessar e se beneficiar dos insights e da análise do painel.
---
# Agent Instructions: 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:
```
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=
```
The question should be specific, self-contained, and written in natural language.
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.