Información general

El Datadog Agent y Cluster Agent pueden recuperar recursos de Kubernetes para Orchestrator Explorer. Esta función te permite monitorizar el estado de pods, despliegues y otros conceptos de Kubernetes en espacios de nombres o zonas de disponibilidad específicos, ver especificaciones de recursos para pods fallidos en una implementación, correlacionar la actividad del nodo con logs relacionados y más.

Orchestrator Explorer requiere la versión del Agent 7.27.0, o una posterior, y la versión del Cluster Agent 1.11.0, o una posterior.

Nota: En el caso de la versión de Kubernetes 1.25 y posteriores, la versión mínima requerida del Cluster Agent es la 7.40.0.

Configuración

Asegúrate de haber habilitado el Process Agent. Si utilizas el Datadog Operator o el Helm chart oficial, Orchestrator Explorer se encuentra habilitado de forma predeterminada.

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>
      appKey: <DATADOG_APP_KEY>
  features:
    orchestratorExplorer:
      enabled: true

datadog:
  # (...)
  processAgent:
    enabled: true
  orchestratorExplorer:
    enabled: true

Uso

Vistas

Alterna entre Pods, Clusters (Clústeres), Namespaces (Espacios de nombres) y otros recursos de Kubernetes en el menú desplegable Select Resources (Seleccionar recursos) en la esquina superior izquierda de la página.

Cada una de estas vistas incluye una tabla de datos para ayudarte a organizar mejor tus datos por campo, como estado, nombre y etiquetas (tags) de Kubernetes, y un mapa de clústeres detallado para brindarte panorama más amplio de tus pods y clústeres de Kubernetes.

Consulta los Detalles del filtro de consulta para obtener más detalles sobre cómo filtrar estas vistas.

Agrupar por funcionalidad y facetas

Agrupa los pods por etiquetas (tags), etiquetas (labels) de Kubernetes o anotaciones de Kubernetes para obtener una vista agregada que te permita encontrar información con mayor rapidez. Puedes crear un grupo con la barra «Group by» (Agrupar por) en la parte superior derecha de la página o al hacer clic en una etiqueta (tag) o etiqueta (label) en particular y ubicar la función agrupar por en el menú contextual como se muestra a continuación.

También puedes utilizar facetas en el lado izquierdo de la página para agrupar recursos o filtrar los recursos que más te interesen, como pods con un estado de pod CrashLoopBackOff.

Mapa de clústeres

Un mapa de clústeres te brinda un panorama más amplio de tus pods y clústeres de Kubernetes. Puedes ver todos tus recursos juntos en una pantalla con grupos y filtros personalizados, y elegir las métricas para rellenar el color de los nodos.

Examina los recursos de los mapas de clústeres al hacer clic en cualquier círculo o grupo para completar un panel detallado.

Panel de información

Haz clic en cualquier fila de la tabla o en cualquier objeto en un mapa de clústeres para ver información sobre un recurso específico en un panel lateral.

La pestaña YAML del panel lateral muestra la definición completa del recurso. A partir de la versión del Agent 7.44.0, también incluye siete días de historial de definiciones. Puedes comparar lo que cambió con el tiempo y en diferentes versiones. La hora indicada es aproximada a cuando se aplicaron los cambios al recurso.

Para evitar mostrar una gran cantidad de cambios irrelevantes, se ignoran las actualizaciones que afectan solo a los siguientes campos:

• metadata.resourceVersion
• metadata.managedFields
• metadata.generation
• status

Las demás pestañas muestran más información para solucionar problemas del recurso seleccionado:

• Logs: consulta logs de tu contenedor o recurso. Haz clic en cualquier log para ver los logs relacionados en el Explorador de logs.
• APM: consulta trazas (traces) de tu contenedor o recurso, incluida la fecha, el servicio, la duración, el método y el código de estado de una traza.
• Metrics (Métricas): consulta métricas en directo para tu contenedor o recurso. Puedes ver cualquier gráfica en pantalla completa, compartir una snapshot de esta o exportarla desde esta pestaña.
• Processes (Procesos): consulta todos los procesos que se ejecutan en el contenedor de este recurso.
• Network (Red): consulta el rendimiento de la red de un contenedor o recurso, incluidos los campos de origen, destino, volumen enviado y recibido, y rendimiento. Utiliza el campo Destination (Destino) para buscar por etiquetas como DNS o ip_type, o utiliza el filtro Group by (Agrupar por) en esta vista a fin de agrupar datos de red por etiquetas, como pod_name o service.
• Events (Eventos): consulta todos los eventos de Kubernetes para tu recurso.
• Monitors (Monitores): consulta los monitores etiquetados, con contexto o agrupados para este recurso.

