Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Detector de problemas del nodo

El detector de problemas del nodo es una biblioteca de código abierto que supervisa el estado de los nodos y detecta problemas comunes de los nodos, como problemas de hardware, kernel o entorno de ejecución de contenedores. En Google Distributed Cloud, se ejecuta como un systemd servicio en cada nodo.

El detector de problemas de nodos está habilitado de forma predeterminada a partir de la versión 1.10.0 de Google Distributed Cloud.

Si necesitas asistencia adicional, comunícate con Atención al cliente de Cloud. También puedes consultar Obtén asistencia para obtener más información sobre los recursos de asistencia, incluidos los siguientes:

Requisitos para abrir un caso de asistencia
Herramientas para ayudarte a solucionar problemas, como la configuración de tu entorno, los registros y las métricas
Componentes compatibles.

¿Qué problemas detecta?

El detector de problemas del nodo puede detectar los siguientes tipos de problemas:

Problemas de entorno de ejecución del contenedor, como daemons de entorno de ejecución que no responden
Problemas de hardware, como fallas de CPU, memoria o disco
Problemas de kernel, como condiciones de interbloqueo de kernel o sistemas de archivos dañados

Se ejecuta en un nodo y, además, informa problemas al servidor de la API de Kubernetes como NodeCondition o como un Event. NodeCondition es un problema que hace que un nodo no pueda ejecutar Pods, mientras que Event es un problema temporal que tiene un efecto limitado en los Pods, pero se considera lo suficientemente importante como para informarlo.

En la siguiente tabla, se describen las NodeConditions que detecta el detector de problemas del nodo y si se pueden reparar automáticamente:

Condición	Motivo	Reparación automática compatible¹
`KernelDeadlock`	Los procesos del kernel están bloqueados y esperan que otros procesos del kernel liberen los recursos necesarios.	No
`ReadonlyFilesystem`	El clúster no puede escribir en el sistema de archivos debido a un problema, como que el disco esté lleno.	No
`FrequentKubeletRestart`	Kubelet se reinicia con frecuencia, lo que impide que el nodo ejecute Pods de manera eficaz.	No
`FrequentDockerRestart`	El daemon de Docker se reinició más de 5 veces en 20 minutos.	No
`FrequentContainerdRestart`	El entorno de ejecución del contenedor se reinició más de 5 veces en 20 minutos.	No
`FrequentUnregisterNetDevice`	El nodo experimenta una anulación de registro frecuente de dispositivos de red.	No
`KubeletUnhealthy`	El nodo no funciona correctamente o no responde al plano de control.	No
`ContainerRuntimeUnhealthy`	El entorno de ejecución del contenedor no funciona correctamente, lo que impide que los Pods se ejecuten o programen en el nodo.	No
`CorruptDockerOverlay2`	Hay problemas o incoherencias en el sistema de archivos dentro del directorio del controlador de almacenamiento overlay2 de Docker.	No
`OrphanContainers`²	Se borró un Pod específico de un contenedor, pero el contenedor correspondiente aún existe en el nodo.	No
`FailedCgroupRemoval`²	Algunos cgroups están en estado congelado.	Sí

¹ Para las versiones 1.32 y posteriores, se admite la capacidad de reparar automáticamente los problemas detectados para condiciones seleccionadas.

² Compatible con las versiones 1.32 y posteriores.

Estos son algunos ejemplos de los tipos de Events que informó el detector de problemas de nodos:

Warning TaskHung node/vm-worker-1-user-a12fabb4a99cb92-ddfce8832fd90f6f.lab.anthos kernel: task docker:7 blocked for more than 300 seconds.
Warning KernelOops node/vm-worker-1-user-a12fabb4a99cb92-ddfce8832fd90f6f.lab.anthos kernel: BUG: unable to handle kernel NULL pointer dereference at 00x0.

¿Qué problemas repara?

A partir de la versión 1.32, cuando el detector de problemas del nodo descubre NodeConditions seleccionadas, puede reparar automáticamente el problema correspondiente en el nodo. A partir de la versión 1.32, la única NodeCondition que admite la reparación automática es FailedCgroupRemoval.

Cómo ver los problemas detectados

Ejecuta el siguiente comando kubectl describe para buscar NodeConditions y Events:

kubectl describe node NODE_NAME \
    --kubeconfig=KUBECONFIG

Reemplaza lo siguiente:

NODE_NAME: Es el nombre del nodo que estás verificando.
KUBECONFIG: Es la ruta del archivo kubeconfig del clúster.

Cómo habilitar y, luego, inhabilitar el detector de problemas del nodo

