15.2. Interroger les métriques en utilisant le point de terminaison de la fédération pour Prometheus
Vous pouvez utiliser le point d'extrémité de fédération pour récupérer des métriques de plate-forme et des métriques définies par l'utilisateur à partir d'un emplacement réseau en dehors du cluster. Pour ce faire, accédez au point d'extrémité Prometheus /federate pour le cluster via une route OpenShift Container Platform.
L'utilisation de la fédération entraîne un retard dans la récupération des données de mesure. Ce délai peut affecter la précision et l'actualité des métriques récupérées.
L'utilisation du point de terminaison de la fédération peut également dégrader les performances et l'évolutivité de votre cluster, en particulier si vous utilisez le point de terminaison de la fédération pour récupérer de grandes quantités de données de métriques. Pour éviter ces problèmes, suivez les recommandations suivantes :
- N'essayez pas de récupérer toutes les données de métrologie via le point de terminaison de la fédération. Ne l'interrogez que si vous souhaitez récupérer un ensemble de données limité et agrégé. Par exemple, l'extraction de moins de 1 000 échantillons par requête permet de minimiser le risque de dégradation des performances.
- Évitez d'interroger fréquemment le point de terminaison de la fédération. Limitez les requêtes à un maximum d'une toutes les 30 secondes.
Si vous devez transmettre de grandes quantités de données en dehors du cluster, utilisez plutôt l'écriture à distance. Pour plus d'informations, voir la section Configuring remote write storage.
Conditions préalables
-
Vous avez installé l'OpenShift CLI (
oc). - Vous avez obtenu l'URL de l'hôte pour la route OpenShift Container Platform.
Vous avez accès au cluster en tant qu'utilisateur ayant le rôle
cluster-monitoring-viewou vous avez obtenu un jeton de porteur avec la permissiongetsur la ressourcenamespaces.NoteVous ne pouvez utiliser que l'authentification par jeton porteur pour accéder au point de terminaison de la fédération.
Procédure
Récupérer le jeton du porteur :
$ token=`oc whoami -t`Interroger les métriques de la route
/federate. L'exemple suivant interroge les métriques deup:$ curl -G -s -k -H "Authorization: Bearer $token" \ 'https:/<federation_host>/federate' \1 --data-urlencode 'match[]=up'- 1
- Pour <federation_host>, remplacez l'URL de l'hôte pour la route de la fédération.
Exemple de sortie
# TYPE up untyped up{apiserver="kube-apiserver",endpoint="https",instance="10.0.143.148:6443",job="apiserver",namespace="default",service="kubernetes",prometheus="openshift-monitoring/k8s",prometheus_replica="prometheus-k8s-0"} 1 1657035322214 up{apiserver="kube-apiserver",endpoint="https",instance="10.0.148.166:6443",job="apiserver",namespace="default",service="kubernetes",prometheus="openshift-monitoring/k8s",prometheus_replica="prometheus-k8s-0"} 1 1657035338597 up{apiserver="kube-apiserver",endpoint="https",instance="10.0.173.16:6443",job="apiserver",namespace="default",service="kubernetes",prometheus="openshift-monitoring/k8s",prometheus_replica="prometheus-k8s-0"} 1 1657035343834 ...