Para obtener un dashboard detallado de este recurso, haz clic en View Dashboard (Ver dashboard) en la esquina superior derecha de este panel.

Utilización de recursos

Para ver la página de utilización de recursos, consulta Utilización de recursos.

En la pestaña del Explorador de Kubernetes, puedes explorar una selección de métricas de utilización de recursos.

Todas estas columnas admiten la clasificación, lo que te ayuda a identificar cargas de trabajo individuales en función de su utilización de recursos.

Detalles del filtro de consulta

Puedes limitar los recursos que se muestran al proporcionar una consulta en la barra de búsqueda «Filter by» (Filtrar por) en la parte superior izquierda de la página.

Sintaxis

Un filtro de consulta se compone de términos y operadores. Por ejemplo:

Términos

Existen varios tipos de términos:

Nota: Es posible que encuentres los mismos pares clave-valor como etiqueta (tag) y etiqueta (label) (o anotación); esto depende de cómo se haya configurado tu clúster.

Los siguientes atributos de recursos se admiten en la coincidencia de cadenas arbitraria:

• metadata.name
• metadata.uid
• Direcciones IP encontradas en:
  • Pods
  • Nodos (internos y externos)
  • Servicios (IPs de clúster, externas y de equilibrador de carga)

No es necesario que especifiques una clave para buscar un recurso por nombre o IP. No se requieren comillas a menos que tu búsqueda de cadenas incluya ciertos caracteres especiales.

Comparadores

Todos los términos respaldan el operador de igualdad :. Los términos de valor de métrica también admiten comparaciones numéricas:

