Pour identifier rapidement les goulots d'étranglement liés aux performances et résoudre les problèmes de cluster, activez Tracing Analysis sur l'API server du cluster afin d'enregistrer les détails des interactions de requêtes. Une fois activée, les données de trace de l'API server sont automatiquement envoyées à Managed Service for OpenTelemetry, qui fournit des données de surveillance telles que les détails de trace et la topologie en temps réel.
Si vous débutez avec le traçage, consultez la rubrique Concepts de base pour en apprendre les fondamentaux.
Prérequis
Vous disposez d'un cluster ACK managé Pro exécutant Kubernetes 1.28 ou une version ultérieure. Si vous devez mettre à niveau votre cluster, consultez la rubrique Mettre à niveau un cluster manuellement.
-
Vous avez activé et autorisé Managed Service for OpenTelemetry. Pour plus d'informations, consultez la rubrique Premiers pas.
Managed Service for OpenTelemetry fournit des outils pour les applications distribuées, notamment la reconstruction de traces de bout en bout, les statistiques de volume de requêtes, la topologie des traces et l'analyse des dépendances entre applications.
Lorsque vous utilisez cette fonctionnalité, Managed Service for OpenTelemetry vous facture le volume de données d'observabilité, en plus des frais liés à votre cluster ACK. Pour obtenir des informations sur le quota gratuit et les détails tarifaires de Managed Service for OpenTelemetry, consultez la rubrique Facturation.
Configurez les paramètres de l'API server pour activer Tracing Analysis et définir son taux d'échantillonnage. Une fois la configuration terminée, la console Managed Service for OpenTelemetry affiche les données de trace détaillées.
Étape 1 : Activer Tracing Analysis pour l'API server
Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.
Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Components and Add-ons .
Dans la zone Core Components, cliquez sur Configuration dans le coin inférieur droit de la carte Kube API Server.
-
Dans le panneau de configuration, localisez les paramètres enableTrace et samplingRatePerMillion et définissez leurs valeurs comme décrit ci-dessous.
Avant d'activer enableTrace, assurez-vous que Managed Service for OpenTelemetry est activé et disponible dans la région actuelle.
enableTrace : Active Tracing Analysis pour l'API server.
-
samplingRatePerMillion : Spécifie le nombre de requêtes à échantillonner pour chaque million de requêtes. Définissez le taux d'échantillonnage en fonction de la charge de travail du cluster.
Par exemple, une valeur de 1000000 correspond à un taux d'échantillonnage de 100 %, où toutes les requêtes sont échantillonnées et enregistrées. Une valeur de 100000 correspond à un taux d'échantillonnage de 10 %, et 10000 à un taux de 1 %.
Étape 2 : Afficher les données de trace dans OpenTelemetry
Connectez-vous à la console Managed Service for OpenTelemetry. Dans le volet de navigation de gauche, cliquez sur Applications.
-
En haut de la page, sélectionnez une région, puis cliquez sur l'application apiserver.
-
Onglet Trace Explorer : Affiche les traces et la topologie de l'application pour les requêtes de l'API server.
Pour obtenir des informations détaillées sur chaque onglet, consultez la rubrique Détails de l'application .
-
Dans la zone de recherche située dans le coin supérieur gauche de la page, saisissez
resources.k8s.cluster.name : "your_cluster_id"pour afficher les traces d'un cluster spécifique.Vous pouvez obtenir l'ID du cluster depuis la page Liste des clusters.
Cliquez sur un ID de trace dans la liste des traces pour afficher les détails d'une trace spécifique de l'API server, y compris la vue de la topologie, le nombre de services impliqués et le nombre d'appels d'API.
-
Onglet Provided Services : Affiche les métriques des endpoints de l'API server, telles que le nombre de requêtes, le nombre d'erreurs et la latence moyenne.
Onglet Dependencies : Affiche les métriques des dépendances externes de l'API server, telles que le nombre de requêtes, le nombre d'erreurs et la latence moyenne lors de l'accès à etcd.
-
Documentation connexe
Pour surveiller les données de trace des composants du plan de données de votre cluster, consultez la rubrique Activer Tracing Analysis pour les composants du plan de données.