#Configuración del Panel de Grafana

Ahora que tienes tu nodo en funcionamiento, probablemente querrás tener una forma conveniente de monitorear todo sobre él de un vistazo para asegurarte de que funciona correctamente (y qué tipo de ganancias está generando para ti).

Hay muchas herramientas que hacen este trabajo. Una de las más populares se llama Grafana - un sistema de panel de uso fácil y propósito general al que puedes acceder con un navegador.

Rocket Pool viene listo para usar con soporte para Grafana y sus dependencias; incluso viene con un panel preconstruido para cada uno de los clientes de consenso. Por ejemplo, aquí hay una captura de lo que se ve el panel en la red de prueba Hoodi:

El panel estándar incluye la siguiente información toda en un formato conveniente:

• Superior izquierda: algunas estadísticas importantes sobre la salud y rendimiento de tu máquina, y cualquier actualización pendiente del sistema
• Superior derecha: la actividad y rendimiento de tus validadores en la Beacon Chain, junto con algunas estadísticas del cliente de ejecución y consenso
• Inferior izquierda: detalles sobre toda la red de Rocket Pool, para referencia
• Inferior derecha: detalles sobre tus recompensas de staking, tanto ETH como RPL

En esta guía, te mostraremos cómo habilitar el sistema de métricas de Rocket Pool para que puedas usar este panel - ¡o incluso construir el tuyo propio!

#Visión General del Stack de Métricas de Rocket Pool

Si eliges habilitar las métricas durante el proceso de configuración del Smartnode, tu nodo agregará los siguientes procesos:

• Prometheus - un sistema de recopilación, almacenamiento y reporte de datos que captura todas las métricas que ves arriba (y muchas más) y las almacena, para que puedan ser consultadas a lo largo del tiempo
• El Node Exporter de Prometheus - un servicio que recopila información sobre la salud de tu máquina (como uso de CPU, uso de RAM, espacio libre en disco y espacio de intercambio, etc.) y lo reporta a Prometheus
• Grafana, la herramienta que expone los datos de Prometheus a través de un sitio web conveniente alojado en tu nodo
• Un conjunto opcional de scripts personalizados que reportarán cualquier actualización disponible del sistema operativo a Prometheus, para que sepas si tu sistema necesita ser parcheado

La configuración predeterminada creará contenedores Docker con todos estos servicios que vivirán junto al resto de los contenedores Docker del Smartnode. Abrirá un puerto en tu máquina de nodo para Grafana, para que puedas acceder a su panel desde cualquier máquina en tu red local con un navegador.

#Habilitando el Servidor de Métricas

rocketpool service config

rocketpool service install-update-tracker

docker restart rocketpool_exporter

--metrics --metrics.addr 0.0.0.0 --metrics.port 9105

--Metrics.Enabled true --Metrics.ExposePort 9105

--metrics-enabled --metrics-host=0.0.0.0 --metrics-port=9105

--metrics --metrics-address 0.0.0.0 --metrics-port 9100 --validator-monitor-auto

--metrics --metrics.address 0.0.0.0 --metrics.port 9100

--metrics --metrics-address=0.0.0.0 --metrics-port=9100

--monitoring-host 0.0.0.0 --monitoring-port 9100

--metrics-enabled=true --metrics-interface=0.0.0.0 --metrics-port=9100 --metrics-host-allowlist=*

wget https://github.com/prometheus/prometheus/releases/download/v2.45.3/prometheus-2.45.3.linux-amd64.tar.gz
wget https://github.com/prometheus/node_exporter/releases/download/v1.7.0/node_exporter-1.7.0.linux-amd64.tar.gz
wget https://github.com/prometheus/alertmanager/releases/download/v0.26.0/alertmanager-0.26.0.linux-amd64.tar.gz

sudo tar -zxvf prometheus-2.45.3.linux-amd64.tar.gz -C /usr/local/bin --wildcards '*/prometheus' --strip-components=1
sudo tar -zxvf node_exporter-1.7.0.linux-amd64.tar.gz -C /usr/local/bin --wildcards '*/node_exporter' --strip-components=1
sudo tar -zxvf alertmanager-0.26.0.linux-amd64.tar.gz -C /usr/local/bin --wildcards '*/alertmanager' --strip-components=1

