Utilisation de la pile de surveillance

La pile de surveillance pour les clusters Automation Suite comprend Prometheus, Grafana et Alertmanager, qui sont intégrés dans l'interface utilisateur de Rancher Cluster Explorer.

Remarque :

Les défaillances de nœud peuvent provoquer un arrêt de Kubernetes, ce qui aura pour effet de perturber les alertes Prometheus. Pour éviter cela, nous vous recommandons de configurer une alerte distincte sur le serveur RKE2.

This page describes a series of monitoring scenarios. For more details, see the official Rancher documentation on using Rancher Monitoring.

Important :

Lors de l'utilisation de collecteurs pour exporter des métriques vers des outils tiers, l'activation de la surveillance des applications peut perturber les fonctionnalités d'Automation Suite.

Accès aux outils de surveillance

Vue d'ensemble (Overview)

La pile de surveillance pour les clusters Automation Suite comprend Prometheus, Grafana, Alert Manager et Longhorn Dashboard.

Cette page décrit une série de scénarios de surveillance.

For more details, see the official Rancher documentation on using Rancher Monitoring.

Vous pouvez accéder aux outils de surveillance Automation Suite individuellement à l'aide des URL suivantes :

Application	Outil	URL	Exemple
Métriques	Prometheus	https://monitoring.fqdn/metrics	https://monitoring.automationsuite.mycompany.com/metrics
Tableau de bord	Grafana	https://monitoring.fqdn/dashboard	https://monitoring.automationsuite.mycompany.com/dashboard
Gestion des alertes	Alertmanager	https://monitoring.fqdn/alertmanager	https://monitoring.automationsuite.mycompany.com/alertmanager
Stockage de blocs persistant	Tableau de bord Longhorn	https://monitoring.fqdn	https://monitoring.automationsutie.mycompany.com

Authentification de l'outil de surveillance

Pour accéder aux outils de surveillance pour la première fois, connectez-vous en tant qu'administrateur avec les informations d'identification par défaut suivantes :

• Nom d’utilisateur : admin

• Mot de passe (Password) : pour récupérer le mot de passe, exécutez la commande suivante :

  kubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -d
  

Authentification Dex

Pour mettre à jour le mot de passe par défaut utilisé pour l'authentification Dex lors de l'accès aux outils de surveillance, procédez comme suit.

Remarque :

Dex est une méthode d'authentification de base qui repose sur les outils de surveillance. Par conséquent, la mise à jour du mot de passe Dex n'a pas d'impact sur les mots de passe des outils de surveillance. Dans ce scénario, les mots de passe des outils de surveillance restent les mêmes qu'auparavant.

1. Exécutez la commande suivante en remplaçant newpassword par votre nouveau mot de passe :

   password="newpassword"
   password=$(echo -n $password | base64)
   kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"
   

2. Exécutez la commande suivante en remplaçant <cluster_config.json> par le chemin d'accès à votre fichier de configuration :

   /opt/UiPathAutomationSuite/UiPath_Installer/install-uipath.sh -i <cluster_config.json> -f -o output.json --accept-license-agreement
   

Checking currently firing alerts

Pour afficher les alertes, accédez à Prometheus à l'aide de https://monitoring.fqdn/metrics et sélectionnez l'onglet Alertes (Alerts). Ici, vous pouvez voir toutes les alertes configurées dans Automation Suite.

To view the active alerts, filter the alert status by selecting the Firing checkbox and the Show annotations checkbox at the top. Here you can see all the alerts that are firing currently and their corresponding messages.

Mettre les alertes en silencieux

Si les alertes sont trop bruyantes, vous pouvez les désactiver. Pour ce faire, procédez comme suit :

1. Sélectionnez la vignette Alertmanager dans le coin supérieur gauche du tableau de bord Monitoring . Le message suivant s'affiche.

   

2. Recherchez l'alerte en question et sélectionnez Silence.

   

3. Renseignez les détails Créateur (Creator) et Commentaire (Comment), puis cliquez sur Créer (Create). L'alerte ne devrait plus s'afficher sur le tableau de bord de surveillance ni être signalée à l'un des récepteurs configurés.

Configuration des alertes

Remarque :

Before starting configuring the alerts, make sure to enable kubectl.

Ajout d'une nouvelle configuration d'e-mail

Pour ajouter une nouvelle configuration de messagerie après une installation, exécutez la commande suivante :

./uipathctl config alerts add-email \
  --name test \
  --to "[e-mail]" \
  --from "[e-mail]" \
  --smtp server.mycompany.com \
  --username admin \
  --password somesecret \
  --require-tls \
  --ca-file <path_to_ca_file> \
  --cert-file <path_to_cert_file> \
  --key-file <path_to_key_file> \
  --send-resolved

