Utilizza esempi di Prometheus

Questo documento descrive come utilizzare Google Cloud Managed Service per Prometheus per importare gli esemplari Prometheus nelle metriche degli istogrammi. Devi utilizzare uno dei seguenti:

  • Versione della raccolta gestita di Managed Service per Prometheus 0.7.0 o versioni successive
  • Raccolta con deployment automatico di Managed Service per Prometheus versione 2.35.0-gmp.5-gke.0 o successiva
  • OpenTelemetry Collector

Gli esempi vengono in genere utilizzati per associare gli identificatori delle tracce ai dati metrici raccolti in un intervallo di tempo, ma possono essere utilizzati per associare qualsiasi dato non metrico alle metriche raccolte. La memorizzazione delle informazioni sulle tracce con i dati delle metriche consente di identificare rapidamente le tracce associate a un cambiamento improvviso dei valori delle metriche. Non è necessario eseguire manualmente il crociamento delle informazioni sulle tracce e dei dati delle metriche utilizzando i timestamp per identificare cosa stava accadendo nell'applicazione quando sono stati registrati i dati delle metriche.

Gli esempi di Managed Service per Prometheus sono compatibili con Cloud Trace e con strumenti di tracciamento di terze parti come Grafana Ritmo.

Il seguente screenshot mostra un grafico Grafana di insiemi di bucket a istogrammi e esempi associati, con un esempio espanso:

Grafico di Grafana che mostra bucket istogrammi e esempi.

Esemplari Prometheus in Managed Service per Prometheus

Gli esempi sono supportati in Prometheus tramite il protocollo OpenMetrics formato di esposizione. Un esempio OpenMetrics ha la seguente struttura:

  • Il valore dell'esempio deve essere un numero intero o un numero in virgola mobile a 64 bit.
  • (Facoltativo) Un timestamp: deve essere Epoch Unix secondi, può essere negativo.
  • Un numero di etichette per l'esemplare, in genere inclusi i valori trace_id e span_id; la lunghezza totale di tutti i nomi e i valori delle etichette non deve superare 128 caratteri UTF-8 o 128 rune nelle applicazioni Go.

Google Cloud Managed Service per Prometheus può importare solo gli esempi associati alle metriche dell'istogramma. Non è possibile importare gli esemplari associati alle metriche dei contatori. Le metriche degli istogrammi di Prometheus vengono convertite nel tipo Distribution di Cloud Monitoring analogo, che supporta gli esempi. Le metriche non di distribuzione in Cloud Monitoring non supportano gli esemplari.

Gli esemplari rimangono disponibili per le query per 24 mesi. Confronta questo periodo di conservazione con Prometheus a monte, in cui gli esempi vengono conservati solo mentre i dati vengono in memoria, generalmente per meno di 14 giorni. Managed Service per Prometheus memorizza gli esemplari con le serie temporali, pertanto vengono conservati in base alle norme di conservazione per le serie temporali. Per ulteriori informazioni sulla conservazione dei dati in Cloud Monitoring, consulta Conservazione dei dati.

Abilita l'importazione degli esempi

Se utilizzi Managed Service per Prometheus con la versione 0.7.0 o successive della raccolta gestita, l'importazione degli esemplari viene attivata automaticamente.

Se utilizzi Managed Service per Prometheus con deployment autonomo , devi abilitare l'importazione degli esemplari quando inizi al server specificando la seguente caratteristica flag:

--enable-feature=exemplar-storage

Scrivere metriche con esempi

Ogni client Prometheus ha le proprie istruzioni per l'utilizzo corretto esempi in quel client. Segui queste istruzioni in modo che la tua richiesta espone le metriche nel formato OpenMetrics affinché Prometheus possa eseguire lo scraping dall'endpoint /metrics dell'applicazione. Per esempi, consulta quanto segue:

Integrazione con Cloud Trace

Puoi scrivere istogrammi di Prometheus con esempi compatibili con Cloud Trace. Puoi visualizzare i dati, inclusi gli esempi, su un grafico della mappa termica di Cloud Monitoring, dove puoi utilizzare gli esempi per visualizzare i dettagli degli intervalli di traccia correlati. Puoi anche analizzare i dati di traccia in Trace. Per ulteriori informazioni, consulta Mostrare esempi su una mappa termica. grafico e Visualizza dettagli traccia.

Per creare esempi compatibili con Trace, gli esempi Prometheus devono contenere le seguenti etichette:

  • project_id
  • trace_id
  • span_id

Se l'esemplare include queste tre etichette, queste vengono utilizzate per creare un oggetto SpanContext compatibile con Trace che viene associato all'esemplare creato per il bucket Distribution di Cloud Monitoring.

Tutte le etichette diverse da quelle che compongono un SpanContext completo vengono aggiunte a un oggetto DroppedLabels associato all'esemplare per un bucket Distribution.

Metriche di query con esempi

L'API Prometheus espone l'endpoint api/v1/query_exemplars per eseguire query sugli esemplari.

Le interfacce di query configurate per interagire con Google Cloud Managed Service per Prometheus includono automaticamente le query sugli esempi. Per informazioni sull'impostazione le interfacce di query, vedi Eseguire query con Grafana o Eseguire query utilizzando API o UI Prometheus.