sudo mkdir /etc/prometheus
sudo mkdir /etc/alertmanager
sudo mkdir /var/lib/prometheus
sudo mkdir /var/lib/alertmanager

global:
scrape_interval: 15s # Set the scrape interval to every 15 seconds. Default is every 1 minute.
scrape_timeout: 12s # Timeout must be shorter than the interval
evaluation_interval: 15s # Evaluate rules every 15 seconds. The default is every 1 minute.

scrape_configs:
- job_name: "prometheus"
static_configs:
- targets: ["localhost:9091"]

- job_name: "node"
static_configs:
- targets: ["localhost:9103"]
#     - targets: ['localhost:9103', 'node_hostname:9103']
- job_name: "eth1"
static_configs:
- targets: ["localhost:9105"]
# Uncomment the line below if you are using geth as Execution Client
#metrics_path: /debug/metrics/prometheus

- job_name: "eth2"
static_configs:
- targets: ["localhost:9100"]

- job_name: "validator"
static_configs:
- targets: ["validator:9101"]

- job_name: "rocketpool"
scrape_interval: 5m
scrape_timeout: 5m
static_configs:
- targets: ["node:9102"]

- job_name: "watchtower"
scrape_interval: 5m
scrape_timeout: 5m
static_configs:
- targets: ["watchtower:9104"]

alerting:
alertmanagers:
- static_configs:
- targets: ["localhost:9093"]

global:
# ResolveTimeout is the default value used by alertmanager if the alert does
# not include EndsAt, after this time passes it can declare the alert as resolved if it has not been updated.
# This has no impact on alerts from Prometheus, as they always include EndsAt.
# default = 5m
resolve_timeout: 5m

route:
# The labels by which incoming alerts are grouped together.
group_by: ["alertname"]
# How long to initially wait to send a notification for a group
# of alerts. Allows to wait for an inhibiting alert to arrive or collect
# more initial alerts for the same group.
group_wait: 30s
# How long to wait before sending a notification about new alerts that
# are added to a group of alerts for which an initial notification has
# already been sent. (Usually ~5m or more.)
group_interval: 5m
# How long to wait before sending a notification again if it has already been sent successfully for an alert.
repeat_interval: 4h
routes:
# severity=info: Don't send the follow-up resolved notification.
- match:
severity: info
continue: false
# The notification destination
receiver: "node_operator_no_resolved"
# all other alerts get sent notifications for the initial firing _and_ resolved notifications.
- receiver: "node_operator_default"
#match: We want this to match all alerts (severity=info is first though so it will stop)

# The notification destination
receiver: "node_operator_default"

receivers:
- name: "node_operator_default"
discord_configs:
- webhook_url: "https://discord.com/api/webhooks/1206697259694170212/_Pk1eVVgXFLdwU1k0rfwehSvNLiAQJytVV_Ze8QYOhupHnhiB5c8awPBTfuw41lN9GJk"

- name: "node_operator_no_resolved"
discord_configs:
- webhook_url: "https://discord.com/api/webhooks/1206697259694170212/_Pk1eVVgXFLdwU1k0rfwehSvNLiAQJytVV_Ze8QYOhupHnhiB5c8awPBTfuw41lN9GJk"
send_resolved: false

inhibit_rules:
# Inhibit rules mute a new alert (target) that matches an existing alert (source).
- source_match:
# if the existing alert (source) is severity=critical
severity: "critical"
target_match:
# and the new alert (target) is severity=warning
severity: "warning"
# and the alertname, job, and instance labels have the same value
equal: ["alertname", "job", "instance"]

sudo useradd -r -s /sbin/nologin prometheus
sudo useradd -r -s /sbin/nologin alertmanager

