Los recursos personalizados de MonitoringTarget en Google Distributed Cloud (GDC) aislado te permiten etiquetar las métricas extraídas para diferenciar sus características y filtrar los datos de series temporales. Además de recoger métricas, puedes configurar reglas de cambio de etiquetas para dirigir las métricas a otro proyecto, añadir etiquetas de clave-valor personalizadas o cambiar el nombre de las métricas antes de la ingestión.
Cada combinación única de pares de etiquetas clave-valor crea una nueva serie temporal, lo que puede aumentar significativamente el almacenamiento de datos. Evita usar etiquetas para dimensiones de alta cardinalidad con muchos valores posibles, como IDs de usuario o direcciones de correo. Para obtener más información sobre el cambio de etiquetas de métricas, consulta cómo funciona el cambio de etiquetas en Prometheus.
Antes de empezar
Para gestionar recursos personalizados de MonitoringTarget, debes tener los permisos necesarios.
Solicitar roles de organización de gestión de identidades y accesos
Ponte en contacto con el admin. de la org. de gestión de identidades y accesos para solicitar los siguientes roles:
- Creador de objetivos de monitorización (
monitoringtarget-pa-creator): crea recursos personalizados deMonitoringTarget. - Editor de objetivos de monitorización (
monitoringtarget-pa-editor): edita o modifica recursos personalizados deMonitoringTarget. - Lector de objetivos de monitorización (
monitoringtarget-pa-viewer): permite ver recursos personalizados deMonitoringTarget.
Solicitar roles de proyecto de gestión de identidades y accesos
Ponte en contacto con el administrador de proyectos de gestión de identidades y accesos para solicitar los siguientes roles:
- Editor de MonitoringTarget (
monitoringtarget-editor): edita o modifica los recursos personalizados deMonitoringTargeten el espacio de nombres del proyecto. - Lector de MonitoringTarget (
monitoringtarget-viewer): consulta los recursos personalizados deMonitoringTargeten el espacio de nombres del proyecto.
Enviar métricas a otro proyecto
Los autores de contenedores pueden programar métricas específicas para que se envíen a un proyecto diferente, incluso a proyectos que no sean de su propiedad. Para enviar una métrica a un proyecto específico, añade la etiqueta _gdch_project a la métrica en tu código y asigna el nombre del proyecto de destino como valor.
También puedes usar el recurso personalizado MonitoringTarget para enviar todos los datos de métricas recogidos a otro proyecto. Define la etiqueta _gdch_project como etiqueta de destino en el campo metricsRelabelings, con el nuevo nombre del proyecto como valor de sustitución.
En el siguiente código de ejemplo se muestra cómo definir la etiqueta de destino _gdch_project en el recurso personalizado MonitoringTarget para enviar métricas al proyecto llamado another-project-name:
apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
# Choose the same namespace as the workload pods.
namespace: PROJECT_NAMESPACE
name: MONITORING_TARGET_NAME
spec:
# [...]
podMetricsEndpoints:
# [...]
metricsRelabelings:
- action: replace
targetLabel: _gdch_project
replacement: another-project-name
# [...]
Haz los cambios siguientes:
PROJECT_NAMESPACE: el espacio de nombres de tu proyecto.MONITORING_TARGET_NAME: el nombre del archivo de definición deMonitoringTarget.
Añadir nuevas etiquetas a las métricas
Las etiquetas ayudan con la observabilidad y la monitorización, ya que identifican las características de las métricas. Puedes añadir etiquetas que los contenedores extraídos no muestran inicialmente. En el recurso personalizado MonitoringTarget, define la nueva etiqueta como objetivo y proporciona un valor de sustitución. Este par clave-valor se añade a todas las métricas que recoge el recurso.
En el siguiente código de ejemplo se muestra cómo definir la etiqueta de destino my_new_label y configurar su valor como my_label_value en el recurso personalizado MonitoringTarget:
apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
# Choose the same namespace as the workload pods.
namespace: PROJECT_NAMESPACE
name: MONITORING_TARGET_NAME
spec:
# [...]
podMetricsEndpoints:
# [...]
metricsRelabelings:
- action: replace
targetLabel: my_new_label
replacement: my_label_value
# [...]
Haz los cambios siguientes:
PROJECT_NAMESPACE: el espacio de nombres de tu proyecto.MONITORING_TARGET_NAME: el nombre del archivo de definición deMonitoringTarget.
Cambiar el nombre de una métrica
Puedes cambiar el nombre de la métrica de un contenedor con el recurso MonitoringTarget. Define el nombre de la métrica original y su sustitución en el campo metricsRelabelings.
El nombre original se trata como una expresión regular (regex) y se sustituye por el nuevo nombre.
En el siguiente código de ejemplo se muestra cómo sustituir el nombre de la métrica cpu_usage (regex) por cpu_usage_new_name en el recurso personalizado MonitoringTarget:
apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
# Choose the same namespace as the workload pods.
namespace: PROJECT_NAMESPACE
name: MONITORING_TARGET_NAME
spec:
# [...]
podMetricsEndpoints:
# [...]
metricsRelabelings:
- action: replace
regex: cpu_usage
replacement: cpu_usage_new_name
sourceLabels: [__name__]
targetLabel: __name__
# [...]
Haz los cambios siguientes:
PROJECT_NAMESPACE: el espacio de nombres de tu proyecto.MONITORING_TARGET_NAME: el nombre del archivo de definición deMonitoringTarget.