Todos os produtos
Search

Este produto

    Cloud Monitor:Adicionar uma fonte de dados do Prometheus no Grafana

    Central de documentação

    Cloud Monitor:Adicionar uma fonte de dados do Prometheus no Grafana

    Última atualização: Jul 08, 2026

    O Alibaba Cloud Managed Service for Prometheus fornece URLs de API HTTP para acessar os dados de monitoramento do Prometheus no Grafana ou recuperar dados pela API do Prometheus para desenvolvimento personalizado.

    Pré-requisitos

    Integre as fontes de dados ao Prometheus. Para mais informações, consulte os tópicos a seguir:

    Etapa 1: Obter a URL da API HTTP

    1. Faça logon no console do CloudMonitor. No painel de navegação à esquerda, selecione Prometheus Monitoring > Instance List para acessar a página Instance List.

    2. Na barra de navegação superior, selecione o ambiente Prometheus onde a instância está implantada. Localize a instância desejada e clique em Settings na coluna Actions.

    3. Na aba Settings, copie a URL da API HTTP da rede pública ou interna, conforme necessário.

      Você também pode clicar em Generate token para aumentar a segurança na leitura dos dados.

    4. Para instâncias V1 do Prometheus, se precisar aumentar a segurança da leitura de dados no Grafana, clique em Generate token para obter um token de autenticação da instância.

      Importante

      • Instâncias V1: após gerar um token, configure-o ao adicionar a fonte de dados no Grafana. Caso contrário, não será possível ler os dados de monitoramento da instância do Prometheus.

      • Instâncias V2: por padrão, use o AccessKey ID e o AccessKey secret da sua conta para acessar os dados. O usuário RAM proprietário do AccessKey ID deve ter a permissão de sistema AliyunPrometheusMetricReadAccess ou AliyunCloudMonitorFullAccess.

    Etapa 2: Adicionar a fonte de dados no Grafana

    Grafana autogerenciado

    Esta seção usa o Grafana v10.x como exemplo. Para obter informações sobre como adicionar uma fonte de dados em outras versões, consulte a documentação oficial do Grafana.

    1. Configure a fonte de dados do Grafana.

      1. Faça logon no Grafana autogerenciado como administrador.

      2. No canto superior esquerdo da página, clique em no ícone de menu image e escolha Administration > Data sources.

      3. Clique em + Add new data source e selecione Prometheus como tipo de fonte de dados.

      4. Na aba Settings, insira um nome personalizado no campo Name. No campo Prometheus server URL, cole a URL da API HTTP obtida na Etapa 1.

      5. Configure a autenticação.

        Instâncias V1 (opcional)

        Clique em + Add header. Na seção Custom HTTP Headers, clique em +Add header, defina Header como Authorization e configure Value com o token de autenticação obtido na Etapa 1.

        Instâncias V2

        Ative Basic auth. Defina User com seu AccessKey ID e Password com seu AccessKey secret.

    2. Na parte inferior da página, clique em Save & Test.

    3. Visualize as métricas do Prometheus.

      1. Faça logon no sistema Grafana.

      2. No canto superior esquerdo da página, clique em no ícone de menu image e clique em Dashboards no painel de navegação à esquerda.

      3. Na página Dashboards, clique em New no canto superior direito e, em seguida, clique em New dashboard no menu suspenso.

      4. Clique em + Add visualization. Na página Select data source, selecione a fonte de dados criada.

      5. Na página Edit Panel, acesse a aba Query. Na seção A, insira o nome e o valor da métrica nos campos Metrics e Label filters e clique em Run queries.

        Se um gráfico da métrica for exibido, a configuração foi bem-sucedida. Caso contrário, verifique se a URL da API e o token estão corretos e se a fonte de dados contém dados de monitoramento do Prometheus.

        image

    Managed Service for Grafana

    O Managed Service for Grafana oferece integração com um clique para fontes de dados e painéis do Prometheus.

    1. Faça logon no console do ARMS. No painel de navegação à esquerda, escolha Managed Service for Grafana > Workspace Management e clique em no ID do seu workspace.

    2. Na página Workspace Information, localize a seção Cloud Service Integration e clique em Prometheus Monitoring Service. Em seguida, encontre sua instância e clique em Integrate.

    3. Na caixa de diálogo exibida, clique em OK.

      Ao integrar uma instância V2 do Prometheus, insira o AccessKey ID da fonte de dados.

    4. Após a conclusão da sincronização, clique em no ícone de folder à direita.

    5. No Grafana, na aba Dashboards, clique em no nome de um painel para visualizar os painéis padrão pré-construídos para monitoramento de aplicações.

    6. No canto superior esquerdo da página, clique em no ícone de menu image e escolha Administration > Data sources para visualizar a fonte de dados de monitoramento de aplicações adicionada.

    7. Visualize as métricas do Prometheus.

      1. Faça logon no sistema Grafana.

      2. No canto superior esquerdo da página, clique em no ícone de menu image e clique em Dashboards no painel de navegação à esquerda.

      3. Na página Dashboards, clique em New no canto superior direito e, em seguida, clique em New dashboard no menu suspenso.

      4. Clique em + Add visualization. Na página Select data source, selecione a fonte de dados criada.

      5. Na página Edit Panel, acesse a aba Query. Na seção A, insira o nome e o valor da métrica nos campos Metrics e Label filters e clique em Run queries.

        Se um gráfico da métrica for exibido, a configuração foi bem-sucedida. Caso contrário, verifique se a URL da API e o token estão corretos e se a fonte de dados contém dados de monitoramento do Prometheus.

        image

    Etapa 3: Recuperar dados do Prometheus

    O código a seguir mostra um exemplo de solicitação para recuperar dados de monitoramento do Prometheus. Para mais informações sobre o uso da API HTTP, consulte a documentação da API HTTP do Prometheus open-source.

    Instâncias V1

    GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: {Token}
{
  "query":"arms_prometheus_target_interval_length_seconds_sum",
  "time":"1635302655",
  "timeout":"1000"
}
    Nota

    Substitua {HTTP API URL} e {Token} pela URL da API HTTP e pelo token de autenticação obtidos na Etapa 1.

    Instâncias V2

    GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: Basic <base64Encode(<AccessKey ID:AccessKey secret>)>
{
  "query":"arms_prometheus_target_interval_length_seconds_sum",
  "time":"1635302655",
  "timeout":"1000"
}
    Nota

    • Substitua {HTTP API URL} pela URL da API HTTP obtida na Etapa 1.

    • A API suporta autenticação STS. Ao utilizar esse método, o AccessKey secret em BasicAuth deve seguir o formato: {AccessKey secret}${STS Token}. Para mais detalhes, consulte O que é STS?.

    Exemplo de resposta:

    Expandir para visualizar a resposta de exemplo

    {
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "15s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "146655.24420603***"
                ]
            },
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "30s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "879810.747346***"
                ]
            },
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "20s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "73320.13578499***"
                ]
            }
        ]
    }