Drapeau	Description	Exemple
name	Le nom de la configuration de l'e-mail	testconfig
to	L'adresse e-mail du destinataire	[e-mail]
from	L'adresse e-mail de l'expéditeur	[e-mail]
SMTP	URL du serveur SMTP ou adresse IP et numéro de port	server.mycompany.com:567
username	Nom d'utilisateur d'authentification	admin
password	Mot de passe d'authentification	securepassword
require-tls	Indicateur booléen indiquant que TLS est activé au niveau du serveur SMTP.	S/O
ca-file	Chemin du fichier contenant le certificat CA du serveur SMTP. Ceci est facultatif si l'autorité de certification est privée.	./ca-file.crt
cert-file	Chemin du fichier contenant le certificat du serveur SMTP. Ceci est facultatif si le certificat est privé.	./cert-file.crt
key-file	Chemin du fichier contenant la clé privée du certificat du serveur SMTP. Ceci est requis si le certificat est privé.	./key-file.crt
send-resolved	Indicateur booléen permettant d'envoyer un e-mail une fois l'alerte résolue.	S/O

Suppression d'une configuration d'e-mail

Pour supprimer une configuration d'e-mail, vous devez exécuter la commande suivante. Assurez-vous de saisir le nom de la configuration de l'e-mail que vous souhaitez supprimer.

./uipathctl config alerts remove-email --name test

Mise à jour d'une configuration d'e-mail

Pour mettre à jour une configuration d'e-mail, vous devez exécuter la commande suivante. Assurez-vous de transmettre le nom de la configuration d'e-mail que vous souhaitez mettre à jour et les paramètres facultatifs supplémentaires que vous souhaitez modifier. Ces paramètres sont les mêmes que ceux permettant d'ajouter une nouvelle configuration d'e-mail. Vous pouvez transmettre un ou plusieurs indicateurs en même temps.

./uipathctl config alerts update-email --name test [additional_flags]

Accéder au tableau de bord Grafana

Pour accéder aux tableaux de bord Grafana, vous devez récupérer vos identifiants et les utiliser pour vous connecter :

• Nom d’utilisateur :

  kubectl -n cattle-monitoring-system get secrets/rancher-monitoring-grafana -o "jsonpath={.data.admin-user}" | base64 -d; echo
  

• Mot de passe :

  kubectl -n cattle-monitoring-system get secrets/rancher-monitoring-grafana -o "jsonpath={.data.admin-password}" | base64 -d; echo
  

Monitoring the Service Mesh

Vous pouvez surveiller Istio Service Mesh via les tableaux de bord Grafana suivants : Istio Mesh et Istio Workload.

Tableau de bord Istio Mesh

Ce tableau de bord affiche le volume global de demandes, ainsi que les taux d'erreur 400 et 500 sur l'ensemble du service mesh, pour la période sélectionnée. Les données sont affichées dans le coin supérieur droit de la fenêtre. Voir les 4 tableaux en haut pour cette information.

Il montre également le taux de réussite (Success Rate) immédiat au cours de la dernière minute pour chaque service individuel. Notez qu'un taux de réussite affichant NaN indique que le service ne dessert pas actuellement le trafic.

Tableau de bord Istio Workload

Ce tableau de bord affiche les métriques de trafic sur la plage horaire sélectionnée dans le coin supérieur droit de la fenêtre.

Utilisez les sélecteurs en haut du tableau de bord pour explorer des charges de travail spécifiques. L'espace de noms uipath est particulièrement intéressant.

La section supérieure affiche les métriques globales, la section Charges de travail entrantes (Inbound Workloads) sépare le trafic en fonction de l'origine et la section Services sortants (Outbound Services) sépare le trafic en fonction de la destination.

Surveillance des volumes persistants

Vous pouvez surveiller les volumes persistants via le tableau de bord Kubernetes / Persistent Volumes. Vous pouvez suivre l'espace libre et utilisé pour chaque volume.

Vous pouvez également vérifier l'état de chaque volume en sélectionnant l'élément PersistentVolumes dans le menu Stockage de Cluster Explorer.

Surveillance de l'utilisation du matériel

Pour vérifier l'utilisation du matériel par nœud, vous pouvez utiliser le tableau de bord des nœuds (Nodes). Les données sur le processeur, la mémoire, le disque et le réseau sont disponibles.

Vous pouvez surveiller l'utilisation du matériel pour des charges de travail spécifiques à l'aide du tableau de bord Kubernetes / Ressources de calcul (Compute Resources) / Espace de noms (charges de travail) (Namespace (Workloads)). Sélectionnez l'espace de noms uipath pour obtenir les données nécessaires.

Création d'un instantané visuel partageable d'un graphique Grafana

1. Sélectionnez la flèche pointant vers le bas à côté du titre du graphique, puis sélectionnez Partager.
2. Sélectionnez l'onglet Instantané et définissez le Nom de l'instantané,Expirer, et Délai d' attente.
3. Sélectionnez Publier sur snapshot.raintank.io.

Pour plus de détails, consultez la documentation Grafana sur le partage des tableaux de bord.

Remarque :

Cet instantané est visible sur l'Internet public par toute personne disposant du lien.

