connect tsdb to grafana - Time Series Database: Central de Documentação do Alibaba Cloud

Pré-requisitos

Antes de começar, verifique se você tem:

Uma instância do TSDB
Uma instância do Elastic Compute Service (ECS) na mesma Virtual Private Cloud (VPC) da instância do TSDB, com as seguintes especificações:
- SO: CentOS 7.3 de 64 bits
- Pelo menos 1 núcleo de CPU e 2 GB de memória
- Pelo menos 10 GB de armazenamento em disco disponível
Endereço IP privado da instância do ECS adicionado à lista de permissões da instância do TSDB
Regra de grupo de segurança na instância do ECS que permita tráfego de entrada na porta 3000. Consulte Criar um grupo de segurança
(Opcional) Endereço IP público na instância do ECS, caso deseje acessar o Grafana pelo navegador via internet

Para mais informações sobre o ECS, consulte O que é o ECS?

Instale o Grafana no ECS

Acesse a instância do ECS via SSH e execute o comando abaixo para instalar o Grafana:
```
sudo yum install https://dl.grafana.com/oss/release/grafana-6.2.2-1.x86_64.rpm
```
Inicie o Grafana:
```
sudo service grafana-server start
```

Para outras opções de instalação, consulte a documentação do Grafana.

Adicionar o TSDB como source de dados

Referência rápida

Configuração	Valor
Database type	OpenTSDB
URL	Endpoint privado da instância do TSDB (VPC Network Address)
Version	≥2,3
Basic Auth	Ative se o gerenciamento de usuários estiver habilitado
With Credentials	Ative se o gerenciamento de usuários estiver habilitado

Etapas

Abra um navegador e acesse http://<ECS-public-IP>:3000/. A página de login do Grafana será exibida.
Na página de login do Grafana, insira admin como nome de usuário e senha.
Crie uma nova source de dados e configure os parâmetros abaixo. Mantenha as demais configurações com os valores padrão.
- Database type: Defina como OpenTSDB.
- URL: Insira o endpoint privado da instância do TSDB. Para localizar esse endpoint, acesse a página Instance Details no console do TSDB e copie o valor de VPC Network Address em Basic Information.
- Version: Selecione ≥2.3.
- Se o gerenciamento de usuários estiver ativado na instância do TSDB, selecione Basic Auth e With Credentials e insira as credenciais de um usuário com acesso de leitura à instância.
Clique em Save & Test. Quando a mensagem Data source is working for exibida, a conexão estará estabelecida.

Crie um painel de monitoramento

As capturas de tela nesta seção mostram o Grafana 6.2. A interface pode variar em outras versões.

Na página inicial do Grafana, escolha Create > Dashboard. Se já existir um painel para a instância do TSDB, selecione-o.
Clique em New Panel e, em seguida, clique em Add Query na caixa de diálogo New Panel.
No editor do painel, configure os parâmetros da consulta:
1. Selecione a métrica a ser monitorada e especifique como agregar os valores nas séries temporais.
2. Configure uma regra de downsampling definindo os parâmetros interval, Aggregator e Fill.
3. Agrupe as séries temporais por tag. Para incluir todos os valores de uma determinada tag, insira * como valor da tag.

Compatibilidade de agregadores: O TSDB oferece suporte a um subconjunto dos agregadores disponíveis no Grafana. Consulte Consultar pontos de dados de valor único para ver a lista de agregadores compatíveis.

Consultar métricas de modelo multivalor

Para consultar uma métrica em um modelo de valor único ou multivalor, digite o nome da métrica no campo de consulta. A lista suspensa exibirá o nome da métrica.

Para visualizar todos os campos de uma métrica de modelo multivalor, digite @ após o nome da métrica. A lista suspensa mostrará todos os campos disponíveis; selecione o desejado.

O Grafana exibe apenas valores numéricos: O TSDB aceita valores numéricos, strings e booleanos. Como o Grafana renderiza apenas valores numéricos, os campos de string e booleanos não aparecem nos painéis.

grafana_multi_fields

Filtrar séries temporais com variáveis

Conforme o número de séries temporais aumenta, atualizar manualmente cada consulta de painel torna-se impraticável. As variáveis do Grafana permitem criar filtros dinâmicos aplicáveis a vários painéis. O exemplo abaixo cria uma variável para filtrar séries temporais por tag.

No painel, clique no ícone de Settings.

Na página Variables, configure a variável. Para a sintaxe completa da expressão, consulte a documentação do Grafana. Neste exemplo, a variável representa valores de tag; portanto, use uma expressão iniciada com tag_values. > Query result limit in Grafana 6.2.2 and earlier: Todas as versões do Grafana retornam um número limitado de resultados de consulta. Algumas métricas, chaves de tag ou valores de tag podem não aparecer na lista suspensa. Se isso ocorrer, refine os critérios de consulta ou aplique uma solução alternativa. Esse problema não foi corrigido na versão 6.2.2 ou anteriores.

Defina Data source como OpenTSDB.

No campo Query, insira uma expressão de consulta do Grafana para OpenTSDB. Há suporte às seguintes expressões:

Expressão	Retorno
`metrics(prefix)`	Todos os nomes de métricas que contêm o prefixo especificado (pode retornar vazio)
`tag_names(metric)`	Todas as chaves de tag para a métrica especificada
`tag_values(metric, tagKey)`	Todos os valores da chave de tag especificada para a métrica indicada
`suggest_tagk(prefix)`	Todas as chaves de tag com o prefixo especificado, em todas as métricas
`suggest_tagv(prefix)`	Todos os valores de tag com o prefixo especificado, em todas as métricas

Settings of variables

Referencie a variável em uma consulta de painel usando $<variable-name>.

Próximos passos

Para mais informações, consulte a documentação oficial do Grafana.