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.

Habilitar monitorización

Como administrador o propietario del clúster, puedes configurar Rancher para desplegar Prometheus y monitorizar tu clúster de Kubernetes.

Esta página describe cómo habilitar monitorización y alertas dentro de un clúster utilizando la nueva aplicación de monitorización.

Puedes habilitar monitorización con o sin SSL.

Requisitos

  • Permite el tráfico en el puerto 9796 para cada uno de tus nodos. Prometheus recopila métricas de estos puertos.

    • También puede que necesites permitir el tráfico en el puerto 10254 para cada uno de tus nodos, si PushProx está deshabilitado (ingressNginx.enabled configurado a false), o si has actualizado desde una versión anterior de Rancher que ya tenía instalada la monitorización v1.

  • Asegúrate de que tu clúster cumple con los requisitos de recursos. El clúster debe tener al menos 1950Mi de memoria disponible, 2700m de CPU y 50Gi de almacenamiento. Consulta Configuración de límites y solicitudes de recursos para un desglose de los límites y solicitudes de recursos.

Si deseas configurar Alertmanager, Grafana o Ingress, debe hacerse con la configuración en la ampliación del gráfico de Helm. Es problemático crear Ingress fuera de la ampliación.

Configuración de Límites y Solicitudes de Recursos

Las solicitudes y límites de recursos se pueden configurar al instalar rancher-monitoring. Para configurar los recursos de Prometheus desde la interfaz de usuario de Rancher, haz clic en Apps  Monitorización en la esquina superior izquierda.

Para más información sobre los límites predeterminados, consulta esta página.

Instala la aplicación de monitorización.

Habilita monitorización para su uso sin SSL.

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Ve al clúster que creaste y haz clic en Explorar.

  3. Haz clic en Herramientas del clúster (esquina inferior izquierda).

  4. Haz clic en Instalar en la sección de monitorización.

  5. Opcional: Personaliza las solicitudes, los límites y más para alertas, Prometheus y Grafana en el paso de Valores. Para obtener ayuda, consulta la referencia de configuración.

Resultado: La aplicación de monitorización se despliega en el espacio de nombres cattle-monitoring-system.

Habilita monitorización para su uso con SSL.

  1. Sigue los pasos en esta página para crear un secreto para que se utilice SSL para las alertas.

    • El secreto debe ser creado en el espacio de nombres cattle-monitoring-system. Si no existe, créalo primero.

    • Añade los archivos ca, cert y key al secreto.

  2. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  3. En la página Clusters, ve al clúster donde deseas habilitar monitorización para su uso con SSL y haz clic en Explorar.

  4. Haz clic en Aplicaciones  Gráficos.

  5. Haz clic en Monitorización.

  6. Haz clic en Instalar o Actualizar, dependiendo de si ya has instalado monitorización.

  7. Marca la casilla de Personalizar opciones de Helm antes de instalar y haz clic en Siguiente.

  8. Haz clic en Alertas.

  9. En el campo Secretos Adicionales, añade los secretos creados anteriormente.

Resultado: La aplicación de monitorización se despliega en el espacio de nombres cattle-monitoring-system.

Cuando crees un receptor, los receptores habilitados para SSL, como el correo electrónico o webhook, tendrán una sección SSL con campos para Ruta del Archivo CA, Ruta del Archivo Cert y Ruta del Archivo Clave. Rellena estos campos con las rutas a cada uno de ca, cert y key. La ruta tendrá la forma /etc/alertmanager/secrets/name-of-file-in-secret.

Por ejemplo, si creaste un secreto con estos pares clave-valor:

ca.crt=`base64-content`
cert.pem=`base64-content`
key.pfx=`base64-content`

Entonces Ruta del Archivo Cert se establecería en /etc/alertmanager/secrets/cert.pem.

Panel de Rendimiento de Rancher

Cuando se instala la monitorización en el clúster de sentido ascendente (local), se te proporcionan métricas básicas de salud sobre los pods de Rancher, como datos de CPU y memoria. Para obtener métricas avanzadas para tu servidor Rancher local, debes habilitar adicionalmente el Panel de Rendimiento de Rancher para Grafana.

Este panel proporciona acceso a las siguientes métricas avanzadas:

  • Tiempos Promedio de Ejecución del Manejador en los Últimos 5 Minutos

  • Tiempos Promedio de Solicitudes de la API de Rancher en los Últimos 5 Minutos

  • Tiempos Promedio de Solicitudes de Suscripción en los Últimos 5 Minutos

  • Profundidad de la Cola de Trabajo del Controlador Lasso (Top 20)

  • Número de Solicitudes de Rancher (Top 20)

  • Número de Solicitudes Fallidas de la API de Rancher (Top 20)

  • Tiempos Promedio de Solicitudes del Proxy K8s en los Últimos 5 Minutos (Top 20)

  • Tiempos Promedio de Solicitudes del Cliente del Proxy K8s en los Últimos 5 Minutos (Top 20)

  • Objetos en Caché por GroupVersionKind (Top 20)

  • Ejecuciones del Manejador Lasso (Top 20)

  • Ejecuciones del Manejador en los Últimos 2 Minutos (Top 20)

  • Total de Ejecuciones del Manejador con Error (Top 20)

  • Datos Transmitidos por Sesiones de Marcador Remoto (Top 20)

  • Errores para Sesiones de Marcador Remoto (Top 20)

  • Conexiones de Marcador Remoto Eliminadas (Top 20)

  • Conexiones de Marcador Remoto Añadidas por el Cliente (Top 20)

Los datos de perfilado (como análisis avanzado de memoria o CPU) no están presentes, ya que es una técnica muy dependiente del contexto que está destinada a la depuración y no a la observación normal.

Habilitando el Panel de Rendimiento de Rancher

Para habilitar el Panel de Rendimiento de Rancher:

  • Helm

  • INTERFAZ DE USUARIO

Utiliza las siguientes opciones con la CLI de Helm:

--set extraEnv\[0\].name="CATTLE_PROMETHEUS_METRICS" --set-string extraEnv\[0\].value=true

También puedes incluir el siguiente fragmento en el archivo values.yaml de tu gráfico de Helm de Rancher:

extraEnv:
  - name: "CATTLE_PROMETHEUS_METRICS"
    value: "true"
  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Ve a la fila del clúster local y haz clic en Explorar.

  3. Haz clic en Workloads  Ampliaciones.

  4. Utiliza el menú desplegable en la parte superior para filtrar por Todos los espacios de nombres.

  5. Bajo el espacio de nombres cattle-system, ve a la fila rancher y haz clic en ⋮ > Editar Configuración

  6. Bajo Variables de Entorno, haz clic en Añadir Variable.

  7. Para Tipo, selecciona Key/Value Pair.

  8. Para Nombre de Variable, introduce CATTLE_PROMETHEUS_METRICS.

  9. Para Valor, introduce true.

  10. Haz clic en Guardar para aplicar el cambio.

Accediendo al Panel de Rendimiento de Rancher

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Ve a la fila del clúster local y haz clic en Explorar.

  3. Haz clic en Monitorización

  4. Selecciona el panel Grafana.

  5. Desde la barra lateral, haz clic en Buscar paneles.

  6. Introduce Rancher Performance Debugging y selecciónalo.