sudo chown prometheus:prometheus /usr/local/bin/prometheus
sudo chown alertmanager:alertmanager /usr/local/bin/alertmanager
sudo chown prometheus:prometheus /usr/local/bin/node_exporter
sudo chown -R prometheus:prometheus /etc/prometheus
sudo chown -R alertmanager:alertmanager /etc/alertmanager
sudo chown -R prometheus:prometheus /var/lib/prometheus
sudo chown -R alertmanager:alertmanager /var/lib/alertmanager
sudo chmod u+sx,g+sx,o-wx /usr/local/bin/prometheus
sudo chmod u+sx,g+sx,o-wx /usr/local/bin/alertmanager
sudo chmod u+sx,g+sx,o-wx /usr/local/bin/node_exporter

[Unit]
Description=Node metrics exporter for Prometheus
Documentation=https://prometheus.io/docs/introduction/overview
Wants=network-online.target
After=network-online.target

[Service]
User=prometheus
Group=prometheus
Type=simple
Restart=on-failure
WorkingDirectory=/var/lib/prometheus
RuntimeDirectory=node-exporter
RuntimeDirectoryMode=0750
ExecStart=/usr/local/bin/node_exporter --web.listen-address=:9103

[Install]
WantedBy=multi-user.target

[Unit]
Description=Prometheus instance
Documentation=https://prometheus.io/docs/introduction/overview
Wants=network-online.target
After=network-online.target

[Service]
User=prometheus
Group=prometheus
Type=simple
Restart=on-failure
WorkingDirectory=/var/lib/prometheus
RuntimeDirectory=prometheus
RuntimeDirectoryMode=0750
ExecStart=/usr/local/bin/prometheus --config.file /etc/prometheus/prometheus.yml --web.listen-address=:9091

[Install]
WantedBy=multi-user.target

[Unit]
Description=Alertmanager instance
Documentation=https://prometheus.io/docs/alerting/latest/alertmanager/
Wants=network-online.target
After=network-online.target

[Service]
User=alertmanager
Group=alertmanager
Type=simple
Restart=on-failure
WorkingDirectory=/var/lib/alertmanager
RuntimeDirectory=alertmanager
RuntimeDirectoryMode=0750
ExecStart=/usr/local/bin/alertmanager --config.file /etc/alertmanager/alertmanager.yml --web.listen-address=:9093

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload

sudo systemctl enable node-exporter
sudo systemctl start node-exporter

sudo systemctl status node-exporter

sudo systemctl enable prometheus
sudo systemctl start prometheus

sudo systemctl enable alertmanager
sudo systemctl start alertmanager

sudo systemctl status prometheus
sudo systemctl status alertmanager

sudo apt-get update
sudo apt-get install -y apt-transport-https software-properties-common
sudo mkdir -p /etc/apt/keyrings/
wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list

sudo apt-get update
sudo apt-get install grafana

apiVersion: 1

deleteDatasources:
- name: Prometheus
orgId: 1

datasources:
- name: Prometheus
type: prometheus
access: proxy
orgId: 1
url: http://localhost:9091
basicAuth: false
isDefault: true
version: 1
editable: true

sudo systemctl daemon-reload
sudo systemctl enable grafana-server
sudo systemctl start grafana-server

sudo systemctl status grafana-server

#Configurar el firewall para permitir conexiones de monitoreo

RP_NET=$(docker inspect rocketpool_net | grep -Po "(?<=\"Subnet\": \")[0-9./]+")
sudo ufw allow from $RP_NET to any port 9105 comment "Allow Prometheus access to Execution Client"
sudo ufw allow from $RP_NET to any port 9100 comment "Allow Prometheus access to Consensus Client"
sudo ufw allow from $RP_NET to any port 9103 comment "Allow Prometheus access to Exporter"

sudo ufw allow from 192.168.1.6 to any port 9100:9105 proto tcp comment 'Allow Prometheus host to scrape metrics of this host'

sudo ufw allow out from any to 192.168.1.5 port 9100:9105 proto tcp comment 'Allow this host to scrape node metrics'

Luego puedes abrir el firewall para permitir que dispositivos externos accedan a tu panel de Grafana.

# This assumes your local IP structure is 192.168.1.xxx
sudo ufw allow from 192.168.1.0/24 proto tcp to any port 3100 comment 'Allow grafana from local network'

# To allow any devices in the broader subnet
# for example allowing 192.168.2.20 to access
# grafana on 192.168.1.20
sudo ufw allow from 192.168.1.0/16 proto tcp to any port 3100 comment 'Allow grafana from local subnets'