• :> Mayor que (por ejemplo, metric#cpu_usage_avg15:>0.9)
• :>= Mayor o igual que
• :< Menor que
• :<= Menor o igual que

Operadores

Para combinar varios términos en una consulta compleja, puedes utilizar cualquiera de los siguientes operadores booleanos que distinguen entre mayúsculas y minúsculas:

OR abreviatura del valor

Se pueden combinar varios términos que comparten la misma clave en un solo término si todos utilizan el operador OR. Por ejemplo, esta consulta:

app_name:web-server OR app_name:database OR app_name:event-consumer

Puede reducirse a:

app_name:(web-server OR database OR event-consumer)

Comodines

Puedes utilizar comodines * como parte de un término a fin de filtrar por coincidencias parciales, tanto para valores como para claves. Algunos ejemplos:

• kube_job:stats-*: encuentra todos los recursos con un valor de etiqueta kube_deployment que comience con stats-.
• pod_name:*canary: encuentra todos los recursos con un valor pod_name que termine en canary..
• label#release:*: encuentra todos los recursos con una etiqueta (label) release, independientemente de su valor.
• -label#*.datadoghq.com/*: encuentra recursos que no tengan ninguna etiqueta (label) con contexto de Datadog.
• kube_*:*stats*canary: encuentra recursos que tengan etiquetas de recursos relacionados (kube_*), con stats en el medio del valor y que también terminen en canary.

Etiquetas extraídas

Además de las etiquetas que has configurado dentro del Datadog Agent, Datadog inyecta etiquetas generadas basadas en atributos de recursos que pueden ayudarte con tus necesidades de búsqueda y agrupación. Estas etiquetas se añaden a los recursos de manera condicional, cuando son relevantes.

Todos los recursos

Todos los recursos tienen la etiqueta kube_cluster_name y todos los recursos con espacios de nombres tienen añadida la etiqueta kube_namespace.

Además, los recursos contienen una etiqueta kube_<api_kind>:<metadata.name>. Por ejemplo, a un despliegue denominado web-server-2 se le añadiría de manera automática la etiqueta kube_deployment:web-server-2.

Nota: Hay algunas excepciones a este patrón:

• Los pods utilizan pod_name en su lugar.
• VPAs: verticalpodautoscaler.
• VPHs: horizontalpodautoscaler.
• Demanda de volumen persistente: persistentvolumeclaim.

En función de las etiquetas (labels) adjuntas al recurso, también se extraerán las siguientes etiquetas (tags):

Relaciones

Los recursos relacionados se etiquetarán entre sí. Algunos ejemplos son:

• Un pod que sea parte del despliegue «XYZ» tendrá una etiqueta kube_deployment:xyz.
• Una entrada que se dirija al servicio «A» tendrá una etiqueta kube_service:a.

Los recursos que se generan a partir de recursos «principales» tendrán las etiquetas kube_ownerref_kind y kube_ownerref_name (como pods y trabajos).

Consejo: Utiliza la función de autocompletar consultas de filtro para descubrir qué etiquetas de recursos relacionados se encuentran disponibles. Escribe kube_ y conoce qué resultados se sugieren.

Pods

Los pods reciben las siguientes etiquetas:

• pod_name
• pod_phase (extraído del manifiesto)
• pod_status (calculado de forma similar a kubectl)

Cargas de trabajo

Los recursos de carga de trabajo (pods, despliegues, conjuntos con estado, etc.) tendrán las siguientes etiquetas, que indican su compatibilidad dentro de la página de utilización de recursos:

• resource_utilization (supported o unsupported)
• missing_cpu_requests
• missing_cpu_limits
• missing_memory_requests
• missing_memory_limits

Condiciones

Algunas condiciones, para algunos recursos, se extraen como etiquetas. Por ejemplo, puedes encontrar la etiqueta kube_condition_available en los despliegues. El formato de la etiqueta siempre es kube_condition_<name> con un valor true o false.

Consejo: Utiliza la función de autocompletar para descubrir qué condiciones se encuentran disponibles en un tipo de recurso determinado al ingresar kube_condition y revisar los resultados.

Etiquetas específicas de recursos

Algunos recursos tienen etiquetas específicas que se extraen en función del entorno de tu clúster. Las siguientes etiquetas se encuentran disponibles junto con las etiquetas que se compartieron anteriormente.

Filtros de utilización de recursos

Los siguientes recursos de carga de trabajo están enriquecidos con métricas de utilización de recursos:

• Clústeres
• Daemonsets
• Despliegues
• Nodos
• Pods
• Conjuntos de réplicas
• Conjuntos con estado

Estas métricas se calculan en el momento de la recopilación, en función de los valores promedio de los últimos 15 minutos. Puedes filtrar por valores de métrica de esta manera:metric#<metric_name><comparator><numeric_value>.

• metric_name es una métrica disponible (consulta más abajo)
• comparator es un comparador compatible
• y numeric_value es un valor de coma flotante.

Para estos recursos de carga de trabajo, se encuentran disponibles los siguientes nombres de métrica:

Además, los clústeres y nodos tienen disponibles las siguientes métricas:

• cpu_usage_pct_alloc_avg15
• cpu_requests_pct_alloc_avg15
• mem_usage_pct_alloc_avg15
• mem_requests_pct_alloc_avg15

Unidades de métrica

Las métricas de CPU se almacenan como varios núcleos.

Las métricas de memoria se almacenan como bytes.

Los porcentajes (*_pct_*) se almacenan como flotantes, donde 0.0 es 0 % y 1.0 es 100 %. El valor es la relación de las dos métricas indicadas; por ejemplo, cpu_usage_pct_limits_avg15 es el valor de usage / limits. Los valores de métrica pueden estar por encima del 100 %, como el porcentaje de uso de CPU de las solicitudes.

Notas y problemas conocidos

• Los datos se actualizan de manera automática en intervalos constantes. Los intervalos de actualización pueden cambiar durante la versión beta.
• En clústeres con más de 1000 despliegues o ReplicaSets, es posible que observes un uso elevado de CPU por parte del Cluster Agent. Hay una opción para deshabilitar la limpieza de contenedores en el Helm chart. Consulta el repositorio de Helm chart para obtener más detalles.