De forma predeterminada, el detector de problemas del nodo está habilitado, pero se puede inhabilitar en el recurso ConfigMap node-problem-detector-config. A menos que lo inhabilite de forma explícita, el detector de problemas del nodo supervisa continuamente los nodos para detectar condiciones específicas que indican problemas para el nodo.

Para inhabilitar el detector de problemas del nodo en un clúster determinado, sigue estos pasos:

Edita el recurso ConfigMap node-problem-detector-config:
```
kubectl edit configmap node-problem-detector-config \
    --kubeconfig=KUBECONFIG \
    --namespace=CLUSTER_NAMESPACE
```
Reemplaza lo siguiente:
- KUBECONFIG: Es la ruta del archivo kubeconfig del clúster.
- CLUSTER_NAMESPACE: Es el espacio de nombres del clúster en el que deseas habilitar el detector de problemas del nodo.
Este comando inicia automáticamente un editor de texto en el que puedes editar el recurso node-problem-detector-config.
Configura data.enabled como false en la definición del recurso node-problem-detector-config.
```
apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: "2025-04-19T21:36:44Z"
  name: node-problem-detector-config
...
data:
  enabled: "false"
```
Inicialmente, el ConfigMap node-problem-detector-config no tiene un campo data, por lo que es posible que debas agregarlo.
Para actualizar el recurso, guarda los cambios y cierra el editor.

Para volver a habilitar el detector de problemas del nodo, realiza los pasos anteriores, pero configura data.enabled como true en la definición del recurso node-problem-detector-config.

Cómo habilitar y, luego, inhabilitar la reparación automática

A partir de la versión 1.32, el detector de problemas del nodo verifica NodeConditions específicas y repara automáticamente el problema correspondiente en el nodo. De forma predeterminada, la reparación automática está habilitada para NodeConditions compatibles, pero se puede inhabilitar en el recurso ConfigMap node-problem-detector-config.

Para inhabilitar el comportamiento de reparación automática en un clúster determinado, sigue estos pasos:

Edita el recurso ConfigMap node-problem-detector-config:
```
kubectl edit configmap node-problem-detector-config \
    --kubeconfig=KUBECONFIG \
    --namespace=CLUSTER_NAMESPACE
```
Reemplaza lo siguiente:
- KUBECONFIG: Es la ruta del archivo kubeconfig del clúster.
- CLUSTER_NAMESPACE: Es el espacio de nombres del clúster en el que deseas habilitar el detector de problemas del nodo.
Este comando inicia automáticamente un editor de texto en el que puedes editar el recurso node-problem-detector-config.
Configura data.check-only como true en la definición del recurso node-problem-detector-config.
```
apiVersion: v1
kind: ConfigMap
metadata:
  creationTimestamp: "2025-04-19T21:36:44Z"
  name: node-problem-detector-config
...
data:
  enabled: "true"
  check-only: "true"
```
Inicialmente, el ConfigMap node-problem-detector-config no tiene un campo data, por lo que es posible que debas agregarlo. Configurar check-only como "true" inhabilita la reparación automática para todas las condiciones compatibles.
Para actualizar el recurso, guarda los cambios y cierra el editor.

Para volver a habilitar la reparación automática para todas las NodeConditions que la admiten, configura data.check-only como "false" en el ConfigMap node-problem-detector-config.

Cómo detener y reiniciar el detector de problemas del nodo

El detector de problemas del nodo se ejecuta como un servicio systemd en cada nodo. Si deseas administrar el detector de problemas del nodo de un nodo determinado, usa SSH para acceder al nodo y ejecuta los siguientes comandos de systemctl.

Para inhabilitar el detector de problemas del nodo, ejecuta el siguiente comando:
```
systemctl stop node-problem-detector
```
Para reiniciar el detector de problemas del nodo, ejecuta el siguiente comando:
```
systemctl restart node-problem-detector
```
Para comprobar si el detector de problemas del nodo se ejecuta en un nodo en particular, ejecuta el siguiente comando:
```
systemctl is-active node-problem-detector
```

Características no compatibles

Google Distributed Cloud no admite las siguientes personalizaciones del detector de problemas de nodos:

Exportar informes del detector de problemas de nodos a otros sistemas de supervisión, como Stackdriver o Prometheus.
Personalizar qué NodeConditions o Events buscar.
Ejecutar secuencias de comandos de supervisión definidas por el usuario.

¿Qué sigue?

Requisitos para abrir un caso de asistencia
Herramientas para ayudarte a solucionar problemas, como la configuración de tu entorno, los registros y las métricas
Componentes compatibles.

Detector de problemas del nodo Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.