Use an HTTP API URL to connect a Prometheus instance to a self-managed Grafana system - Application Real-Time Monitoring Service: Central de Documentação do Alibaba Cloud

Pré-requisitos

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

Uma instância do Prometheus conectada. Para conectar uma instância, consulte Observabilidade de contêineres, Observabilidade de serviços da Alibaba Cloud ou Observabilidade de hosts
Acesso de administrador à sua instância Grafana autogerenciada (para integração com o Grafana)
A versão da sua instância do Prometheus (V1 ou V2), pois ela determina o método de autenticação
(Somente V2) Um AccessKey ID e um AccessKey secret de um usuário RAM com a permissão AliyunPrometheusMetricReadAccess ou AliyunCloudMonitorFullAccess

Obtenha a URL da API HTTP

Faça login no console do Cloud Monitor. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances.
Na barra de navegação superior, selecione a região onde a instância do Prometheus está implantada. Localize a instância e clique em Settings na coluna Actions.
Na aba Settings, copie a URL da API HTTP pública ou interna.

Configure a autenticação

A autenticação varia entre as instâncias Prometheus V1 e V2. Verifique sua versão antes de prosseguir.

Prometheus V1 (baseado em token, opcional)

Opcionalmente, na aba Settings, clique em Generate Token para criar um token de autenticação. Salve este token, pois ele é necessário ao adicionar a fonte de dados ao Grafana e ao fazer requisições à API.

Importante

Após gerar o token de autenticação, especifique-o ao adicionar a instância do Prometheus como fonte de dados no seu sistema Grafana. Caso contrário, não será possível ler os dados de monitoramento da instância do Prometheus.

Prometheus V2 (baseado em AccessKey)

Por padrão, o acesso aos dados requer um AccessKey ID e um AccessKey secret com autenticação HTTP Basic. Nenhum token é necessário.

O usuário RAM associado deve ter uma das seguintes permissões de sistema:

AliyunPrometheusMetricReadAccess -- acesso somente leitura às métricas
AliyunCloudMonitorFullAccess -- acesso total ao Cloud Monitor

Para conceder essas permissões, consulte Conceder permissões a um usuário RAM.

Adicione a fonte de dados ao Grafana autogerenciado

Configure a fonte de dados do Prometheus

Faça login na sua instância do Grafana como administrador.
Clique no ícone no canto superior esquerdo. No painel de navegação à esquerda, escolha Configuration > Data sources.

Nota
Este menu fica visível apenas para administradores.
Clique em + Add data source e selecione Prometheus.

Na aba Settings, configure os seguintes campos:

Campo	Valor
Name	Um nome descritivo para esta fonte de dados
Prometheus server URL	A URL da API HTTP copiada na etapa Obtenha a URL da API HTTP

Configure a autenticação conforme a versão do seu Prometheus: Prometheus V1: Se você gerou um token, clique em + Add header na seção Custom HTTP Headers. Defina o Header como Authorization e o Value como o token obtido na etapa Configure a autenticação. Prometheus V2: Ative a opção Basic auth. Defina o campo User com seu AccessKey ID e o campo Password com seu AccessKey secret.
Clique em Save & test.

Verifique a fonte de dados

Clique no ícone no canto superior esquerdo e clique em Dashboards no painel de navegação à esquerda.
Clique em New > New dashboard e depois em + Add visualization.
Na página Select data source, selecione a fonte de dados configurada.
Na aba Query, insira o nome de uma métrica no campo Metrics e um filtro de rótulo no campo Label filters. Clique em Run queries. Se um gráfico aparecer, a fonte de dados está conectada. Caso nenhum gráfico seja exibido, consulte a seção Solução de problemas.

Consulte dados do Prometheus com a API HTTP

A API HTTP do Prometheus padrão permite acesso programático aos dados de monitoramento.

Formato da requisição

Os cabeçalhos de autenticação diferem entre as versões V1 e V2.

Prometheus V1:

GET <http-api-url>/api/v1/query

Accept: application/json
Content-Type: application/json
Authorization: <your-auth-token>

{
  "query": "arms_prometheus_target_interval_length_seconds_sum",
  "time": "1635302655",
  "timeout": "1000"
}

Prometheus V2:

GET <http-api-url>/api/v1/query

Accept: application/json
Content-Type: application/json
Authorization: Basic <base64-encoded-accesskey-id:accesskey-secret>

{
  "query": "arms_prometheus_target_interval_length_seconds_sum",
  "time": "1635302655",
  "timeout": "1000"
}

Substitua os seguintes espaços reservados pelos valores reais:

Espaço reservado	Descrição	Exemplo
`<http-api-url>`	A URL da API HTTP obtida na aba Settings	`https://cn-hangzhou.arms.aliyuncs.com/...`
`<your-auth-token>`	(V1) O token gerado no console	`eyJhbGci...`
`<base64-encoded-accesskey-id:accesskey-secret>`	(V2) Par `AccessKeyID:AccessKeySecret` codificado em Base64	`TFRBSTV0WH...`

Visualize 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***"
                ]
            }
        ]
    }
}

Solução de problemas

Sintoma	Causa possível	Solução
Falha em Save & test com erro de autenticação	(V1) Token inválido ou ausente no cabeçalho Authorization	Gere novamente o token na aba Settings e atualize o valor em Custom HTTP Headers
Erro de autenticação ao executar Save & test	(V2) AccessKey ID ou AccessKey secret incorretos	Verifique as credenciais. Certifique-se de que o usuário RAM tenha a permissão `AliyunPrometheusMetricReadAccess` ou `AliyunCloudMonitorFullAccess`
Falha de conexão durante o Save & test	URL da API HTTP incorreta ou problema de conectividade de rede	Confirme a URL na aba Settings. Se estiver usando uma URL interna, garanta que sua instância do Grafana consiga alcançar o endpoint interno
A consulta não retorna dados	A instância do Prometheus ainda não tem dados de monitoramento ou o nome da métrica está incorreto	Verifique se a instância do Prometheus está coletando ativamente os alvos e confirme o nome da métrica
A requisição à API retorna `401 Unauthorized`	(V1) Token ausente	Gere um novo token e inclua-o no cabeçalho `Authorization`
A requisição à API retorna `403 Forbidden`	(V2) O usuário RAM não tem as permissões necessárias	Conceda a permissão `AliyunPrometheusMetricReadAccess` ao usuário RAM

Próximos passos

Explore a referência completa da API HTTP do Prometheus para consultas avançadas, incluindo consultas de intervalo, buscas de rótulos e endpoints de metadados
Configure o Alibaba Cloud Managed Service for Grafana como alternativa ao Grafana autogerenciado