Utilizar la pila de supervisión

La pila de supervisión para los clústeres de Automation Suite incluye Prometheus, Grafana y AlertManager, que están integrados en la interfaz de usuario del explorador de clústeres de Rancher.

Nota:

Los fallos de los nodos pueden provocar un apagado de Kubernetes, que interrumpiría las alertas de Prometheus. Para evitar esto, recomendamos configurar una alerta independiente en el servidor RKE2.

En esta página se describen una serie de escenarios de supervisión. Para más detalles, consulta la documentación oficial de Rancher sobre el uso de Rancher Monitoring.

Importante:

Al utilizar recopiladores para exportar métricas a herramientas de terceros, al habilitar la supervisión de la aplicación puede interrumpir la funcionalidad de Automation Suite.

Acceder a las herramientas de supervisión

Información general

La pila de supervisión para los clústeres de Automation Suite incluye Prometheus, Grafana, Gestor de alertas y panel de Longhorn.

En esta página se describen una serie de escenarios de supervisión.

Para obtener más detalles, consulta la documentación oficial de Rancher sobre el uso de la supervisión de Rancher.

Puedes acceder a las herramientas de supervisión de Automation Suite de forma individual utilizando las siguientes URL:

Aplicación	Herramienta	URL	Ejemplo
Métricas	Prometheus	https://monitoring.fqdn/metrics	https://monitoring.automationsuite.mycompany.com/metrics
Panel	Grafana	https://monitoring.fqdn/dashboard	https://monitoring.automationsuite.mycompany.com/dashboard
Gestión de alertas	AlertManager	https://monitoring.fqdn/alertmanager	https://monitoring.automationsuite.mycompany.com/alertmanager
Almacenamiento de bloques persistentes	Panel de Longhorn	https://monitoring.fqdn	https://monitoring.automationsutie.mycompany.com

Autenticación

Para acceder a las herramientas de supervisión por primera vez, inicie sesión como administrador con las siguientes credenciales predeterminadas:

• Nombre de usuario: admin
• Contraseña: para recuperar la contraseña , ejecuta el siguiente comando:

  kubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -d

Para actualizar la contraseña predeterminada utilizada para acceder a las herramientas de supervisión, siga los siguientes pasos:

1. Ejecuta el siguiente comando reemplazando newpassword con tu nueva contraseña:

   password="newpassword"
   password=$(echo -n $password | base64)
   kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"

2. Ejecuta el siguiente comando reemplazando <cluster_config.json> con la ruta de tu archivo de configuración:

   /opt/UiPathAutomationSuite/UiPath_Installer/install-uipath.sh -i <cluster_config.json> -f -o output.json --accept-license-agreement

Comprobación de las alertas en curso

Para ver las alertas, ve a Prometheus utilizando https://monitoring.fqdn/metrics y haz clic en la pestaña Alertas. Aquí puedes ver todas las alertas configuradas en Automation Suite.

Para ver las alertas activas, filtra el estado de la alerta haciendo clic en la casilla de verificación Activa y en la casilla de verificación Mostrar anotaciones en la parte superior. Aquí puedes ver todas las alertas que actualmente se activan y sus mensajes correspondientes.

Silenciar alertas

Si las alertas son demasiado intrusivas, puede silenciarlas. Para hacerlo, siga los siguientes pasos:

1. Haga clic en el mosaico AlertManager en la esquina superior izquierda del panel Supervisión. Se mostrará la siguiente pantalla.
   
   

   

   
   
2. Busque la alerta en cuestión y seleccione Silenciar.
   
   

   

   
   
3. Rellene los datos de Creador y Comentario, y haga clic en Crear. La alerta ya no debería aparecer en el panel de Supervisión ni debería comunicarse a ninguno de los receptores configurados.

Configurar las alertas

Nota:

Puede encontrar uipathctl en la carpeta de instalación de Automation Suite: .../UiPathAutomationSuite/UiPath_Installer/bin.

Añadir una nueva configuración de correo electrónico

Para añadir una nueva configuración de correo electrónico después de una instalación, ejecuta el siguiente comando:

./uipathctl config alerts add-email \
  --name test \
  --to "[e-mail]" \
  --from "[e-mail]" \
  --smtp server.mycompany.com \
  --username admin \
  --password somesecret \
  --require-tls \
  --ca-file <path_to_ca_file> \
  --cert-file <path_to_cert_file> \
  --key-file <path_to_key_file> \
  --send-resolved

