Todos os produtos
Search
Central de documentação

Tablestore:Conectar ao Grafana

Última atualização: Sep 06, 2026

Após conectar o Tablestore ao Grafana, use o Grafana para visualizar os dados do Tablestore.

Pré-requisitos

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

  1. Baixe o pacote do plug-in do Tablestore para Grafana.

  2. 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.

  3. Modifique o arquivo de configuração do Grafana.

    1. Abra o arquivo de configuração defaults.ini, localizado no diretório conf do plug-in do Grafana, com um editor de texto.

    2. 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'
  4. Reinicie o processo grafana-server.exe no Gerenciador de Tarefas.

Mac/Linux

  1. 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
  2. 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

      Nota

      No comando, {PATH_TO}/grafana-{VERSION} indica o caminho de instalação do Grafana, e {VERSION} representa o número da versão do Grafana.

  3. Modifique o arquivo de configuração do Grafana.

    1. 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

        Nota

        No 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.

    2. 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'
  4. Reinicie o Grafana.

    1. Execute o comando kill para encerrar o processo do Grafana.

    2. 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

  1. Faça login no Grafana.

    1. 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.

    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. No primeiro acesso, 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

    ****

    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.

  6. 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

  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 anteriormente.

  5. 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 1000

    Instruçã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 $__unixMicroTimeRangeFilter no 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.

      Nota

      Se 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>.

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

  7. Configure e salve o painel do dashboard.

    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, preencha Title, Description e Folder do dashboard. 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 dashboard dentro da pasta desejada para visualizar todos os seus gráficos de monitoramento.