Información general

Este check monitoriza Kube_apiserver_metrics.

Configuración

Instalación

El check Kube_apiserver_metrics está incluido en el paquete del Datadog Agent, por lo que no necesitas instalar nada más en tu servidor.

Configuración

Si tu clúster de Kubernetes tiene nodos maestros y está ejecutando un pod y un contenedor para la imagen kube-apiserver, el Datadog Agent detecta automáticamente este pod y configura la integración relativa a tu archivo kube_apiserver_metrics.d/auto_conf.yaml.

Sin embargo, si usas una distribución de Kubernetes gestionada como GKE, EKS o AKS, es posible que no tengas un pod kube-apiserver en ejecución para que el Agent lo detecte.

En este caso, puedes configurar la integración con el servicio kubernetes en el espacio de nombres default.

• El caso de uso principal para ejecutar el check kube_apiserver_metrics es como un Check a nivel de clúster.
• Puedes hacerlo con anotaciones en tu servicio, o utilizando un archivo local a través del Datadog Operator, el Helm chart o manualmente.
• Para recopilar métricas, establece los siguientes parámetros y valores en una plantilla de Autodiscovery.

Puedes revisar todas las opciones de configuración disponibles en kube_apiserver_metrics.yaml.

Servicio de anotaciones

Puedes anotar el servicio de Kubernetes en tu espacio de nombres default con lo siguiente:

ad.datadoghq.com/endpoints.checks: |
  {
    "kube_apiserver_metrics": {
      "instances": [
        {
          "prometheus_url": "https://%%host%%:%%port%%/metrics"
        }
      ]
    }
  }

annotations:
  ad.datadoghq.com/endpoints.check_names: '["kube_apiserver_metrics"]'
  ad.datadoghq.com/endpoints.init_configs: '[{}]'
  ad.datadoghq.com/endpoints.instances:
    '[{ "prometheus_url": "https://%%host%%:%%port%%/metrics"}]'

A continuación, el Datadog Cluster Agent programa los checks de cada endpoint en Datadog Agent(s).

Archivo local

También puedes ejecutar el check configurando los endpoints directamente en el archivo kube_apiserver_metrics.yaml, en la carpeta conf.d/ de la raíz del directorio de configuración del Agent para enviarlo como un Check de clúster.

Nota: Debes añadir cluster_check: true a tu archivo de configuración si usas un archivo local o ConfigMap para configurar los checks de clúster.

Proporciona una configuración a tu Cluster Agent para configurar un check de clúster:

clusterAgent:
  confd:
    kube_apiserver_metrics.yaml: |-
      advanced_ad_identifiers:
        - kube_endpoints:
            name: "kubernetes"
            namespace: "default"
      cluster_check: true
      init_config:
      instances:
        - prometheus_url: "https://%%host%%:%%port%%/metrics"

spec:
#(...)
  override:
    clusterAgent:
      extraConfd:
        configDataMap:
          kube_apiserver_metrics.yaml: |-
            advanced_ad_identifiers:
              - kube_endpoints:
                  name: "kubernetes"
                  namespace: "default"
            cluster_check: true
            init_config:
            instances:
              - prometheus_url: "https://%%host%%:%%port%%/metrics"

Estas configuraciones hacen que el Agent realice una solicitud al servicio kubernetes en el espacio de nombres default en sus direcciones IP de endpoint y puerto definidos.

Validación

Ejecuta el subcomando de estado del Agent y busca kube_apiserver_metrics en la sección Checks.

Datos recopilados

Métricas

Checks de servicio

Kube_apiserver_metrics no incluye checks de servicios.

Eventos

Kube_apiserver_metrics no incluye eventos.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.