Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Anular los argumentos del umbral del monitor a través de anotaciones de Kubernetes

Descripción general

SUSE Observability proporciona monitores listos para usar, que ofrecen monitoreo de problemas comunes que pueden ocurrir en un clúster de Kubernetes. Esos monitores funcionan con ciertos argumentos predeterminados que se adaptan a la mayoría de los casos de uso, pero a veces es necesario adaptar su comportamiento anulando algunos de esos argumentos predeterminados como threshold o failureState. El mecanismo para declarar las anulaciones es a través de anotaciones de recursos de Kubernetes que indican a qué monitor y componente deben aplicarse. Por ejemplo, podríamos anular el failureState para el monitor Available service endpoints para un servicio específico donde queremos señalar un estado CRITICAL cuando falla en lugar del DEVIATING predeterminado.

Instrucciones

Como ejemplo, los pasos anularán los argumentos para el monitor Available service endpoints de los servicios HTTP de Kubernetes.

Instrucciones para construir mi anotación

Las claves de anotaciones de anulación para los monitores de SUSE Observability siguen la siguiente convención:

monitor.${owner}.stackstate.io/${monitorShorName}

La propiedad owner representa quién creó dicho monitor, para los monitores listos para usar es kubernetes-v2, y la propiedad monitorShorName representa el id del monitor y se puede extraer de la propiedad identifier de un monitor que se puede leer desde la CLI al listar o inspeccionar monitores.

sts monitor list

ID              | STATUS  | IDENTIFIER                                                                          | NAME                                        | FUNCTION ID     | TAGS
8051105457030   | ENABLED | urn:stackpack:kubernetes-v2:shared:monitor:kubernetes-v2:service-available-endpoint | Available service endpoints                 | 233276809885571 | [services]

En nuestro ejemplo, el identificador es urn:stackpack:kubernetes-v2:shared:monitor:kubernetes-v2:service-available-endpoint y el monitorShorName corresponde al último segmento como en service-available-endpoint, por lo tanto, la clave de anotación es:

monitor.kubernetes-v2.stackstate.io/service-available-endpoint

La carga útil de la anotación es un objeto JSON donde se pueden definir los siguientes argumentos opcionales:

  • threshold: opcional. Un umbral numérico para comparar.

  • failureState: opcional. Ya sea "CRÍTICO" o "DESVIADO". "CRÍTICO" se mostrará en rojo en SUSE Observability y "DESVIADO" en naranja, para denotar diferentes severidades.

  • enabled: opcional. Booleano que determina si el monitor produciría un estado de salud para ese componente.

La anotación completa se vería así

    monitor.kubernetes-v2.stackstate.io/service-available-endpoint: |-
      {
        "threshold": 0.0,
        "failureState": "CRITICAL",
        "enabled": true
      }

¿Qué monitores permiten anular argumentos?

Construir una anulación para un monitor personalizado

Cualquier monitor de umbral personalizado creado utilizando la guía en Añadir un monitor de umbral a los componentes utilizando la CLI es adecuado para anular argumentos, ya que el ejemplo muestra que un identificador para un monitor personalizado se estructura como urn:custom:monitor:{monitorShortName} y se espera que la clave de anotación de anulación para tal identificador sea

monitor.custom.stackstate.io/${monitorShortName}

El ejemplo utiliza el identificador urn:custom:monitor:deployment-has-replicas, por lo tanto, la clave de anotación sería

monitor.custom.stackstate.io/deployment-has-replicas

Y la anotación completa se vería como

    monitor.custom.stackstate.io/deployment-has-replicas: |-
      {
        "threshold": 0.0,
        "failureState": "CRITICAL"
        "enabled": true
      }