Monitoring con Prometheus
Prometheus è un sistema di monitoring open source. Viene spesso usato in combinazione ad Alertmanager per la gestione alert o Grafana per la gestione delle dashboard e alert.
Proxima OnSite e Proxima Carrier dalla versione 2.4.0 espongono delle metriche di sistema per Prometheus.
Per attivare questa funzionalità bisogna andare in Avanzate -> Configurazione Sistema -> Monitor e definire i Profili SIP che si vuole andare a monitorare. Inoltre è possibile attivare delle metriche opzionali.
Dopo aver definito i Profili SIP è necessario andare in Avanzate -> Firewall -> Regole e nella sezione “Proteggi le metriche Prometheus” aggiungere gli IP e/o le subnet che si vuole abilitare alla consultazione delle metriche e salvare.
Le metriche sono accessibili alle seguenti URL:
- Metriche “nginx” (web): https://FQDN_PROXIMA/api/service/monitor/nginx/metrics
- Metriche “node” (sistema): https://FQDN_PROXIMA/api/service/monitor/node/metrics
- Metriche “PostgreSQL” (database): https://FQDN_PROXIMA/api/service/monitor/psql/metrics
- Metriche “switch” (VoIP): https://FQDN_PROXIMA/api/service/monitor/switch/metrics
- Metriche “xmpp” (chat): https://FQDN_PROXIMA/api/service/monitor/xmpp/metrics
La frequenza consigliata di aggiornamento delle metriche è di 30 secondi.
Di seguito riportiamo un esempio parziale della configurazione usata in Prometheus (sezione scrape_configs):
scrape_configs:
- job_name: 'proximanginx'
metrics_path: /api/service/monitor/nginx/metrics
scheme: https
scrape_interval: 30s
file_sd_configs:
- files:
- scrape_configs/proxima.json
- job_name: 'proximanode'
metrics_path: /api/service/monitor/node/metrics
scheme: https
scrape_interval: 15s
file_sd_configs:
- files:
- scrape_configs/proxima.json
- job_name: 'proximapsql'
metrics_path: /api/service/monitor/psql/metrics
scheme: https
scrape_interval: 30s
file_sd_configs:
- files:
- scrape_configs/proxima.json
- job_name: 'proximaswitch'
metrics_path: /api/service/monitor/switch/metrics
scheme: https
scrape_interval: 30s
file_sd_configs:
- files:
- scrape_configs/proxima.json
- job_name: 'proximaxmpp'
metrics_path: /api/service/monitor/xmpp/metrics
scheme: https
scrape_interval: 30s
file_sd_configs:
- files:
- scrape_configs/proxima.json
Di seguito riportiamo un esempio della configurazione nel file scrape_configs/proxima.json menzionato nella precedente configurazione:
[
{
"targets": [
"FQDN_PROXIMA:443"
],
"labels": {
"job": "node",
"instance": "FQDN_PROXIMA"
}
}
]
Interrogando le URL delle metriche tramite un browser è possibile reperire i dati e le relative descrizioni. Es:
# HELP fs_status FreeSWITCH status. (1 = yes, 0 = no).
# TYPE fs_status gauge
fs_status 1
“# HELP” riporta la descrizione della metrica.
“# TYPE” riporta la tipologia di metrica.
Quindi fs_status uguale a 1 segnala che FreeSWITCH (VoIP) è online.