Configurazione di OpenMetrics per il monitoraggio dei servizi
Nota
Questa funzionalità è attualmente in Beta e il formato è soggetto a modifiche.
Questo argomento descrive un esempio di configurazione per l’impostazione del punto finale Prometheus / OpenMetrics nell’API di Megaport.
OpenMetrics è una specifica per la rappresentazione e lo scambio di dati metrici in un formato standardizzato, influenzata principalmente dal formato di esposizione Prometheus.
Con l’integrazione del punto finale OpenMetrics nell’API di Megaport, è possibile esporre le informazioni esistenti di monitoraggio del servizio.
Nell’esempio di configurazione Prometheus qui sotto, l’intervallo di raccolta è impostato su un minuto, ma la rete viene interrogata solo ogni cinque minuti. Dovrai considerare questo nella tua dashboard PromQL/Grafana.
Prima di iniziare, ottieni un token di accesso valido. Per ulteriori informazioni, vedi Creazione di una chiave API.
Dettagli API Megaport
- API: /v1/openmetrics
- Autenticazione: Chiave API/OAuth2
Esempio di configurazione Prometheus
global:
scrape_interval: 5m
scrape_configs:
- job_name: megaport
static_configs:
- targets: ["api.megaport.com"]
scheme: https
metrics_path: /v1/openmetrics
oauth2:
token_url: https://auth-m2m.megaport.com/oauth2/token
client_id: <chiave api>
client_secret: <segreto api>
Metriche
L’endpoint attualmente esporta queste metriche per tutti i servizi.
Porta
# HELP megaport_service_input_errors_total Il numero totale di errori in ingresso.
# TYPE megaport_service_input_errors_total counter
# HELP megaport_service_optical_receive_power_dbm Livello di potenza ottica ricevuta in dBm.
# TYPE megaport_service_optical_receive_power_dbm gauge
# HELP megaport_service_optical_transmit_power_dbm Livello di potenza ottica trasmessa in dBm.
# TYPE megaport_service_optical_transmit_power_dbm gauge
# HELP megaport_service_output_errors_total Il numero totale di errori in uscita.
# TYPE megaport_service_output_errors_total counter
# HELP megaport_service_receive_bytes_total Il numero totale di byte ricevuti.
# TYPE megaport_service_receive_bytes_total counter
# HELP megaport_service_receive_packets_total Il numero totale di pacchetti ricevuti.
# TYPE megaport_service_receive_packets_total counter
# HELP megaport_service_transmit_bytes_total Il numero totale di byte trasmessi.
# TYPE megaport_service_transmit_bytes_total counter
# HELP megaport_service_transmit_packets_total Il numero totale di pacchetti trasmessi.
# TYPE megaport_service_transmit_packets_total counter
# HELP megaport_service_up Stato operativo del servizio.
# TYPE megaport_service_up gauge
VXC
# HELP megaport_service_receive_bytes_total Il numero totale di byte ricevuti.
# TYPE megaport_service_receive_bytes_total counter
# HELP megaport_service_receive_packets_total Il numero totale di pacchetti ricevuti.
# TYPE megaport_service_receive_packets_total counter
# HELP megaport_service_transmit_bytes_total Il numero totale di byte trasmessi.
# TYPE megaport_service_transmit_bytes_total counter
# HELP megaport_service_transmit_packets_total Il numero totale di pacchetti trasmessi.
# TYPE megaport_service_transmit_packets_total counter
# HELP megaport_service_up Stato operativo del servizio.
# TYPE megaport_service_up gauge
MCR
# HELP megaport_service_receive_bytes_total Il numero totale di byte ricevuti.
# TYPE megaport_service_receive_bytes_total counter
# HELP megaport_service_receive_packets_total Il numero totale di pacchetti ricevuti.
# TYPE megaport_service_receive_packets_total counter
# HELP megaport_service_transmit_bytes_total Il numero totale di byte trasmessi.
# TYPE megaport_service_transmit_bytes_total counter
# HELP megaport_service_transmit_packets_total Il numero totale di pacchetti trasmessi.
# TYPE megaport_service_transmit_packets_total counter
# HELP megaport_service_up Stato operativo del servizio.
# TYPE megaport_service_up gauge
MVE
# HELP megaport_service_receive_bytes_total Il numero totale di byte ricevuti.
# TYPE megaport_service_receive_bytes_total counter
# HELP megaport_service_receive_packets_total Il numero totale di pacchetti ricevuti.
# TYPE megaport_service_receive_packets_total counter
# HELP megaport_service_transmit_bytes_total Il numero totale di byte trasmessi.
# TYPE megaport_service_transmit_bytes_total counter
# HELP megaport_service_transmit_packets_total Il numero totale di pacchetti trasmessi.
# TYPE megaport_service_transmit_packets_total counter
# HELP megaport_service_up Stato operativo del servizio.
# TYPE megaport_service_up gauge