Métriques Config Sync

Cette page décrit les métriques OpenTelementry disponibles pour surveiller vos ressources Config Sync.

Config Sync utilise OpenCensus pour créer et enregistrer des métriques et OpenTelemetry pour exporter ses métriques vers Prometheus et Cloud Monitoring. Vous pouvez exporter des métriques OpenTelementry vers un autre système de surveillance. Les guides suivants expliquent comment exporter des métriques :

Métriques OpenTelementry

Config Sync et le contrôleur de groupe de ressources collectent les métriques suivantes avec OpenCensus et les mettent à disposition via le collecteur OpenTelemetry. La colonne Tags répertorie les tags spécifiques à Config Sync applicables à chaque métrique. Les métriques avec des tags représentent plusieurs mesures, une pour chaque combinaison de valeurs de tags.

Métriques Config Sync

Nom Type Tags Description
api_duration_seconds Distribution État de l'opération Distribution de la latence des appels de serveur d'API
apply_duration_seconds Distribution état Distribution de la latence de l'application des ressources déclarées à un cluster depuis la source fiable.
apply_operations_total Nombre opération, état, contrôleur Nombre total d'opérations effectuées pour synchroniser les ressources de la source de vérité avec un cluster.
declared_resources Dernière valeur Nombre de ressources déclarées analysées à partir de Git
internal_errors_total Nombre source Nombre total d'erreurs internes rencontrées par Config Sync La métrique peut ne pas apparaître dans les résultats de la requête si aucune erreur interne ne s'est produite.
last_sync_timestamp Dernière valeur état Horodatage de la dernière synchronisation à partir de Git
parser_duration_seconds Distribution état, déclencheur, source Distribution de la latence des différentes étapes impliquées dans la synchronisation de la source de vérité vers un cluster.
pipeline_error_observed Dernière valeur name, reconciler, component État des ressources personnalisées RootSync et RepoSync. Une valeur de 1 indique un échec.
reconcile_duration_seconds Distribution état Distribution de la latence des événements de rapprochement gérés par le gestionnaire de rapprochement.
reconciler_errors Dernière valeur component, errorclass Nombre d'erreurs rencontrées lors de la synchronisation des ressources de la source de vérité avec un cluster.
remediate_duration_seconds Distribution état Distribution de la latence des événements de rapprochement de correction
resource_conflicts_total Nombre Nombre total de conflits de ressources résultant d'une différence entre les ressources mises en cache et les ressources du cluster La métrique peut ne pas apparaître dans les résultats de la requête si aucun conflit de ressources ne s'est produit.
resource_fights_total Nombre Nombre total de ressources synchronisées trop fréquemment. Tout résultat supérieur à zéro indique un problème. Pour en savoir plus, consultez la page KNV2005 : ResourceFightWarning. La métrique peut ne pas apparaître dans les résultats de la requête si aucun conflit de ressources ne s'est produit.

Métriques de contrôleur de groupe de ressources

Le contrôleur de groupe de ressources est un composant de Config Sync qui effectue le suivi des ressources gérées et vérifie si chacune d'elles est prête ou rapprochée. Les métriques suivantes sont disponibles.

Nom Type Tags Description
rg_reconcile_duration_seconds Distribution stallreason Répartition du temps nécessaire au rapprochement d'une RS ResourceGroup
resource_group_total Dernière valeur Nombre actuel de RS ResourceGroup
resource_count Dernière valeur resourcegroup Nombre total de ressources suivies par une RS ResourceGroup
ready_resource_count Dernière valeur resourcegroup Nombre total de ressources prêtes dans une RS ResourceGroup
resource_ns_count Dernière valeur resourcegroup Nombre d'espaces de noms utilisés par les ressources dans une RS ResourceGroup
cluster_scoped_resource_count Dernière valeur resourcegroup Nombre de ressources à l'échelle du cluster dans une RS ResourceGroup
crd_count Dernière valeur resourcegroup Nombre de CRD dans une RS ResourceGroup
kcc_resource_count Dernière valeur resourcegroup Nombre total de ressources KCC dans un ResourceGroup
pipeline_error_observed Dernière valeur name, reconciler, component État des ressources personnalisées RootSync et RepoSync. Une valeur de 1 indique un échec.

Libellés de métriques Config Sync

Les libellés de métriques peuvent être utilisés pour agréger les données de métriques dans Cloud Monitoring et Prometheus. Ils peuvent être sélectionnés dans la liste déroulante "Grouper par" de la console Monitoring.

