Análise de dados de combustível com Grafana via integração 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 parâmetros relacionados. Essa análise pode envolver examinar nível de combustível, velocidade, voltagem ou estado da ignição ao longo de intervalos de tempo específicos e áreas no mapa para identificar quaisquer eventos anormais. Também pode fornecer informações sobre configurações de sensores, diagnosticar problemas e monitorar o desempenho em tempo real. Neste artigo, exploraremos como integrar Grafana e as APIs da 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. Pode ser facilmente instalada e configurada até mesmo em seu PC ou laptop. O processo de instalação normalmente leva cerca de 30 minutos.
Conectando Navixy ao Grafana
Ao seguir este guia passo a passo, você poderá integrar Navixy ao Grafana de forma contínua, possibilitando visualizar e analisar seus dados telemáticos de maneira eficaz.
Passo 1: Obtenção da chave de API da Navixy
Comece fazendo login na sua conta Navixy e navegando até as Configurações da Conta. Dentro das configurações, localize a seção de chaves de API e gere uma chave de API única. Essa chave, como "8f6a4353bc5114d97e2068b4e398", será usada para autenticar a conexão entre Navixy e o Grafana.
Passo 2: Inicializando o Grafana
O Grafana fornece 2 tipos de acesso: em nuvem ou implantado. O acesso em nuvem pode ser obtido no site oficial https://grafana.com/. 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 estes passos simples:
Baixe o instalador mais recente do Grafana para Windows na página oficial de downloads.
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.
Após a conclusão da instalação, 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).
Abra um navegador e navegue para http://localhost:3000. Use as credenciais de login padrão "admin" tanto para o nome de usuário quanto para a senha.
Após efetuar 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 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.
Passo 3: Instalando o plugin de fonte de dados JSON API
Uma vez que o Grafana esteja iniciado, acesse o menu "Connections" ou "Plugins" na interface do Grafana. Procure o 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.
Passo 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 com a API da Navixy usando a chave de API.
Siga estes passos para configurar a conexão:
Vá ao menu "Connections" no lado esquerdo
Pesquise por "JSON API" e escolha essa fonte
Clique em "Create a JSON API data source"
Preencha os seguintes campos:
Name: Escolha um nome preferido 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 Europahttps://api.us.navixy.com/v2/para a América do Norte<your_configured_domain_api_url>para instalações self-hosted (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.
Personalize quaisquer configurações adicionais conforme necessário e, em seguida, clique em "Save & Test" para verificar a conexão.
Passo 5: Importando o template de dashboard da Navixy
Para agilizar o processo de configuração, importe o template de dashboard da Navixy 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 o upload do arquivo do template de dashboard fornecido pela Navixy. Revise as configurações de importação, incluindo a fonte de dados atribuída, e conclua o processo de importação.
Analisando dados telemáticos com o Grafana
O Grafana fornece um conjunto completo de objetos de visualização e ferramentas, permitindo que profissionais de telemática analisem e interpretem dados complexos de forma descomplicada. Vamos aprofundar os principais elementos do dashboard de demonstração oferecido pela Navixy que estão marcados em azul.
Rastreadores e sensores para analisar
Para começar, no dashboard demonstrativo, selecione o dispositivo desejado usando o seletor "Tracker". Uma vez selecionado, você pode criar múltiplos gráficos de linha no mesmo painel escolhendo os sensores desejados nos seletores "Sensor 1" e "Sensor 2". Selecione “True” nos menus suspensos “Raw Data 1” / “Raw data 2” se desejar 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 entre intervalos rápidos, que fornecem períodos de tempo predefinidos, ou um intervalo de tempo absoluto, onde você pode especificar datas de início e fim específicas.
Gráficos de linha
O Grafana oferece uma gama 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 se mostra inestimável para profissionais de telemática. Ao traçar dados telemáticos 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 panorâmica, permitem que os profissionais se aprofundem em períodos específicos, extraindo assim insights mais detalhados dos dados.
Tabelas
As tabelas do dashboard fornecem um formato estruturado e amigável para explorar dados brutos de 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 dashboard de demonstração da Navixy possui 2 tabelas: Dados brutos do sensor por carimbos de data/hora e Tracks concluídos com detalhes.
Visualização no mapa
As exibições de mapa do Grafana facilitam o monitoramento de objetos e eventos em um mapa, proporcionando insights valiosos sobre localizações de veículos e viagens dentro de um intervalo de tempo selecionado. Esse recurso poderoso fornece uma visualização abrangente dos movimentos anteriores dos veículos, permitindo que os usuários analisem dados históricos e desenvolvam uma compreensão mais profunda das operações da frota. Complementando a representação visual, uma tabela acompanhante apresenta métricas precisas, como comprimento da viagem e velocidade média, aprimorando a análise geral.
Resultado e próximos passos
A integração do Grafana com as APIs da Navixy oferece uma solução poderosa para visualizar e analisar dados telemáticos relacionados ao controle de combustível. Ao aproveitar as capacidades de visualização de dados de código aberto do Grafana e a extensa API da Navixy, os usuários podem obter insights valiosos sobre o consumo de combustível da frota, monitorar eventos anormais e solucionar problemas de forma eficaz.
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 diversos objetos de visualização que podem ser configurados para acessar um conjunto abrangente de dados telemáticos das APIs da Navixy. Isso inclui selecionar e configurar diversas visualizações do Grafana para analisar séries temporais e outros tipos de dados, permitindo que você explore os dados de maneira mais significativa. Ao utilizar dashboards 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 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.
Compartilhando dashboards do Grafana
Compartilhar seu dashboard personalizado com outras pessoas no Grafana é um processo simples. Ao compartilhar dashboards customizados 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 de compartilhamento simplificado garante que todos os envolvidos possam acessar e se beneficiar das percepções e análises do dashboard.
Atualizado
Isto foi útil?