Création de tableaux de bord Grafana persistants personnalisés

For details on how to create custom persisten Grafana dashboards, see Rancher documentation.

Accès administrateur à Grafana

L'accès administrateur à Grafana n'est généralement pas nécessaire dans les clusters Automation Suite car les tableaux de bord sont disponibles pour un accès en lecture par défaut aux utilisateurs anonymes, et la création de tableaux de bord persistants personnalisés doit être effectuée à l'aide des instructions exécutables de Kubernetes précédemment liées dans ce document.

Néanmoins, l'accès administrateur à Grafana est possible avec les instructions suivantes.

Le nom d'utilisateur et le mot de passe par défaut pour l'accès administrateur Grafana peuvent être récupérés comme suit :

kubectl get secret -n cattle-monitoring-system rancher-monitoring-grafana -o jsonpath='{.data.admin-user}' | base64 -d && echo
kubectl get secret -n cattle-monitoring-system rancher-monitoring-grafana -o jsonpath='{.data.admin-password}' | base64 -d && echo

Notez que dans les clusters haute disponibilité Automation Suite, il existe plusieurs pods Grafana afin de permettre un accès en lecture ininterrompu en cas de défaillance du nœud, ainsi qu'un volume plus élevé de requêtes en lecture. Ceci est incompatible avec l'accès administrateur car les pods ne partagent pas l'état de la session et la connexion, elle, l'exige. Afin de contourner ce problème, le nombre de répliques Grafana doit être temporairement réduit à 1. L'accès administrateur est quant à lui préféré. Consultez les instructions sur la façon de mettre à l'échelle le nombre de répliques Grafana :

# scale down
kubectl scale -n cattle-monitoring-system deployment/rancher-monitoring-grafana --replicas=1
# scale up
kubectl scale -n cattle-monitoring-system deployment/rancher-monitoring-grafana --replicas=2

Envoyer une requête à Prometheus

On the Monitoring Dashboard, select Prometheus Graph. A new window is displayed.

La documentation sur les métriques disponibles est ici :

• https://github.com/prometheus/node_exporter#enabled-by-default - Connectez-vous pour prévisualiser
• https://github.com/kubernetes/kube-state-metrics/tree/master/docs#exposed-metrics - Connectez-vous pour prévisualiser
• Envoyer des requêtes métriques depuis Prometheus (Istio)

Création d'alertes personnalisées

Vous pouvez créer des alertes personnalisées à l'aide d'une requête Prometheus en utilisant une expression booléenne.

1. To do so, select Prometheus Rules in the Advanced menu of the Monitoring Dashboard.
2. Select Create in the upper-right corner of the window to create a new alert, and follow the Rancher documentation: PrometheusRules
3. Lorsque l'alerte se déclenchera, elle devrait s'afficher sur le tableau de bord de surveillance. Elle sera également acheminée vers l'un des récepteurs configurés.

Surveillance du statut des ressources Kubernetes

Pour voir l'état des pods, des déploiements, des ensembles d'états, etc., vous pouvez utiliser l'interface utilisateur de Cluster Explorer. Il s'agit de la même page d'accueil que celle à laquelle vous pouvez accéder après la connexion au point de terminaison rancher-server. La page d'accueil affiche un résumé, avec des détails spécifiques pour chaque type de ressource sur la gauche. Notez le sélecteur d'espace de noms en haut de la page. Ce tableau de bord peut également être remplacé par l'outil Lentille (Lens).

Exportation des métriques Prometheus vers un système externe

Prometheus utilise la fonction d'écriture à distance Prometheus pour collecter et exporter les métriques Prometheus vers un système externe.

Remarque :

UiPath® ne prend pas en charge ni ne gère les intégrations de point de terminaison d’écriture à distance. Cependant, les points de terminaison sont compatibles avec l’instance Prometheus fournie dans Automation Suite.

Pour configurerremote_write sur un cluster Automation Suite :

1. Connect to ArgoCD.

2. Sélectionnez Applications.

3. Accédez à fabric-installer.

4. Ouvrez le panneau APP DETAILS et désactivez la réparation automatique.

5. Accédez à l'application rancher-monitoring.

   

6. Ouvrez le panneau APP DETAILS > onglet MANIFEST.

   

7. Sélectionnez MODIFIER (EDIT) et accédez à la section valeurs > prometheus > prometheusSpec .

8. Ajoutez les configurations remoteWrite souhaitées.

   Découvrez les configurations disponibles pour la fonctionnalité d'écriture à distance.

   

9. ENREGISTREZ (SAVE) la nouvelle configuration. L'application rancher-monitoring affiche OutOfSync jusqu'à ce que la nouvelle configuration soit appliquée.

   Remarque :

   Prometheus n'a pas besoin de redémarrer pour appliquer les nouvelles configurations d'écriture à distance.

   

   

10. Testez l'intégration d'écriture à distance souhaitée. Revenez à l'étape 8 pour ajouter une nouvelle configuration.