En la página se describen las métricas de OpenTelemetry disponibles para supervisar los recursos del Sincronizador de configuración.
El Sincronizador de configuración usa OpenCensus para crear y registrar métricas, y OpenTelemetry para exportar sus métricas a Prometheus y Cloud Monitoring. Puedes exportar las métricas de OpenTelemetry a otro sistema de supervisión. En la siguiente guía se explica cómo exportar métricas:
Métricas de OpenTelemetry
El Sincronizador de configuración y el controlador de grupo de recursos recopilan las siguientes métricas con OpenCensus y las ponen a disposición a través del recopilador de OpenTelemetry. En la columna Etiquetas, se enumeran las etiquetas específicas del Sincronizador de configuración que se aplican a cada métrica. Las métricas con etiquetas representan varias medidas, una para cada combinación de valores de etiqueta.
Métricas del Sincronizador de configuración
Nombre | Tipo | Etiquetas | Descripción |
---|---|---|---|
api_duration_seconds | Distribución | operación, estado | La distribución de latencia de las llamadas al servidor de la API. |
apply_duration_seconds | Distribución | estado | La distribución de latencia de la aplicación de recursos declarados desde la fuente de información a un clúster. |
apply_operations_total | Recuento | operación, estado, controlador | La cantidad total de operaciones que se realizaron para sincronizar recursos de la fuente de información con un clúster. |
declared_resources | Último valor | La cantidad de recursos declarados que se analizaron en Git. | |
internal_errors_total | Recuento | source | La cantidad total de errores internos que activó la Sincronizador de configuración. Es posible que la métrica no aparezca en los resultados de la consulta si no se produjo ningún error interno. |
last_sync_timestamp | Último valor | estado | La marca de tiempo de la sincronización más reciente de Git. |
parser_duration_seconds | Distribución | estado, activador, fuente | La distribución de latencia de las diferentes etapas involucradas en la sincronización de la fuente de información a un clúster. |
pipeline_error_observed | Último valor | name, reconciler, component | El estado de los recursos personalizados de RootSync y RepoSync Un valor de 1 indica un error. |
reconcile_duration_seconds | Distribución | estado | Distribución de latencia de los eventos de conciliación manejados por el administrador de conciliación. |
reconciler_errors | Último valor | componente, errorclass | La cantidad de errores detectados mientras se sincronizan recursos de la fuente de información con un clúster. |
remediate_duration_seconds | Distribución | estado | Distribución de latencia de los eventos de conciliación del remediador. |
resource_conflicts_total | Recuento | La cantidad total de conflictos de recursos que resultan de una discrepancia entre los recursos almacenados en caché y los recursos del clúster. Es posible que la métrica no aparezca en los resultados de la consulta si no se produjo ningún conflicto de recursos. | |
resource_fights_total | Recuento | La cantidad total de recursos que se sincronizan con demasiada frecuencia. Cualquier resultado mayor que cero indica un problema. Para obtener más información, consulta KNV2005: ResourceFightWarning. Es posible que la métrica no aparezca en los resultados de la consulta si no se realizó una competencia de recursos. |
Métricas del controlador de grupos de recursos
El controlador de grupos de recursos es un componente del Sincronizador de configuración que realiza un seguimiento de los recursos administrados y verifica si cada recurso individual está listo o conciliado. Las siguientes métricas están disponibles.
Nombre | Tipo | Etiquetas | Descripción |
---|---|---|---|
rg_reconcile_duration_seconds | Distribución | stallreason | La distribución del tiempo necesario para conciliar una CR de ResourceGroup |
resource_group_total | Último valor | La cantidad actual de la CR de ResourceGroup | |
resource_count | Último valor | resourcegroup | La cantidad total de recursos rastreados por un ResourceGroup |
ready_resource_count | Último valor | resourcegroup | La cantidad total de recursos listos en un ResourceGroup |
resource_ns_count | Último valor | resourcegroup | La cantidad de espacios de nombres que usan los recursos en un ResourceGroup |
cluster_scoped_resource_count | Último valor | resourcegroup | La cantidad de recursos con permisos de clúster en un ResourceGroup |
crd_count | Último valor | resourcegroup | La cantidad de CRD en un ResourceGroup |
kcc_resource_count | Último valor | resourcegroup | La cantidad total de recursos KCC en un ResourceGroup |
pipeline_error_observed | Último valor | name, reconciler, component | El estado de los recursos personalizados de RootSync y RepoSync Un valor de 1 indica un error. |
Etiquetas de métricas del Sincronizador de configuración
Las etiquetas de métricas se pueden usar para agregar datos de métricas en Cloud Monitoring y Prometheus. Se pueden seleccionar en la lista desplegable “Agrupar por” en la consola de Monitoring.
Para obtener más información sobre la etiqueta de Cloud Monitoring y la etiqueta de métrica de Prometheus, consulta los Componentes del modelo de métrica y el Modelo de datos de Prometheus.
Etiquetas de métricas
El Sincronizador de configuración y las métricas del controlador de grupos de recursos usan las siguientes etiquetas, disponibles cuando se supervisan con Cloud Monitoring y Prometheus.
Nombre | Valores | Descripción |
---|---|---|
operation |
crear, aplicar parche, actualizar, borrar | El tipo de operación que se realizó |
status |
correcto, error | El estado de ejecución de una operación |
reconciler |
rootsync, repositoriosync | El tipo de conciliador |
source |
analizador, diferente, remediador | La fuente del error interno |
trigger |
reintento, watchUpdate, managementConflict, resync, reimportación | El activador de un evento de conciliación |
name |
El nombre del conciliador | El nombre del conciliador |
component |
análisis, fuente, sincronización, renderización, preparación | El nombre del componente o la etapa actual de la conciliación |
container |
conciliador, git-sync | El nombre del contenedor |
resource |
cpu, memoria | El tipo de recurso |
controller |
aplicador, remediador | El nombre del controlador en un conciliador raíz o de espacio de nombres |
type |
Cualquier recurso de Kubernetes, por ejemplo, ClusterRole, Namespace, NetworkPolicy, Role, etcétera. | El tipo de API de Kubernetes |
commit |
---- | El hash de la última confirmación sincronizada |
Etiquetas de recursos
Las métricas del Sincronizador de configuración enviadas a Prometheus y Cloud Monitoring tienen las siguientes etiquetas de métricas configuradas para identificar el Pod de origen:
Nombre | Descripción |
---|---|
k8s.node.name |
El nombre del nodo que aloja un Pod de Kubernetes |
k8s.pod.namespace |
El espacio de nombres del Pod |
k8s.pod.uid |
El UID del Pod |
k8s.pod.ip |
La IP del Pod |
k8s.deployment.name |
El nombre de la implementación a la que pertenece el Pod |
Las métricas del Sincronizador de configuración enviadas a Prometheus y Cloud Monitoring desde los Pods reconciler
también tienen las siguientes etiquetas de métricas configuradas para identificar el RootSync o RepoSync que se usa para configurar el conciliador:
Nombre | Descripción |
---|---|
configsync.sync.kind |
El tipo de recurso que configura este conciliador: RootSync o RepoSync |
configsync.sync.name |
El nombre de RootSync o RepoSync que configura este conciliador |
configsync.sync.namespace |
El espacio de nombres de RootSync o RepoSync que configura este conciliador |
Etiquetas de recursos de Cloud Monitoring
Las etiquetas de recursos de Cloud Monitoring se usan para indexar métricas en el almacenamiento, lo que significa que tienen un efecto insignificante en la cardinalidad, a diferencia de las etiquetas de las métricas, en las que la cardinalidad es un problema de rendimiento importante. Consulta los tipos de recursos supervisados para obtener más información.
El tipo de recurso k8s_container
establece las siguientes etiquetas de recursos para identificar el contenedor de origen:
Nombre | Descripción |
---|---|
container_name |
El nombre del contenedor |
pod_name |
El nombre del Pod |
namespace_name |
El espacio de nombres del Pod |
location |
La región o zona del clúster que aloja el nodo |
cluster_name |
El nombre del clúster que aloja el nodo |
project |
El ID del proyecto que aloja el clúster |
Comprende la métrica pipeline_error_observad
La métrica pipeline_error_observed
es una métrica que puede ayudarte a identificar con rapidez los CR de RepoSync o RootSync que no estén sincronizados o contengan recursos que no se concilian con el estado deseado.
Para una sincronización exitosa de RootSync o RepoSync, las métricas con todos los componentes (
rendering
,source
,sync
,readiness
) se observan con el valor 0.Cuando la última confirmación falla en la renderización automatizada, la métrica con el componente
rendering
se observa con el valor 1.Cuando en la revisión de la confirmación más reciente ocurren errores o la última confirmación contiene una configuración no válida, la métrica con el componente
source
se observa con el valor 1.Cuando algún recurso no se aplica al clúster, la métrica con el componente
sync
se observa con el valor 1.Cuando se aplica un recurso, pero no alcanza su estado deseado, la métrica con el componente
readiness
se observa con el valor 1. Por ejemplo, una implementación se aplica al clúster, pero los Pods correspondientes no se crean con éxito.
¿Qué sigue?
- Obtén más información sobre cómo supervisar objetos RootSync y RepoSync.
- Obtén más información sobre cómo usar los SLI del Sincronizador de configuración.