Monitoraggio metriche OpenTelemetry

Per prima cosa, devi attivare il collector quando l’istanza è inattiva. Puoi farlo come utente dell’istanza dalla riga di comando utilizzando omd config nel menu di configurazione testuale:

Vai su Addons e attiva OPENTELEMETRY_COLLECTOR:

Non è necessario modificare la porta per il monitoraggio del collector, poiché è impostata sulla porta libera successiva a partire da 14317, anche se vengono utilizzate più istanze.

Dopo aver attivato il collector, riavvia l'istanza con omd start.

Vai su Setup > Hosts > OpenTelemetry collector (experimental) e inizia a configurare un nuovo collector cliccando sul pulsante Add OpenTelemetry collector configuration:

In General properties, assegna un ID e un titolo al nuovo collettore. Per Site restriction, devi spostare almeno una voce dalla parte sinistra a quella destra. Nello screenshot qui sopra, l'istanza locale mysite è l'unica disponibile.

Per garantire che gli host vengano creati automaticamente, configura una nuova connessione OpenTelemetry con la gestione dinamica degli host. Come preparazione — almeno per i primi test — ti consigliamo di creare una cartella separata in cui archiviare gli host OpenTelemetry generati automaticamente.

Per configurare la nuova connessione per la gestione dinamica degli host, vai su Setup > Hosts > Dynamic host management > Add connection:

Effettua le seguenti impostazioni nella box Connection properties:

Completa la nuova connessione con Save.

Per garantire che vengano generati anche i servizi Checkmk, è necessario creare almeno una configurazione dell'special agent OpenTelemetry. La regola richiesta si trova in Setup > Agents > Other integrations > OpenTelemetry (experimental):

Nella box "OpenTelemetry (experimental)", decidi se vuoi effettuare il monitoraggio del Collettore OpenTelemetry stesso — tramite la porta visualizzata durante l'attivazione del Collettore.

Nella condizione della regola, è ovvio assegnare l'special agent alla cartella in cui verranno creati automaticamente gli host — nell'esempio, questa è la cartella OpenTelemetryTest.

Salva la regola con il nome Save.

Ora che i tre componenti — collector, gestione dinamica degli host e special agent — sono stati configurati, dovresti attivare le modifiche in sospeso.

Probabilmente vorrai configurare il Collettore OpenTelemetry per Checkmk perché da qualche parte nel tuo ambiente IT qualcosa sta già generando alcune metriche OpenTelemetry.

Se non è ancora così, o se vuoi provare rapidamente la Setup di esempio descritta in questo articolo, puoi farlo con l'applicazione di esempio "Hello metric" fornita nel nostro repository GitHub, che gira in un ambiente Python virtuale.

Ci vogliono circa due o tre minuti dal momento in cui vengono inviati i primi dati, l'host è stato creato e il servizio è stato rilevato, per poi diventare visibile nel monitoraggio. L'immagine seguente mostra i servizi dell'applicazione di esempio "Hello metric":

Il nome host hello-metric viene generato dal nome del servizio specificato come opzione nel comando opentelemetry-instrument — esattamente come specificato nella configurazione del Collettore OpenTelemetry. Il nome del servizio OTel metric hellolevel in Checkmk viene generato dal nome della metrica, con il prefisso OTel metric aggiunto dall'special agent.

Se attivi l'opzione Monitor the collector nella configurazione dell'special agent, ovvero il monitoraggio del collector, verranno creati diversi servizi aggiuntivi sull'host,

L'applicazione di esempio "Dice Roll" presentata sul sito web di OpenTelemetry funziona in modo molto simile a "Hello metric". Questa applicazione di esempio è sotto molti aspetti più pratica di "Hello metric". Ad esempio, "Dice Roll" invia metriche OpenTelemetry ogni volta che viene chiamato il server dell'applicazione (e solo allora!) e inserisce il tipo di dati "Contatore". Puoi utilizzare l'ambiente Python virtuale creato per l'esempio "Hello metric" per provare anche l'esempio "Dice Roll". Tuttavia, dovrai anche effettuare l'installazione del modulo Python flask (pip install flask) e creare il file app.py nella versione estesa con le metriche, come descritto in queste istruzioni.

Nella seguente chiamata, sostituisci il server Checkmk come destinazione (qui 198.51.100.42 con porta gRPC 4317):

Il tuo server Flask è ora pronto ed è accessibile alla porta selezionata (qui: 8080) per lanciare un dado ad ogni chiamata. Puoi vedere i dati del dado, ad esempio, come output di curl -v http://localhost:8080/rolldice. Ogni lancio di dado che attivi in questo modo viene trasmesso a Checkmk come punto dati.

Dopo pochi minuti, l'host dice-server apparirà nel monitoraggio con il servizio OTel metric dice.rolls. Questo presenta sei grafici, da Value_1__Per_Sec a Value_6__Per_Sec, che corrispondono alle frequenze dei numeri da uno a sei ottenuti finora. Il motivo della conversione è che le metriche OpenTelemetry utilizzano contatori, che possono solo incrementarsi — un tipo di dati non previsto in Checkmk. Per una visualizzazione più chiara, Checkmk esegue quindi la conversione tenendo conto della componente temporale.

Lo screenshot mostra uno di questi grafici, basato sulle chiamate una volta al secondo a /rolldice durante il periodo di monitoraggio.

Puoi impostare soglie e altro per i servizi utilizzando la regola Setup > Services > Service monitoring rules > OpenTelemetry (experimental). Qui puoi impostare regole per singole metriche o per tutte le metriche di un servizio. Lo screenshot di esempio mostra la selezione del contatore per gli errori con il numero 5, come mostrato sopra. I nomi delle metriche conosciute sono accessibili tramite l'elenco o come suggerimenti durante la digitazione. Puoi inserire metriche non ancora conosciute ma che sai che appariranno come testo libero.

A seconda del tipo di dati fornito dal punto dati OpenTelemetry, può essere utile calcolare le frequenze. Questo è utile per i contatori, ad esempio per i pacchetti di rete persi. Se più sorgenti dati forniscono dati assegnati allo stesso servizio Checkmk, puoi anche specificare se deve essere eseguita un'aggregazione (ad es. somma o media) o se devono avere la priorità semplicemente i punti dati più recenti, più grandi o più piccoli di un intervallo.