👣 Primeiros Passos
Acessando Gafana
Enquanto o Grafana estará disponível na porta 3000, para acessar utilize o link: http://seu_ip:3000
Nota
O nome de usuário e a senha padrão são ambos admin.
Na primeira vez que acessar, será solicitado que você crie uma nova senha para garantir a segurança do acesso.
Integrando API ao Grafana
JSON API
Com acesso ao grafana acesse o menu: Home » Connections » Data sources
Em seguida clique em [Add data source]
Procure por [JSON API] e clique sobre.
No campo URL adicione http://localhost:5000 e Timeout defina em 600
Clicque em [Save & test] mas antes de sair observe que na URL após “/edit/” temos o uid do datasource do JSON API.
Ex: http://192.168.87.28:3000/connections/datasources/edit/d686f6a48c4a
Anote em seu bloco de notas
Ex.: d686f6a48c4a
Service accounts (Token)
Agora, no menu Home » Administration » Service accounts, procederemos com a criação de um Token (API do Grafana). Essa etapa é crucial para automatizar as importações das Dashboards por meio do RR Flow.
Clique em [Add service account]
Preecha os campos Display name: RR Flow API e Role: Admin
Clique em [Add service account token]
Clique em [Generate token]
Clique em [Copy clipboard]
Anote em seu bloco de notas
Ex.: glsa_pUL0p6xJMpaY2ZaIVCClX4secEadvNNK_e835939c
Configurando RR Flow API
A API será executada na porta 5000, para acessar utilize o seguinte link: http://seu_ip:5000/login
Nota
A senha padrão é remontti
Ao acessar o painel, encontraremos os arquivos de configuração da API. Todos esses arquivos seguem o formato JSON e são altamente personalizáveis, oferecendo uma ampla flexibilidade para atender a várias necessidades de customização.
Começe editanto o config.json
Anterior mente anotamos Service accounts exemplo d686f6a48c4a e o uid da JSON API exemplo glsa_pUL0p6xJMpaY2ZaIVCClX4secEadvNNK_e835939c
Ajuste service_token e datasources com suas anotações obtidas acima:
"grafana": [
{
"datasources": "d686f6a48c4a",
"service_token": "glsa_pUL0p6xJMpaY2ZaIVCClX4secEadvNNK_e835939c",
"url": "http://localhost:3000"
}
],
Clique em [Salvar], [Voltar], [Serviços] e [Reiniciar API]
OBS
Sempre que o arquivo config.json for modificado, é necessário reiniciar o serviço para que as alterações tenham efeito.
Você pode reiniciar também pelo terminal com o comando: systemctl restart rr-flow-api.service
Importando as Dashboards
Você tem a opção de instalar ou atualizar todas as dashboards de uma única vez clicando no botão [Remover e Reinstalar Todas]. Além disso, é possível instalar as dashboards individualmente ou excluí-las conforme necessário.
Cuidado
Se o Grafana estiver em um servidor externo, NÃO me responsabilizo por qualquer remoção acidental de outras dashboards. Recomendo instalar cada dashboard individualmente para evitar perdas indesejadas, ou utilizar o grafana da instalação do RR Flow API.
A partir da versão 1.4.0, apenas as Dashboards com as seguintes TAGs serão removidas:
RR-FLOW-M RR-FLOW RR-INFO RR-FLOW-HOME RR FLOW
Clique em [Grafana] e [Remover e Reinstalar Todas]
Para acessar suas configurações, clique no canto superior direito onde se encontra o seu nome de usuário e selecione [Profile].
Em seguida, defina Home Dashboard para General/Home e clique em [Salvar].
Agora, na sua página inicial, você terá acesso a todas as Dashboards disponíveis.
Adicione seu 1º fluxo
Faça uma leitura da estrutura do config.json para ender seu contexto geral.
Em seguida, prossiga com o 1º source_path e defina as configurações de integração com o seu roteador.
Após integrado seu roteador, reinicie a API.
Importando os Dados SNMP
Documentação: interfaces.json
Para obter os dados de interface clique no botão [Obter dados SNMP] em seguida clique no botão [Obter dados de interfaces]
Documentação: peers.json
Aproveite e faça também para o [Obter dados de Peers]