Marca	Descripción	Ejemplo
name	Nombre de la configuración del correo electrónico	testconfig
to	Dirección de correo electrónico del receptor	[e-mail]
from	Dirección de correo electrónico del usuario	[e-mail]
SMTP	URL del servidor SMTP o dirección IP y número de puerto	server.mycompany.com:567
username	Nombre de usuario de la autenticación	admin
password	Contraseña de autenticación	securepassword
require-tls	Indicador booleano que indica que TLS está habilitado en el servidor SMTP.	N/D
ca-file	Ruta del archivo que contiene el certificado de autoridad de certificación del servidor SMTP. Es opcional si la autoridad de certificación es privada.	./ca-file.crt
cert-file	Ruta del archivo que contiene el certificado del servidor SMTP. Es opcional si el certificado es privado.	./cert-file.crt
key-file	Ruta del archivo que contiene la clave privada del certificado del servidor SMTP. Es obligatorio si el certificado es privado.	./key-file.crt
send-resolved	Indicador booleano para enviar un correo electrónico una vez que se resuelva la alerta.	N/D

Eliminar una configuración de correo electrónico

Para eliminar una configuración de correo electrónico, debes ejecutar el siguiente comando. Asegúrate de introducir el nombre de la configuración de correo electrónico que deseas eliminar.

./uipathctl config alerts remove-email --name test

Actualizar una configuración de correo electrónico

Para actualizar una configuración de correo electrónico, debes ejecutar el siguiente comando. Asegúrate de introducir el nombre de la configuración de correo electrónico que deseas actualizar y los parámetros opcionales adicionales que deseas editar. Estos parámetros son los mismos que para añadir una nueva configuración de correo electrónico. Puedes pasar uno o varios indicadores a la vez.

./uipathctl config alerts update-email --name test [additional_flags]

Acceder al panel de Grafana

Para acceder a los paneles de Grafana, debe recuperar sus credenciales y usarlas para iniciar sesión:

• Nombre de usuario:

  kubectl -n cattle-monitoring-system get secrets/rancher-monitoring-grafana -o "jsonpath={.data.admin-user}" | base64 -d; echo

• Contraseña:

  kubectl -n cattle-monitoring-system get secrets/rancher-monitoring-grafana -o "jsonpath={.data.admin-password}" | base64 -d; echo

Seguimiento del grupo de servicios

Puede supervisar el grupo de servicios de Istio a través de los siguientes paneles de Grafana: Panel de grupos de Istio y Carga de trabajo de Istio.

Panel de grupos de Istio

Este panel muestra el volumen global de solicitudes, así como las tasas de error 400 y 500 en toda la malla de servicios, para el período de tiempo seleccionado. Los datos aparecen en la esquina superior derecha de la ventana. Consulte los 4 gráficos de la parte superior para obtener esta información.

También muestra la tasa de éxito inmediata durante el último minuto para cada servicio individual. Ten en cuenta que una tasa de éxito de NaN indica que el servicio no está prestando tráfico actualmente.

Panel de carga de trabajo de Istio

Este panel muestra las métricas de tráfico en el rango de tiempo seleccionado en la esquina superior derecha de la ventana.

Usa los selectores de la parte superior del panel para profundizar en cargas de trabajo específicas. Es de especial interés el espacio de nombres uipath.

La sección superior muestra las métricas generales, la sección Cargas de trabajo entrantes separa el tráfico en función del origen, y la sección Servicios salientes separa el tráfico en función del destino.

Supervisión de los volúmenes persistentes

Puede supervisar los volúmenes persistentes a través del panel Kubernetes / Volúmenes persistentes. Puede hacer un seguimiento del espacio libre y utilizado de cada volumen.

También puede comprobar el estado de cada volumen haciendo clic en el elemento Volúmenes persistentes dentro del menú Almacenamiento del Explorador de clústeres.

Supervisión de la utilización del hardware

Para marcar la utilización del hardware por nodo, puede utilizar el panel Nodos. Los datos sobre la CPU, la memoria, el disco y la red están disponibles.

Puede supervisar la utilización del hardware para cargas de trabajo específicas con el panel Kubernetes / Calcular recursos / Espacio de nombres (cargas de trabajo). Seleccione el espacio de nombres uipath para obtener los datos necesarios.

Creación de una instantánea compartible de un gráfico de Grafana

1. Haga clic en la flecha que apunta hacia abajo junto al título del gráfico y, a continuación, seleccione Compartir.
2. Haga clic en la pestaña Instantánea, y establezca los valores Nombre de instantánea, Vencimiento y Tiempo de espere.
3. Haz clic en Publicar en snapshot.raintank.io.

Para más detalles, consulta la documentación de Grafana sobre compartir paneles.

Nota: Esta instantánea está públicamente visible en Internet por cualquiera que tenga el enlace.

Creación de paneles personalizados y persistentes de Grafana

Para obtener más información sobre cómo crear paneles de Grafana persistentes personalizados, consulta la documentación de Rancher.

