Monitorización de la API de KRM monitoring.gdc.goog/v1

monitoring.gdc.goog/v1

Contiene definiciones de esquemas de API para el grupo Monitoring.

AlertRule

Define la configuración de las reglas de alerta.

Aparece en: - MonitoringRuleSpec

Campo Descripción
alert string Nombre de la alerta. Su valor debe ser un valor de etiqueta válido.
expr string Expresión PromQL o LogQL para evaluar la regla de alerta.
for string Duración en segundos durante la cual se debe cumplir la condición especificada para que la alerta pase del estado pendiente al estado abierto.
labels objeto (claves:cadena, valores:cadena) Las etiquetas que se van a añadir o sobrescribir. Las etiquetas obligatorias de este campo son severity: [error, critical, warning, info], code: <short code for the error> y resource: <component, service, or hardware related to the alert>. Las etiquetas adicionales son opcionales.
annotations objeto (claves:cadena, valores:cadena) Las anotaciones que se van a añadir.

ClusterStatus

ClusterStatus es una lista de condiciones que afectan a un clúster específico.

Aparece en: - MonitoringTargetStatus

Campo Descripción
cluster string
conditions Array de condiciones

MonitoringRule

Define el esquema de la API Monitoring Rules.

Aparece en: - MonitoringRuleList

Campo Descripción
apiVersion string monitoring.gdc.goog/v1
kind string MonitoringRule
metadata ObjectMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
spec MonitoringRuleSpec
status MonitoringRuleStatus

MonitoringRuleList

Contiene una lista de reglas de monitorización.

Campo Descripción
apiVersion string monitoring.gdc.goog/v1
kind string MonitoringRuleList
metadata ListMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
items Matriz MonitoringRule

MonitoringRuleSpec

Define la especificación o el estado esperado del objeto MonitoringRule.

Aparece en: - MonitoringRule

Campo Descripción
interval string Intervalo de evaluación de reglas.
limit entero El número máximo de alertas. El valor 0 significa que no hay límite.
recordRules RecordRule Lista de reglas de registro.
alertRules AlertRule Lista de reglas de alerta.

MonitoringRuleStatus

Define el estado observado del objeto MonitoringRule.

Aparece en: - MonitoringRule

Campo Descripción
conditions Array de condiciones Define el estado observado del objeto MonitoringRule.
errorStatus ErrorStatus ErrorStatus contiene una lista de errores actuales y la marca de tiempo en la que se actualiza este campo.

MonitoringTarget

Define el esquema de la API de destinos de monitorización.

Aparece en: - MonitoringTargetList

Campo Descripción
apiVersion string monitoring.gdc.goog/v1
kind string MonitoringTarget
metadata ObjectMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
spec MonitoringTargetSpec
status MonitoringTargetStatus

MonitoringTargetList

Contiene una lista de objetivos de monitorización.

Campo Descripción
apiVersion string monitoring.gdc.goog/v1
kind string MonitoringTargetList
metadata ListMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
items Matriz MonitoringTarget

MonitoringTargetMetricsRelabeling

Define un filtro para conservar o descartar métricas en función de las etiquetas.

Aparece en: - MonitoringTargetPodMetricsEndpoints

Campo Descripción
sourceLabels matriz de cadenas Los valores seleccionados de las etiquetas. El contenido se concatena mediante separator y se compara con la expresión regex de las acciones replace, keep y drop.
separator string Valor del separador colocado entre los valores de las etiquetas de origen concatenadas.
regex string Expresión regular con la que debe coincidir el valor extraído.
action string La acción que se debe realizar cuando la expresión regex coincide con el valor extraído.
targetLabel string La etiqueta en la que se escribirá el valor resultante en una acción replace. Este campo es obligatorio para las acciones replace. Se pueden usar grupos de captura de expresiones regulares.
replacement string El valor de sustitución que se usará si la expresión regular coincide con el valor extraído en una acción replace. Se pueden usar grupos de captura de expresiones regulares.

MonitoringTargetPodMetricsEndpoints

Configura los endpoints de métricas de los pods raspados.

Aparece en: - MonitoringTargetSpec

