Tablestore:Conectar ao Grafana

Pré-requisitos

• Você já criou um usuário do Resource Access Management (RAM) e concedeu a permissão AliyunOTSFullAccess ao usuário RAM para gerenciar o Tablestore.

  Aviso

  Se o par de AccessKey da sua conta Alibaba Cloud for comprometido, seus recursos na nuvem ficarão em risco. Use o par de AccessKey de um usuário RAM para reduzir esse risco.

• Ative o serviço Tablestore e crie uma instância. Em seguida, crie uma tabela de dados e seu relacionamento de mapeamento, ou crie uma tabela de séries temporais e seu relacionamento de mapeamento de modelo de múltiplos valores.

• Instale o Grafana open source versão 8.0.0 ou posterior. Este guia usa o Grafana v12.3.1 como exemplo. Para mais informações sobre a instalação do Grafana, consulte a documentação oficial do Grafana.

Informações gerais

O Grafana é uma plataforma open source de visualização e análise que permite consultar e visualizar dados de diversas fontes, como Prometheus, Graphite, OpenTSDB, InfluxDB, Elasticsearch, MySQL e PostgreSQL. Para mais detalhes, consulte a documentação oficial do Grafana.

Ao conectar o Tablestore ao Grafana, você pode gerar painéis com base nos dados das tabelas do Tablestore e exibi-los em tempo real.

Notas de uso

As regiões compatíveis com o recurso de visualização do Grafana dependem do modelo de dados usado.

• Modelo de tabela ampla: compatível com todas as regiões.

• Modelo de séries temporais: compatível com China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japão (Tóquio), Singapura, Malásia (Kuala Lumpur), Indonésia (Jacarta), Alemanha (Frankfurt), Reino Unido (Londres), EUA (Vale do Silício), EUA (Virgínia) e Arábia Saudita (Riade - Região Parceira).

Etapa 1: Instalar o plug-in do Tablestore

Etapa 2: Configurar uma fonte de dados

1. Faça login no Grafana.

   1. Em um navegador, insira http://<x.x.x.x>:3000/ para abrir a página de login do Grafana.

      Nota

      <x.x.x.x> especifica o endereço IP do servidor onde o Grafana está instalado. Por exemplo, se o Grafana estiver instalado no Windows, o endereço de login será http://localhost:3000.

   2. Insira seu Email or username e Password e clique em Log in.

      Nota

      O nome de usuário e a senha padrão são ambos admin. Ao fazer login pela primeira vez, o sistema solicitará a alteração da senha.

2. No painel de navegação à esquerda do Grafana, escolha Connections > Data sources.

3. Na página Data sources, clique em + Add new data source.

4. Na página Add data source, na seção Others, clique em aliyun-tablestore-grafana-datasource.

5. Na aba Settings, configure os parâmetros conforme descrito na tabela a seguir.

   Parâmetro	Exemplo	Descrição
   Name	aliyun-tablestore-grafana-datasource	Nome da fonte de dados. Insira um nome personalizado, se necessário. O valor padrão é aliyun-tablestore-grafana-datasource.
   Default		Define a fonte de dados do Tablestore como a fonte de dados padrão.
   Endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	Insira o endpoint da instância do Tablestore que você deseja acessar.
   Instance	myinstance	Nome da instância do Tablestore.
   AccessId	****	O AccessKey ID da conta Alibaba Cloud ou do usuário RAM com permissões para acessar o Tablestore.
   AccessKey	**	O AccessKey secret da conta Alibaba Cloud ou do usuário RAM com permissões para acessar o Tablestore.

6. Clique em Save & test.

   Após a conexão ser estabelecida com sucesso, a interface exibirá a mensagem Data source is working.

   

Etapa 3: Criar um painel

1. No painel de navegação à esquerda do Grafana, clique em Dashboards.

2. Na página Dashboards, clique em New e selecione New dashboard.

   

3. Na página New dashboard, clique em + Add visualization.

4. Na caixa de diálogo Select data source, selecione a fonte de dados do Tablestore configurada.

   

5. Na página Edit panel, configure as condições de consulta na aba Queries.

   A tabela a seguir descreve os parâmetros.

   Parâmetro	Exemplo	Descrição
   Query	SELECT * FROM your_table WHERE $__unixMicroTimeRangeFilter(_time)AND _m_name = "your_measurement" AND tag_value_at(_tags, "your_tag")="your_tag_value" LIMIT 1000	Instrução de consulta SQL. Para mais informações, consulte Consultar dados. Importante Na cláusula WHERE, use uma macro predefinida para filtrar dados por intervalo de tempo, como $__unixMicroTimeRangeFilter no exemplo. Para ver mais macros de tempo, clique em "Show Help" na página de configuração. Para exibir dados em um gráfico de séries temporais, a consulta deve retornar uma coluna de tempo representada por um carimbo de data/hora numérico. Configure também o nome da coluna de tempo.
   Format As	Timeseries	Formato dos resultados. Valores válidos: Timeseries (Padrão): gráfico padrão de séries temporais. FlowGraph: gráfico multidimensional. Table: tabela padrão. Nota Se os dados da tabela não possuírem uma coluna de tempo ao consultá-los em um modelo de tabela ampla usando SQL, clique em Switch to table para exibir os resultados da consulta em formato de tabela ou clique em Open visualization suggestions para visualizar e selecionar opções adicionais de visualização recomendadas.
   Time Column	_time	Nome da coluna de tempo nos dados retornados. A coluna de tempo é usada como eixo x do gráfico de séries temporais. Este parâmetro fica disponível quando você define Format As como Timeseries ou FlowGraph.
   Aggregation Column	_field_name#:#_double_value	Converte várias linhas de dados de coluna única no mesmo ponto no tempo em uma única linha de dados de múltiplas colunas. Use este parâmetro para converter dados do modelo de valor único em dados do modelo de múltiplos valores. Os dados no modelo de valor único são os resultados obtidos ao usar SQL para consultar uma tabela de séries temporais no Tablestore. Este parâmetro fica disponível quando você define Format As como FlowGraph. O formato é <Coluna do nome do ponto de dados>#:#<Coluna de valor>.

6. Clique em Run SQL para executar a instrução SQL e visualizar ou depurar os resultados.

7. Configure e salve o painel.

   1. No painel à direita, especifique o nome, o tipo e o estilo de exibição do gráfico de monitoramento.

      

   2. No canto superior direito, clique em Save dashboard. Na caixa de diálogo Save dashboard, especifique o Title, Description e Folder do painel. Em seguida, clique em Save.

   3. No canto superior direito, clique em Save dashboard. Na caixa de diálogo Save dashboard, clique em Save.

Etapa 4: Visualizar dados de monitoramento

No painel de navegação à esquerda do Grafana, escolha Dashboards. Clique no painel na pasta de destino para visualizar todos os gráficos de monitoramento.