# Rancher - Monitoring

_Rancher_ cuenta con una configuración para agregar _Monitoring_ junto con _Graphana_, _Prometheus_ y _Alert Manager_. A continuación te diremos cómo agregarlo.

## Agregar monitoring
Para agregar monitoring a nuestro _Cluster_, debemos dar clic en el botón _Explore_.


Al dar clic en _Explore_, _Rancher_ te llevará al _Rancher Explorer_, dónde deberemos ubicar el menú superior izquierdo.


Daremos clic sobre el menú superior izquierdo y seleccionaremos la opción _Apps & Marketplace_.


Al dar clic en _Apps & Marketplace_, _Rancher_ nos mostrará una lista de Aplicaciones que podemos agregar a nuestro _Cluster_, en nuestro caso para agregar Monitoreo, deberemos seleccionar _Monitoring_.


_Rancher_ nos mostrará las opciones para configurar _Monitoring_. Para agregar _Monitoring_ da clic sobre el botón _Install_.


Una vez que des clic en el botón _Install_, _Rancher_ comenzará a instalar _Monitoring_, al instalarse se abrirá una subventana que estará mostrando los comandos para instalar _Monitoring_. Al final podrás visualizar un resultado como este:


Igualmente, al terminar la instalación, en el menú superior izquierdo podrás visualizar la opción _Monitoring_, deberás seleccionar esta opción.


Al dar clic en la opción _Monitoring_, _Rancher_ te llevará a la configuración de la aplicación, del lado izquierdo podrás acceder a _Graphana_, _Alertmanager_ o _Prometheus_.


## Agregar canal de Slack a Alertmanager
Mediante _Monitoring_ es posible recibir alertas en un canal de _Slack_ por medio de _Alertmanager_. Para ello, debemos ingresar a la aplicación _Monitoring_ que instalamos previamente y seleccionar la opción _Receivers_ en el menú lateral izquierdo y dar clic en _Create_.


Posteriormente, seleccionaremos _Slack_ entre las diferentes opciones.


Adicionalmente, daremos clic en el botón _Add Slack_.


Después, deberás agregar el Webhook URL y un nombre. Al introducir la información, da clic en _Create_.


### Obtener Webhook URL
A continuación te mostraremos como obtener el _Webhook URL_.

Primero, deberás dar clic en el enlace que esta debajo de _Webhook URL_.


Ese enlace abrirá una ventana de _Slack_, en ella da clic en el botón _Añadir a Slack_. En caso de que en la ventana no aparezca la opción _Añadir a Slack_, es porque tienes que ingresar con tu cuenta de _Slack_ previamente.


Posteriormente, deberás elegir el canal donde te llegarán las notificaciones.


Una vez que hayas elegido el Canal, da clic en el botón _Añadir integración con WebHooks entrantes_.


Finalmente, _Slack_ te mostrará la información de tu _WebHook_ en especifico la URL. Una vez que tengas la URL, cópiala y pégala en la configuración de _Slack_ de _Rancher_.


## Agregar canal de Slack a Alertmanager (Cont)
Una vez que hayas agregado la configuración de _Slack_ en los _Receivers_. Deberás agregar el canal de _Slack_ a la ruta principal. Para ello, selecciona _Routers_ en el menú lateral izquierdo. Posteriormente, ubica la fila con el nombre _root_ y da clic en el botón con los 3 puntos y selecciona _Edit Config_.


Por último, selecciona la configuración de _Slack_ que acabas de crear en el select de _Receiver_, una vez que lo selecciones da clic en el botón _Save_.


## Añade reglas a Prometheus
Con la configuración anterior de _Alertmanager_ podrás recibir alertas configuradas por defecto, pero en caso de que quieras agregar alertas más específicas, deberás añadir algunas reglas.

Para ello, selecciona _Prometheus rules_ en el menú lateral izquierdo y posteriormente da clic en _Create_.


En la vista de _Create_, selecciona el _Namespace_ en el que quieras aplicar la nueva regla, asignale un nombre, un nombre grupal y da clic en el botón _Add Alert_.


Posteriormente, deberás ingresar la información de la alerta, al concluir, da clic en el botón _Create_.


### Example
Primero, selecciona el namespace de la alerta, coloca un nombre y un nombre de grupo.

Después, define el nombre de la alerta, el tiempo de espera y selecciona el nivel de importancia de la alerta.

Finalmente, agrega las anotaciones, que será la información que se despliegue en la alerta.