# Allow any IP to connect to Grafana
sudo ufw allow 3100/tcp comment 'Allow grafana from anywhere'

#Configurando Grafana

Ahora que el servidor de métricas está listo, puedes acceder a él con cualquier navegador en tu red local.

Consulta las pestañas a continuación para tu modo de instalación del Smartnode.

Navega a la siguiente URL, sustituyendo las variables con tu configuración según sea necesario:

http://<IP de tu nodo>:<puerto de grafana>

Por ejemplo, si la IP de tu nodo era 192.168.1.5 y usaste el puerto predeterminado de Grafana de 3100, entonces irías a esta URL en tu navegador:

http://192.168.1.5:3100

Verás una pantalla de inicio de sesión como esta:

La información predeterminada de Grafana es:

Username: admin
Password: admin

Luego se te pedirá que cambies la contraseña predeterminada para la cuenta admin. ¡Elige algo fuerte y no lo olvides!

docker exec -it rocketpool_grafana grafana-cli admin reset-admin-password admin

sudo grafana-cli admin reset-admin-password admin

Gracias al trabajo del miembro de la comunidad tedsteen, Grafana se conectará automáticamente a tu instancia de Prometheus para que tenga acceso a las métricas que recopila. ¡Todo lo que necesitas hacer es obtener el panel!

#Importando el Panel de Rocket Pool

Ahora que tienes Grafana conectado a Prometheus, puedes importar el panel estándar (o construir el tuyo propio usando las métricas que proporciona, si estás familiarizado con ese proceso).

Comienza yendo al menú Create (el icono de más en la barra lateral derecha) y haz clic en Import:

