Após conectar o Tablestore ao Grafana, use o Grafana para visualizar os dados do Tablestore.
Pré-requisitos
-
Você criou um usuário do Resource Access Management (RAM) e concedeu a permissão AliyunOTSFullAccess ao usuário RAM para gerenciar o Tablestore.
AvisoSe o par de AccessKey da sua conta Alibaba Cloud for exposto, seus recursos cloud ficarão vulneráveis. Para reduzir esse risco, use o par de AccessKey de um usuário RAM.
Ative o serviço Tablestore e crie uma instância. Em seguida, crie uma tabela de dados e seu respectivo relacionamento de mapeamento, ou crie uma tabela de séries temporais e seu respectivo relacionamento de mapeamento do modelo de valor múltiplo.
-
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 básicas
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 informações, consulte a documentação oficial do Grafana.
Ao conectar o Tablestore ao Grafana, você pode gerar painéis de dashboard baseados nos dados das tabelas do Tablestore e exibi-los em tempo real.
Observações de uso
As regiões que suportam o recurso de visualização do Grafana variam conforme o modelo de dados utilizado.
Modelo de tabela ampla: compatível com todas as regiões.
Modelo de séries temporais: disponível em China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Germany (Frankfurt), UK (London), US (Silicon Valley), US (Virginia) e SAU (Riyadh - Partner Region).
Etapa 1: Instalar o plug-in do Tablestore
Windows
Descompacte o pacote do plug-in do Tablestore para Grafana e mova seu conteúdo para o diretório data/plugins da sua instalação do Grafana.
-
Modifique o arquivo de configuração do Grafana.
Abra o arquivo de configuração defaults.ini, localizado no diretório conf do plug-in do Grafana, com um editor de texto.
-
Na seção [plugins] do arquivo de configuração, defina o parâmetro allow_loading_unsigned_plugins.
allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
Reinicie o processo grafana-server.exe no Gerenciador de Tarefas.
Mac/Linux
-
Execute o comando abaixo para baixar o pacote do plug-in do Tablestore para Grafana.
wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260203/qbqmxg/aliyun-tablestore-grafana-datasource-adapt-react.zip -
Descompacte o pacote do plug-in do Tablestore para Grafana no diretório de plug-ins do Grafana.
Execute o comando correspondente ao método de instalação do seu Grafana.
Se você instalou o Grafana via repositório Yellowdog Updater, Modified (YUM) ou pacote RPM Package Manager (RPM) (apenas Linux): unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d /var/lib/grafana/plugins
-
Se você instalou o Grafana a partir de um arquivo .zip: unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d {PATH_TO}/grafana-{VERSION}/data/plugins
NotaNo comando,
{PATH_TO}/grafana-{VERSION}indica o caminho de instalação do Grafana, e{VERSION}representa o número da versão do Grafana.
-
Modifique o arquivo de configuração do Grafana.
-
Acesse o diretório e abra o arquivo de configuração.
Se você instalou o Grafana via repositório YUM ou pacote RPM (apenas Linux): /etc/grafana/grafana.ini
-
Se você instalou o Grafana a partir de um arquivo .zip: {PATH_TO}/grafana-{VERSION}/conf/defaults.ini
NotaNo caminho,
{PATH_TO}/grafana-{VERSION}corresponde ao diretório de instalação do Grafana, e{VERSION}indica o número da versão do Grafana.
-
Na seção [plugins] do arquivo de configuração, defina o parâmetro allow_loading_unsigned_plugins.
allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
-
-
Reinicie o Grafana.
Execute o comando kill para encerrar o processo do Grafana.
-
Execute o comando adequado ao seu método de instalação para iniciar o Grafana.
Se você instalou o Grafana via repositório YUM ou pacote RPM (apenas Linux): systemctl restart grafana-server
Se você instalou o Grafana a partir de um arquivo .zip: ./bin/grafana-server web
Etapa 2: Configurar uma fonte de dados
-
Faça login no Grafana.
-
No navegador, insira
http://<x.x.x.x>:3000/para acessar a página de login do Grafana.Nota<x.x.x.x>representa 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. -
Insira seu Email or username e Password, e clique em Log in.
NotaO nome de usuário e a senha padrão são ambos admin. No primeiro acesso, o sistema solicitará a alteração da senha.
-
No painel de navegação à esquerda do Grafana, escolha .
Na página Data sources, clique em + Add new data source.
Na página Add data source, na seção Others, clique em aliyun-tablestore-grafana-datasource.
-
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
****
AccessKey ID da conta Alibaba Cloud ou do usuário RAM com permissões para acessar o Tablestore.
AccessKey
**
AccessKey secret da conta Alibaba Cloud ou do usuário RAM com permissões para acessar o Tablestore.
-
Clique em Save & test.
Se a conexão for bem-sucedida, a interface exibirá a mensagem Data source is working.
Etapa 3: Criar um painel de dashboard
No painel de navegação à esquerda do Grafana, clique em Dashboards.
Na página Dashboards, clique em New e selecione New dashboard.
Na página New dashboard, clique em + Add visualization.
Na caixa de diálogo Select data source, selecione a fonte de dados do Tablestore configurada anteriormente.
-
Na página Edit panel, configure as condições de consulta na aba Queries.
A tabela abaixo descreve os parâmetros disponíveis.
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 1000Instrução de consulta SQL. Para mais informações, consulte Consultar dados.
Importante-
Na cláusula WHERE, é obrigatório usar uma macro predefinida para filtrar dados por intervalo de tempo, como
$__unixMicroTimeRangeFilterno exemplo. Para ver outras 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. Além disso, configure o nome dessa 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.
NotaSe os dados da tabela não possuírem uma coluna de tempo ao consultar um modelo de tabela ampla via SQL, clique em Switch to table para exibir os resultados em formato de tabela, ou clique em Open visualization suggestions para visualizar e selecionar outras opções de visualização recomendadas.
Time Column
_time
Nome da coluna de tempo nos dados retornados. Essa coluna funciona como o 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 temporal em uma única linha com múltiplas colunas. Utilizado para transformar dados do modelo de valor único em dados do modelo de valor múltiplo. Os dados de valor único correspondem aos resultados obtidos ao consultar uma tabela de séries temporais no Tablestore usando SQL. Este parâmetro está disponível quando você define Format As como FlowGraph. O formato é
<Coluna do nome do ponto de dados>#:#<Coluna de valor>. -
Clique em Run SQL para executar a instrução SQL e visualizar ou depurar os resultados.
-
Configure e salve o painel do dashboard.
No painel à direita, especifique o nome, o tipo e o estilo de exibição do gráfico de monitoramento.
No canto superior direito, clique em Save dashboard. Na caixa de diálogo Save dashboard, preencha Title, Description e Folder do dashboard. Em seguida, clique em Save.
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 dashboard dentro da pasta desejada para visualizar todos os seus gráficos de monitoramento.