Ferramentas de cliente do InfluxDB, como o InfluxDB Studio, geralmente suportam apenas versões anteriores a 1.8. Para operar o InfluxDB de forma mais eficaz, é essencial usar a interface Web integrada. O endereço de acesso local é: http://localhost:8086
Página Inicial
Principais funcionalidades:
- Data: Módulo de carregamento de dados (Load Data), que inclui gerenciamento de buckets de retenção, importação de arquivos, configuração do Telegraf, tarefas de coleta ativa e geração de tokens de acesso.
- Explore: Módulo de consulta de dados (Data Explore), permitindo consultas por meio da linguagem Flux ou seleção de condições, com múltiplos formatos de exibição de resultados.
- Books: Módulo de processamento de fluxos de trabalho (Notebooks), que facilita operações como amostragem, limpeza de dados ou escrita de volta em buckets por meio de componentes desenvolvidos, documentação e execução de código.
- Tasks: Módulo de gerenciamento de tarefas agendadas (Tasks), para supervisionar tarefas criadas.
Load Data (Carregamento de Dados)
Sources (Upload de Arquivos)
É possível fazer upload de dados por meio de arquivos, desde que estejam em formatos suportados pelo InfluxDB, como CSV, CSV anotado com Flux ou o protocolo de linhas do InfluxDB.
Dados CSV
Pode ser usado para criar informações de buckets de retenção.
CSV Anotado com Flux
Selecione um bucket de retenção e faça upload de um arquivo de dados estruturado em Flux para importação.
Protocolo de Linhas
Selecione um bucket de retenção e faça upload de um arquivo no formato de linhas do InfluxDB para importação. A precisão temporal inclui: nanossegundos, microssegundos, milissegundos e segundos.
usuarios,nome=carlos idade=30
usuarios,nome=ana idade=28
usuarios,nome=pedro idade=35
usuarios,nome=maria idade=22
usuarios,nome=lucas idade=27
O formato mostrado é o protocolo de linhas do InfluxDB. Após salvar, uma mensagem de confirmação indica que os dados foram adicionados com sucesso.
Bibliotecas de Clientes
A seção Sources também oferece exemplos de código em diversas linguagens para integração.
Buckets (Buckets de Retenção)
No InfluxDB, os buckets são comparáveis a bancos de dados em sistemas relacionais como o MySQL.
Criar um Bucket
Clique no botão "Create Bucket" no canto superior direito para adicionar um novo. Existem duas políticas: Never (nunca excluir dados) ou Older Than (excluir dados mais antigos que um intervalo especificado em dias ou horas).
Excluir um Bucket
Ao passar o mouse sobre o bucket desejado, um ícone de exclusão aparece.
Editar um Bucket
Por meio de "Setting", é possível alterar configurações, incluindo renomeação (não recomendado, pois pode causar problemas).
Adicionar Dados
A opção de upload de arquivos também está disponível aqui, conforme mencionado anteriormente.
Telegraf (Configuração de Coleta de Dados)
O Telegraf é um software de coleta de dados. Esta página permite gerar arquivos de configuração do Telegraf e APIs de acesso. Após baixar o Telegraf, use a API fornecida para coletar dados específicos e armazená-los em buckets do InfluxDB.
Tutorial de configuração do Telegraf com InfluxDB para monitoramento de serviços.
Scrapers (Tarefas de Coleta)
Forneça uma URL para o InfluxDB acessar periodicamente, importando os dados obtidos. No InfluxDB 1.x, isso era feito apenas pelo Telegraf. No 2.x, há uma função integrada de scraping (menos personalizável, com intervalo fixo de 10 segundos). A URL alvo deve expor dados no formato Prometheus.
Até a versão atual (2.4), o intervalo de coleta não é personalizável. O InfluxDB realiza a coleta a cada 10 segundos, o que é importante observar.
Formato Prometheus
## nome da métrica
## nome do rótulo
## valor do rótulo
<nome da="" m="">{<nome do="" r="">=<valor do="" r="">, ...}</valor></nome></nome>
Exemplo:
temperatura_cpu{nucleo="0",modo="ocioso"}
temperatura_cpu{nucleo="0",modo="espera_io"}
temperatura_cpu{nucleo="0",modo="irq"}
temperatura_cpu{nucleo="0",modo="nice"}
temperatura_cpu{nucleo="0",modo="softirq"}
temperatura_cpu{nucleo="0",modo="roubo"}
temperatura_cpu{nucleo="0",modo="sistema"}
temperatura_cpu{nucleo="0",modo="usuario"}
API Tokens (Tokens de Acesso)
No InfluxDB, o gerenciamento de permissões é baseado em tokens de API. O cliente inclui o token no cabeçalho HTTP, e o servidor InfluxDB verifica as permissões para leitura/escrita em buckets, exclusão, criação de painéis, etc. Ferramentas de linha de comando também usam tokens, pois encapsulam requisições HTTP.
Posicione o mouse sobre o nome do token para ver opções de edição (ícone de lápis) e exclusão. O status "Active" indica se o token está ativo. Clique no nome do token para visualizar seu escopo de permissões.
Criar um Novo Token
Clique no botão "Criar Token" à direita. Há duas opções: Read/Write API Token (permissões de leitura/escrita) ou All Access API Token (permissões máximas).
Data Explorer (Consulta de Dados)
Página de operações para explorar e consultar dados armazenados.
Exemplo de consulta rápida e visualização dos dados brutos.
Salvar como tarefa agendada: Use o botão "Save As" no canto superior direito e selecione "Task" para transformar a consulta em uma tarefa agendada. Tasks são scripts escritos em Flux com capacidades de E/S, como comunicação via HTTP e escrita de dados de volta no InfluxDB. Cenários comuns incluem verificação de dados e alertas (notificação externa se os dados não atenderem a critérios) e operações de agregação (calcular dados em janelas e escrevê-los de volta para reduzir I/O em painéis de BI, embora aumente a carga no InfluxDB).
Notebooks (Processamento de Fluxos de Trabalho)
Página de operações para criar e gerenciar fluxos de trabalho.
Entenda cada Notebook como um fluxo de trabalho, por exemplo: consultar dados com condições específicas, extrair pontos temporais e armazenar os resultados em um bucket. Sem Notebooks, seria necessário consultas manuais e uploads, o que é trabalhoso. Notebooks automatizam esse processo com etapas configuráveis.
Exemplo: Clique em executar para salvar e rodar o fluxo de trabalho. Notebooks permitem materializar operações passo a passo, facilitando reutilização.
Tasks (Gerenciamento de Tarefas Agendadas)
Página de operações para visualizar e gerenciar tarefas agednadas criadas, por exemplo, a partir do Data Explorer. Oferece opções para modificar, excluir ou executar tarefas manualmente.