Cuando se te solicite el ID del panel en el cuadro Import via grafana.com, ingresa 21863 o usa la URL completa ((https://grafana.com/grafana/dashboards/24900-rocket-pool-dashboard-v1-4-0/) y presiona el botón Load.

Se te presentará algo de información sobre el panel aquí, como su nombre y dónde te gustaría almacenarlo (la carpeta General predeterminada está bien a menos que uses muchos paneles y quieras organizarlos).

En el menú desplegable Prometheus en la parte inferior, solo deberías tener una opción etiquetada como Prometheus (default). Selecciona esta opción.

Tu pantalla debería verse así:

Si la tuya coincide, haz clic en el botón Import y serás llevado inmediatamente a tu nuevo panel.

A primera vista, deberías ver mucha información sobre tu nodo y tus validadores. Cada cuadro viene con un útil tooltip en la esquina superior izquierda (el icono i) sobre el que puedes pasar el cursor para aprender más sobre él. Por ejemplo, aquí está el tooltip para el cuadro Your Validator Share:

Sin embargo, aún no hemos terminado de configurar las cosas - todavía hay un poco más de configuración que hacer.

#Adaptando el Monitor de Hardware a tu Sistema

Ahora que el panel está activo, es posible que notes que algunos cuadros están vacíos como SSD Latency y Network Usage. Tenemos que adaptar el panel a tu hardware específico para que sepa cómo capturar estas cosas.

#CPU Temp

Para actualizar tu indicador de temperatura de CPU, haz clic en el título del cuadro CPU Temp y selecciona Edit del menú desplegable. Tu pantalla ahora se verá algo así:

Este es el modo de edición de Grafana, donde puedes cambiar qué se muestra y cómo se ve. Nos interesa el cuadro de consulta resaltado en rojo, a la derecha del botón Metrics browser.

Por defecto, ese cuadro tiene esto:

node_hwmon_temp_celsius{job="node", chip="", sensor=""}

Hay dos campos en este texto que actualmente están en blanco: chip y sensor. Estos son únicos para cada máquina, por lo que tendrás que completarlos según lo que proporcione tu máquina.

Para hacer esto, sigue estos pasos:

1. Elimina la porción , sensor="" para que termine con chip=""}. Para mayor claridad, todo ahora debería ser node_hwmon_temp_celsius{job="node", chip=""}.
2. Coloca tu cursor entre las comillas de chip="" y presiona Ctrl+Spacebar. Esto abrirá un cuadro de autocompletado con las opciones disponibles, que se ve así:

3. Selecciona la opción que corresponda al CPU de tu sistema.
4. Una vez seleccionado, agrega , sensor="" de vuelta a la cadena. Coloca tu cursor entre las comillas de sensor="" y presiona Ctrl+Spacebar para obtener otro menú de autocompletado. Selecciona el sensor que deseas monitorear.

k10temp-pci-00c3
Tctl:
  temp1_input: 33.500
Tdie:
  temp2_input: 33.500

Una vez que estés satisfecho con tus selecciones, haz clic en el botón azul Apply en la esquina superior derecha de la pantalla para guardar la configuración.

#SSD Latency

El gráfico SSD Latency rastrea cuánto tiempo toman las operaciones de lectura/escritura. Esto es útil para medir qué tan rápido es tu SSD, para que sepas si se convierte en un cuello de botella si tu validador sufre de bajo rendimiento. Para actualizar el SSD que deseas rastrear en el gráfico, haz clic en el título SSD Latency y selecciona Edit.

Este gráfico tiene cuatro campos de consulta (cuatro cuadros de texto) con ocho porciones device="" en total. Necesitarás actualizar las primeras cuatro de estas porciones con el dispositivo que deseas rastrear.

Simplemente coloca tu cursor entre las comillas y presiona Ctrl+Spacebar para obtener la lista de autocompletado de Grafana, y selecciona la opción correcta desde allí para cada una de las porciones device="". Quieres comenzar desde la configuración vacía más a la izquierda primero, o la lista de autocompletado puede no aparecer.

lsblk

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
...
loop25        7:25   0   132K  1 loop /snap/gtk2-common-themes/9
loop26        7:26   0  65,1M  1 loop /snap/gtk-common-themes/1515
nvme0n1     259:0    0 238,5G  0 disk
├─nvme0n1p1 259:1    0   512M  0 part /boot/efi
├─nvme0n1p2 259:2    0 150,1G  0 part /
├─nvme0n1p3 259:3    0  87,4G  0 part
└─nvme0n1p4 259:4    0   527M  0 part

Opcionalmente, también puedes rastrear la latencia de un segundo disco en tu sistema. Esto está dirigido a personas que mantienen su sistema operativo y datos de cadena en unidades separadas. Para configurar esto, simplemente sigue las instrucciones anteriores para los últimos dos campos de consulta, sustituyendo los valores de la porción device="" con los del disco que deseas rastrear.

Una vez que estés satisfecho con tus selecciones, haz clic en el botón azul Apply en la esquina superior derecha de la pantalla para guardar la configuración.

#Network Usage

Este gráfico rastrea cuántos datos estás enviando y recibiendo sobre una conexión de red particular. Como podrías esperar, el panel necesita saber qué red deseas que rastree.

Para cambiarlo, haz clic en el título Network Usage y selecciona Edit.

Este gráfico tiene dos campos de consulta con dos porciones device="" en total. Necesitarás actualizar estas con la red que deseas rastrear.

Coloca tu cursor entre las comillas y presiona Ctrl+Spacebar para obtener la lista de autocompletado de Grafana, y selecciona la opción correcta desde allí para cada una de las porciones device="".

sudo route

Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
default         192.168.1.1     0.0.0.0         UG    100    0        0 eth0
192.168.1.0     0.0.0.0         255.255.255.0   U     0      0        0 eth0
192.168.1.1     0.0.0.0         255.255.255.255 UH    100    0        0 eth0

Una vez que estés satisfecho con tus selecciones, haz clic en el botón azul Apply en la esquina superior derecha de la pantalla para guardar la configuración.

#Total Net I/O

Esto rastrea la cantidad total de datos que has enviado y recibido. Podrías encontrarlo útil para observar si, por ejemplo, tu ISP te limita a una cierta cantidad de datos por mes.

La configuración es idéntica al cuadro Network Usage anterior, así que simplemente sigue esas instrucciones para este cuadro también.

#Disk Space Used

Esto mantiene un registro de qué tan lleno se está volviendo tu disco del sistema operativo, para que sepas cuándo es hora de limpiar (y si tus datos de cadena viven en la misma unidad, hora de podar Geth o Nethermind).

Los pasos son los mismos que el cuadro SSD Latency anterior, así que simplemente sigue esas instrucciones para este cuadro también. Como recordatorio, quieres la unidad que alberga la partición que tiene / en la columna MOUNTPOINT para este porque ese será tu disco del sistema operativo. Completa esto en el primer campo de consulta.

Opcionalmente, también puedes rastrear el espacio libre de un segundo disco en tu sistema. Esto está dirigido a personas que mantienen su sistema operativo y datos de cadena en unidades separadas. Configura esto siguiendo el mismo proceso, pero en lugar de buscar qué partición tiene / en la columna MOUNTPOINT, quieres buscar la que tiene cualquier punto de montaje de tu segunda unidad. Actualiza el segundo campo de consulta con el disco asociado con esa partición.

#Disk Temp

Esto rastrea la temperatura actual de tu disco del sistema operativo. Los pasos son los mismos que el cuadro CPU Temp anterior, así que simplemente sigue esas instrucciones para este cuadro también, sustituyendo los valores de chip y sensor de CPU con los de tu disco del sistema operativo. Completa estos valores en el primer campo de consulta.

Opcionalmente, también puedes rastrear la temperatura actual de un segundo disco en tu sistema. Configura esto siguiendo el mismo proceso, sustituyendo los valores de chip y sensor con los de tu segunda unidad. Completa estos valores en el segundo campo de consulta.

#Personalizando el Panel

Aunque el panel estándar intenta hacer un buen trabajo capturando todo lo que querrías ver de un vistazo, es bastante fácil personalizar un panel de Grafana como quieras. ¡Puedes agregar nuevos gráficos, cambiar la forma en que se ven los gráficos, mover cosas, y mucho más!

Echa un vistazo a la página de Tutoriales de Grafana para aprender cómo jugar con él y configurarlo a tu gusto.

#Personalizando el Stack de Métricas

Las herramientas utilizadas en el Stack de Métricas de Rocket Pool ofrecen una amplia gama de opciones de configuración más allá de lo que se incluye en la instalación predeterminada de Rocket Pool. Esta sección incluye ejemplos de configuración para diferentes casos de uso.

En general, las opciones de configuración de Grafana deben pasarse utilizando variables de entorno en override/grafana.yml. Cualquier opción de configuración se puede convertir en una variable de entorno usando la siguiente sintaxis:

GF_<SectionName>_<KeyName>

#Configuración SMTP de Grafana para Enviar Correos

Para enviar correos desde Grafana, por ejemplo para alertas o para invitar a otros usuarios, las configuraciones SMTP deben configurarse en el Stack de Métricas de Rocket Pool. Consulta la página de configuración SMTP de Grafana para referencia.

version: "3.7"
services:
grafana:
x-rp-comment: Add your customizations below this line
environment:
## SMTP settings start, replace values with those of your SMTP provider
- GF_SMTP_ENABLED=true
- GF_SMTP_HOST=mail.example.com:`port` # Gmail users should use smtp.gmail.com:587
- GF_SMTP_USER=admin@example.com
- GF_SMTP_PASSWORD=password
- GF_SMTP_FROM_ADDRESS=admin@example.com
- GF_SMTP_FROM_NAME="Rocketpool Grafana Admin"
## SMTP server settings end

[smtp]
enabled = true
host = mail.example.com:`port` # Gmail users should use smtp.gmail.com:587
user = admin@example.com
# If the password contains # or ; you have to wrap it with triple quotes. Ex """#password;"""
password = """passw0rd"""
from_address = admin@example.com
from_name = "Rocketpool Grafana Admin"

Después de hacer estas modificaciones, ejecuta lo siguiente para aplicar los cambios:

docker stop rocketpool_grafana

rocketpool service start

sudo systemctl restart grafana-server

Para probar la configuración SMTP, ve al menú Alerting y haz clic en Contact points.

Haz clic en New contact point y selecciona Email como tipo de punto de contacto. Ingresa una dirección de correo en la sección Addresses y haz clic en Test.

Verifica que se haya recibido el correo de prueba. Haz clic en Save contact point* cuando termines.