Campo Descripción
port MonitoringTargetPodMetricsPort Puerto desde el que se recogen las métricas.
path MonitoringTargetPodMetricsPath La ruta desde la que se recogen las métricas.
scheme MonitoringTargetPodMetricsScheme El esquema que se va a usar al raspar métricas.
params objeto (claves:cadena, valores:array de cadenas) Los parámetros de consulta que se van a usar al raspar métricas de path.
scrapeInterval string Frecuencia con la que Prometheus rastrea los endpoints de métricas definidos en el campo podMetricsEndpoints.
scrapeTimeout string Tiempo que espera Prometheus para recibir la respuesta de los endpoints de métricas definidos en el campo podMetricsEndpoints.
metricsRelabelings Matriz MonitoringTargetMetricsRelabeling Filtro para incluir (allowlist) o excluir (denylist) métricas en función de las etiquetas.
ipAddresses matriz de cadenas IPAddress se usa para configurar direcciones IP estáticas para el raspado.
tlsConfig TLSConfig Proporciona una configuración de TLS personalizada. Se proporciona para las cargas de trabajo que no están en Kubernetes y que deben rasparse.
authCredential string Credenciales que se deben proporcionar al endpoint de raspado.

MonitoringTargetPodMetricsPath

Determina la ruta que se va a usar para obtener métricas de los pods.

Aparece en: - MonitoringTargetPodMetricsEndpoints

Campo Descripción
value string Ruta desde la que se recopilan las métricas. Si se proporcionan anotaciones, tienen prioridad sobre este campo.
annotation string Ruta para recoger métricas mediante anotaciones.

MonitoringTargetPodMetricsPort

Determina el puerto que se va a usar para obtener métricas de los pods.

Aparece en: - MonitoringTargetPodMetricsEndpoints

Campo Descripción
value entero Puerto del que se recogen las métricas. Si se proporcionan anotaciones, tienen prioridad sobre este campo.
annotation string Puerto desde el que se recogen métricas mediante anotaciones.

MonitoringTargetPodMetricsScheme

Determina el esquema que se va a usar para obtener métricas de los pods.

Aparece en: - MonitoringTargetPodMetricsEndpoints

Campo Descripción
value string Es el esquema que se usa al recoger métricas. Si se proporcionan anotaciones, tienen prioridad sobre este campo.
annotation string Es el esquema que se usa al recoger métricas mediante anotaciones.

MonitoringTargetSelectors

Proporciona selectores que determinan qué pods se deben monitorizar.

Aparece en: - MonitoringTargetSpec

Campo Descripción
matchClusters matriz de cadenas Los clústeres que se deben tener en cuenta para este trabajo. La configuración predeterminada consiste en tener en cuenta todos los clústeres aplicables al proyecto. La relación entre los diferentes clústeres es una relación OR. Por ejemplo, el valor ["admin", "system"] indica que se debe considerar el clúster de administrador OR como clúster del sistema.
matchLabels objeto (claves:cadena, valores:cadena) Etiquetas de pod que se van a tener en cuenta para este trabajo. La configuración predeterminada es no tener en cuenta ningún filtro basado en etiquetas. La relación entre los distintos pares es AND, por lo que se tienen en cuenta todos los pares.
matchAnnotations objeto (claves:cadena, valores:cadena) Anotaciones que se van a tener en cuenta en este trabajo. La configuración predeterminada es no tener en cuenta ningún filtro basado en anotaciones. La relación entre los distintos pares es AND, por lo que se tienen en cuenta todos los pares.

MonitoringTargetSpec

Define la especificación o el estado esperado del objeto MonitoringTarget.

Aparece en: - MonitoringTarget

Campo Descripción
selector MonitoringTargetSelectors Patrón coincidente que identifica los pods de este trabajo. Para establecer una relación entre diferentes selectores, usa AND.
podMetricsEndpoints MonitoringTargetPodMetricsEndpoints El endpoint expuesto para este trabajo. El endpoint usa el estilo de Prometheus.

MonitoringTargetStatus

Define el estado observado del objeto MonitoringTarget.

Aparece en: - MonitoringTarget

Campo Descripción
conditions Array de condiciones Lista de las condiciones observadas en la pila de monitorización.
clusterStatuses ClusterStatus ClusterStatuses es una lista de cada clúster y las condiciones observadas en la pila de monitorización de ese clúster.

RecordRule

Define la configuración de las reglas de registro.

Aparece en: - MonitoringRuleSpec

Campo Descripción
record string La serie temporal en la que se va a escribir la regla de registro. Debe ser un nombre de métrica válido.
expr string Expresión PromQL o LogQL para evaluar la regla de registro.
labels objeto (claves:cadena, valores:cadena) Las etiquetas que se van a añadir o sobrescribir.

TLSConfig

Aparece en: - MonitoringTargetPodMetricsEndpoints

Campo Descripción
ca string Texto del certificado de AC que se va a usar en los destinos.
cert string Texto del archivo de certificado de cliente de los destinos.
server_name string Se usa para verificar el nombre de host de los destinos.