Acceso de administrador a Grafana

El acceso de administrador a Grafana no suele ser necesario en los clústeres de Automation Suite, ya que los paneles están disponibles para el acceso de lectura por defecto para los usuarios anónimos, y la creación de paneles persistentes personalizados debe crearse siguiendo las instrucciones nativas de Kubernetes enlazadas anteriormente en este documento.

Sin embargo, el acceso de administrador a Grafana es posible siguiendo las siguientes instrucciones.

El nombre de usuario y la contraseña predeterminados para el acceso de administrador de Grafana se pueden obtener de la siguiente manera:

kubectl get secret -n cattle-monitoring-system rancher-monitoring-grafana -o jsonpath='{.data.admin-user}' | base64 -d && echo
kubectl get secret -n cattle-monitoring-system rancher-monitoring-grafana -o jsonpath='{.data.admin-password}' | base64 -d && echo

Ten en cuenta que en los clústeres de Automation Suite de alta disponibilidad hay varios pods de Grafana para permitir un acceso de lectura ininterrumpido en caso de que falle el nodo, así como un mayor volumen de consultes de lectura. Esto es incompatible con el acceso de administrador porque los pods no comparten el estado de la sesión y el inicio de sesión lo requiere. Para solucionar esto, el número de réplicas de Grafana debe escalarse temporalmente a 1 mientras se desee el acceso del administrador. Consulte a continuación las instrucciones sobre cómo escalar el número de réplicas de Grafana:

# scale down
kubectl scale -n cattle-monitoring-system deployment/rancher-monitoring-grafana --replicas=1
# scale up
kubectl scale -n cattle-monitoring-system deployment/rancher-monitoring-grafana --replicas=2

Consulte a Prometheus

En el panel de supervisión, haga clic en Gráfico de Prometheus. Se mostrará una nueva ventana.

La documentación sobre las métricas disponibles está aquí:

• https://github.com/prometheus/node\_exporter#enabled-by-default - Conectar con la vista previa
• https://github.com/kubernetes/kube-state-metrics/tree/master/docs#exposed-metrics - Conectar con la vista previa
• Consulta de métricas desde Prometheus (Istio)

Creación de alertas personalizadas

Puede crear alertas personalizadas utilizando una consulte de Prometheus con una expresión booleana.

1. Para ello, haga clic en Reglas de Prometheus en el menú avanzado del panel Supervisión.
2. Haz clic en Crear en la esquina superior derecha de la ventana para crear una nueva alerta y sigue la documentación de Rancher: Reglas de Prometheus
3. Cuando la alerta se dispara, debe aparecer en el panel Supervisión. Además, se dirigirá a cualquiera de los receptores configurados.

Supervisión del estado de los recursos de Kubernetes

Para ver el estado de los pods, implementaciones, StatefulSets, etc., puede utilizar la interfaz de usuario del explorador de clústeres. Esta es la misma página de destino a la que se accede después de registrarse en el punto final de rancher-server. La página de inicio muestra un resumen, con detalles específicos para cada tipo de recurso a la izquierda. El selector de espacio de nombres se encuentra en la parte superior de la página. Este panel también puede sustituirse por la herramienta Lens.

Exportación de las métricas de Prometheus a un sistema externo

Prometheus utiliza la Función de escritura remota de Prometheus para obtener y exportar las métricas a un sistema externo.

Nota: UiPath® no es compatible ni conserva integraciones del punto de conexión remota. Sin embargo, los puntos de conexión son compatibles con la instancia de Prometheus suministrada dentro de Automation Suite.

Para configurar remote_write en un clúster de Automation Suite:

1. Conéctese a ArgoCD.
2. Haz clic en Aplicaciones.
3. Ve al instalador de Fabric.
4. Abre el panel de DETALLES DE LA APLICACIÓN y deshabilita la autocuración.
5. Navega hasta la aplicación rancher-monitoring.
   
   

   

   
   
6. Abra el panel DETALLES DE LA APLICACIÓN y acceda a la pestaña MANIFIESTO.
   
   

   

   
   
7. Haga clic en EDITAR y navega hasta la sección valores > prometheus > prometheusSpec.
8. Añada las remoteWriteconfiguraciones deseadas.
   Descubre las configuraciones disponibles para la característica de escritura remota.

   
9. Guarde la nueva configuración. La aplicación rancher-monitoring muestra OutOfSync hasta que se aplique la nueva configuración.
   Nota: Prometheus no necesita reiniciarse para aplicar las nuevas configuraciones de escritura remota.

   

   
   

   

   
   
10. Pruebe la integración de escritura remota deseada. Vuelve al paso 8 para añadir una nueva configuración.