Application Real-Time Monitoring Service:Access Prometheus monitoring data through HTTP API URLs

Authentification

Managed Service for Prometheus prend en charge deux versions d'instance, chacune utilisant une méthode d'authentification différente.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Une instance Prometheus connectée. Pour obtenir des instructions de configuration, consultez :

  • Observabilité des conteneurs

  • Observabilité des services Alibaba Cloud

  • Observabilité des hôtes

• (Pour Grafana) Une instance Grafana gérée par vos soins avec un accès administrateur

• (Pour Prometheus V2) Une paire AccessKey pour votre compte ; l'utilisateur RAM associé doit disposer des autorisations requises

Obtenir l'URL de l'API HTTP

1. Connectez-vous à la console CloudMonitor.

2. Dans le volet de navigation de gauche, choisissez Managed Service for Prometheus > Instances.

3. Dans la barre de navigation supérieure, sélectionnez la région où réside votre instance Prometheus.

4. Recherchez votre instance Prometheus, puis cliquez sur Settings dans la colonne Actions.

5. Sous l'onglet Settings, copiez l'URL de l'API HTTP.

   • Utilisez l'URL public si votre instance Grafana ou votre application se trouve en dehors du réseau interne d'Alibaba Cloud.

   • Utilisez l'URL internal si votre instance Grafana ou votre application s'exécute dans la même région Alibaba Cloud et peut accéder aux points de terminaison internes.

6. (Prometheus V1 uniquement) Cliquez sur Generate Token pour créer un jeton d'authentification. Enregistrez ce jeton pour une utilisation ultérieure.

Configurer une source de données Grafana gérée par vos soins

Vérifier la source de données dans Grafana

1. Dans Grafana, accédez à Dashboards et cliquez sur New > New dashboard.

2. Cliquez sur + Add visualization et sélectionnez la source de données configurée.

3. Sur la page Edit Panel, ouvrez l'onglet Query. Dans la section A, saisissez un nom de métrique dans le champ Metrics (par exemple, arms_prometheus_target_interval_length_seconds_sum) et configurez les Label filters selon vos besoins.

4. Cliquez sur Run queries.

Si un graphique s'affiche avec des données de métriques, la source de données fonctionne. Si aucun graphique n'apparaît, vérifiez la validité de l'URL de l'API ou du jeton, ainsi que la présence de données de surveillance dans la source de données. Pour obtenir de l'aide supplémentaire, consultez la section Dépannage.

Interroger l'API HTTP par programmation

Les exemples suivants utilisent le point de terminaison /api/v1/query pour les requêtes instantanées. Pour les requêtes de plage (/api/v1/query_range), les métadonnées de série et les autres points de terminaison, consultez la documentation de référence de l'API HTTP Prometheus.

curl -G '<your-http-api-url>/api/v1/query' \
  -H 'Authorization: <your-token>' \
  -H 'Accept: application/json' \
  --data-urlencode 'query=arms_prometheus_target_interval_length_seconds_sum' \
  --data-urlencode 'time=1635302655' \
  --data-urlencode 'timeout=1000'

curl -G '<your-http-api-url>/api/v1/query' \
  -u '<your-accesskey-id>:<your-accesskey-secret>' \
  -H 'Accept: application/json' \
  --data-urlencode 'query=arms_prometheus_target_interval_length_seconds_sum' \
  --data-urlencode 'time=1635302655' \
  --data-urlencode 'timeout=1000'

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

Dépannage

Rubriques connexes

• Documentation de référence de l'API HTTP Prometheus — Documentation complète de l'API pour les points de terminaison de requête, y compris les requêtes de plage (/api/v1/query_range), les requêtes d'étiquettes et les métadonnées de série

• Créer un tableau de bord Grafana — Créez des tableaux de bord avec la source de données connectée