This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. Introducción

La monitorización de Proxmox es esencial para obtener información precisa y en tiempo real sobre el estado de tu entorno virtual.
A modo de introducción rápida, este artículo solo aborda los ajustes relevantes para utilizar el agente especial en Checkmk. Por lo tanto, está dirigido principalmente a usuarios que «solo» quieren configurar Checkmk. Si también te interesa obtener más información, por ejemplo, sobre la monitorización de clústeres de Proxmox y la configuración dentro de Proxmox, te recomendamos el artículo del blog «Monitorización de Proxmox: cómo hacerlo de forma eficiente con Checkmk».
2. Requisitos previos en Proxmox
Para que la monitorización con Checkmk funcione correctamente, necesitarás una configuración de Proxmox VE bien configurada.
Crea un usuario en el ámbito «Servidor de autenticación de Proxmox VE» en Proxmox, que usarás exclusivamente para la monitorización con Checkmk (en el siguiente ejemplo, este usuario se llama «checkmk»).
Este usuario necesita las siguientes entradas en sus permisos (a través de Permisos de usuario o Permisos de grupo):
Rol: PVEAuditor
Ruta: /
También te recomendamos que instales los agentes Checkmk para Linux en los nodos de Proxmox; esto te proporcionará información mucho más interesante sobre tu entorno Proxmox.
3. Configuración en Checkmk
Una vez que hayas preparado tu Proxmox, configura la página de Checkmk.
3.1. Creación de un host para Proxmox
Primero crea un host para el nodo Proxmox tal y como se describe en la sección Crear y realizar la edición de hosts en el Menú de configuración.

Si has seguido nuestra recomendación y has instalado un agente en el nodo Proxmox, configura la opción «Checkmk agent / API integrations» en «Configured API integrations and Checkmk agent».
A continuación, configura el agente especial de Proxmox a través de «Setup > Agents > VM, cloud, container > Proxmox VE» y luego de «Add rule»:

Debes especificar checkmk@pve como username.
Al mismo tiempo, debes restringir explícitamente la monitorización a tus nodos Proxmox.
3.2. Creación de hosts para las máquinas virtuales de Proxmox
El agente especial proporciona una gran cantidad de datos sobre las máquinas virtuales y los contenedores (Piggyback). Para crear los hosts piggyback deseados a partir de esto, debes crear a continuación varios hosts. Sus nombres deben coincidir exactamente con los nombres de Proxmox. Como usuario de una de nuestras ediciones comerciales, también puedes dejar esto simplemente en manos de la administración dinámica del host.
Configuración de la administración dinámica del host
El elemento de menú «Setup > Hosts > Dynamic host management» te lleva a la página de vista general de todas las conexiones que ya se han configurado.
Aquí, haz clic en «
» y «Add connection» y, a continuación, asigna a la conexión un «ID» y un «Title».
No todas las opciones de la ventana «Connection properties» se tratan a continuación. Si tienes alguna duda, consulta la ayuda en línea y el artículo principal enlazado más arriba.
Primero, asegúrate de que el modo «mostrar más» esté activado en la caja «Connection properties» para que se muestren todas las opciones disponibles.
A continuación, en «Piggyback creation options», haz clic en «Add new element». Personaliza la carpeta en la que se crearán los hosts para tus sitios de VM. La carpeta preseleccionada «Host attributes» es básicamente correcta para los hosts piggyback y no es necesario cambiarla.
Al activar la opción «Delete vanished hosts», te aseguras de que los hosts piggyback para los que no se reciban datos nuevos durante un cierto periodo de tiempo se eliminen automáticamente.
La opción «Restrict source hosts» (Eliminar automáticamente los hosts) debería activarse como parte de la monitorización de tu entorno Proxmox. Introduce tu host Proxmox desde la sección «Crear un host para Proxmox» aquí.
Una configuración típica de la conexión podría tener este aspecto:

Creación manual de hosts para Proxmox
Como alternativa, también puedes crear hosts para los datos piggyback manualmente. Es importante que los nombres de los hosts se correspondan exactamente con el esquema descrito anteriormente.
Con el comando |
Configura los hosts para tus máquinas virtuales y contenedores de Proxmox y selecciona «No API integrations, no Checkmk agent» como agente de monitorización. Si además seleccionas la opción «Always use and expect piggyback data» en «Piggyback», recibirás una advertencia correspondiente si no se reciben los datos.