Pour en savoir plus sur les libellés Cloud Monitoring et les libellés de métriques Prometheus, consultez les pages Composants du modèle de métrique et Modèle de données Prometheus.

Étiquettes de métriques

Les libellés suivants sont utilisés par les métriques Config Sync et du contrôleur de groupe de ressources, disponibles lors de la surveillance avec Cloud Monitoring et Prometheus.

Nom Values Description
operation création, correction, mise à jour, suppression Le type d'opération effectuée
status réussite, erreur État de l'exécution d'une opération
reconciler rootsync, reposync Type de rapprochement
source analyseur, différence, outil de résolution Source de l'erreur interne.
trigger réessayez, watchUpdate, managementConflict, resync, reimport Déclencheur d'un événement de rapprochement
name Nom du rapprochement Nom du rapprochement
component analyse, source, synchronisation, rendu, aptitude Nom du composant / étape de rapprochement actuelle
container rapprochement, git-sync Nom du conteneur
resource Processeur, mémoire Le type de la ressource
controller applicateur, outil de résolution Nom du contrôleur dans un rapprochement racine ou de l'espace de noms
type Toute ressource Kubernetes, par exemple ClusterRole, Namespace, NetworkPolicy, Role, etc. Le type d'API Kubernetes
commit ---- Hachage du dernier commit synchronisé

Étiquettes de ressource

Les métriques Config Sync envoyées à Prometheus et à Cloud Monitoring comportent les libellés de métriques suivants définis pour identifier le pod source :

Nom Description
k8s.node.name Nom du nœud hébergeant un pod Kubernetes
k8s.pod.namespace Espace de noms du pod
k8s.pod.uid UID du pod
k8s.pod.ip Adresse IP du pod
k8s.deployment.name Nom du déploiement propriétaire du pod

Les métriques Config Sync envoyées à Prometheus et à Cloud Monitoring à partir de pods reconciler possèdent également les libellés de métriques suivants définis pour identifier l'objet RootSync ou RepoSync utilisé pour configurer le rapprochement :

Nom Description
configsync.sync.kind Type de ressource qui configure ce rapprochement : RootSync ou RepoSync
configsync.sync.name Nom de l'objet RootSync ou RepoSync qui configure ce rapprochement
configsync.sync.namespace Espace de noms de RootSync ou RepoSync qui configure ce rapprochement

Libellés de ressources Cloud Monitoring

Les libellés de ressources Cloud Monitoring sont utilisés pour indexer les métriques dans le stockage, ce qui signifie qu'ils ont un effet négligeable sur la cardinalité, contrairement aux libellés de métriques, où la cardinalité est un problème de performances important. Pour plus d'informations, consultez la page Types de ressources surveillés.

Le type de ressource k8s_container définit les libellés de ressource suivants pour identifier le conteneur source :

Nom Description
container_name Nom du conteneur
pod_name Nom du pod
namespace_name Espace de noms du pod
location Région ou zone du cluster hébergeant le nœud
cluster_name Nom du cluster hébergeant le nœud
project ID du projet hébergeant le cluster

Comprendre la métrique pipeline_error_observed

La métrique pipeline_error_observed est une métrique qui peut vous aider à identifier rapidement les RS RepoSync ou RootSync qui ne sont pas synchronisées ou qui contiennent des ressources qui ne sont pas rapprochées de l'état souhaité.

  • Pour une synchronisation réussie par RootSync ou RepoSync, les métriques avec tous les composants (rendering, source, sync, readiness) sont observées avec la valeur 0.

    Capture d'écran de la métrique pipeline_error_observed avec tous les composants observés avec la valeur 0

  • Lorsque le dernier commit échoue l'affichage automatisé, la métrique avec le composant rendering est observée avec la valeur 1.

  • En cas d'erreur lors du dernier commit ou si le dernier commit contient une configuration non valide, la métrique du composant source est observée avec la valeur 1.

  • Lorsqu'une ressource ne peut pas être appliquée au cluster, la métrique avec le composant sync est observée avec la valeur 1.

  • Lorsqu'une ressource est appliquée, mais ne parvient pas à atteindre son état souhaité, la métrique avec le composant readiness est observée avec la valeur 1. Par exemple, un déploiement est appliqué au cluster, mais les pods correspondants ne sont pas créés correctement.

Étapes suivantes