Questa pagina è stata tradotta dall'API Cloud Translation.

Raccogliere le metriche di Prometheus

Questo documento descrive la configurazione e l'utilizzo di un ricevitore di metriche di Ops Agent che puoi utilizzare per raccogliere le metriche da Prometheus su Compute Engine. Questo documento descrive anche un esempio che puoi utilizzare per provare il ricevitore.

Gli utenti di Google Kubernetes Engine sono stati in grado di raccogliere le metriche di Prometheus utilizzando Google Cloud Managed Service per Prometheus. Il ricevitore Prometheus di Ops Agent offre agli utenti di Compute Engine la stessa funzionalità.

Puoi utilizzare tutti gli strumenti forniti da Cloud Monitoring, incluso PromQL, per visualizzare e analizzare i dati raccolti dal ricevitore Prometheus. Ad esempio, puoi utilizzare Esplora metriche, come descritto nella console Google Cloud per il monitoraggio, per eseguire query sui dati. Puoi anche creare dashboard e regole di avviso di Cloud Monitoring per monitorare le metriche di Prometheus. Ti consigliamo di utilizzare PromQL come linguaggio di query per le metriche di Prometheus.

Puoi anche visualizzare le metriche di Prometheus in interfacce esterne a Cloud Monitoring, come l'interfaccia utente di Prometheus e Grafana.

Scegli il destinatario giusto

Prima di decidere di utilizzare il ricevitore Prometheus, determina se esiste già un'integrazione di Ops Agent per l'applicazione che stai utilizzando. Per informazioni sulle integrazioni esistenti con Ops Agent, consulta Monitoraggio di applicazioni di terze parti. Se esiste un'integrazione, ti consigliamo di utilizzarla. Per ulteriori informazioni, consulta Scegliere un'integrazione esistente.

Ti consigliamo di utilizzare il ricevitore Prometheus di Ops Agent quando si verificano le seguenti condizioni:

Hai esperienza nell'utilizzo di Prometheus, ti basi sullo standard Prometheus e comprendi in che modo fattori come l'intervallo di scansione e la cardinalità possono influire sui costi. Per ulteriori informazioni, consulta la sezione Scegliere il visualizzatore Prometheus.
Il software che stai monitorando non fa già parte dell'insieme di integrazioni di Ops Agent esistenti.

Integrazioni esistenti

L'agente operativo fornisce integrazioni per una serie di applicazioni di terze parti. Queste integrazioni ti offrono quanto segue:

Un insieme di metriche workload.googleapis.com selezionate per l'applicazione
Una dashboard per visualizzare le metriche.

Le metriche importate utilizzando un'integrazione esistente sono soggette ai prezzi basati sui byte per le metriche raccolte dagli agenti. Il numero e i tipi di metriche sono noti in anticipo e puoi utilizzare queste informazioni per stimare i costi.

Ad esempio, se utilizzi l'integrazione del server web Apache (httpd), Ops Agent raccoglie cinque metriche scalari; ogni punto dati viene conteggiato come 8 byte. Se mantieni la frequenza di campionamento predefinita di 60 secondi di Ops Agent, il numero di byte importati al giorno è 57.600 * il numero di host:

8 (byte) * 1440 (minuti al giorno) * 5 (metriche) * n (host) oppure
57.600 * n (host)

Per ulteriori informazioni sulla stima dei costi, consulta la sezione Esempi di prezzi in base ai byte importati.

Il ricevitore Prometheus

Quando utilizzi Ops Agent per raccogliere le metriche Prometheus, si applica quanto segue:

Il numero e la cardinalità delle metriche emesse dalla tua applicazione sono sotto il tuo controllo. Non esiste un insieme selezionato di metriche. La quantità di dati acquisiti è determinata dalla configurazione dell'applicazione Prometheus e del ricevitore Prometheus di Ops Agent.
Le metriche vengono importate in Cloud Monitoring come metriche prometheus.googleapis.com. Queste metriche vengono classificate come un tipo di metriche "personalizzate" quando vengono importate in Cloud Monitoring e sono soggette alle quote e ai limiti per le metriche personalizzate.
Devi progettare e creare le dashboard di Cloud Monitoring di cui hai bisogno, in base all'insieme di metriche che importi e alle esigenze della tua attività. Per informazioni sulla creazione di dashboard, consulta Dashboard e grafici.
I prezzi per l'importazione delle metriche si basano sul numero di campioni importati. Per stimare i costi quando utilizzi il ricevitore Prometheus, devi determinare il numero di campioni che probabilmente raccoglierai durante un ciclo di fatturazione. La stima si basa sui seguenti fattori:
- Numero di metriche scalari; ogni valore è un campione
- Numero di metriche di distribuzione; ogni istogramma viene conteggiato come (2 + numero di bucket nell'istogramma) campioni
- Frequenza di campionamento di ogni metrica
- Numero di host da cui vengono campionate le metriche
Per ulteriori informazioni sul conteggio dei campioni e sulla stima dei costi, consulta la sezione Esempi di prezzi in base ai campioni importati.

Prerequisiti

Per raccogliere le metriche Prometheus utilizzando il ricevitore Prometheus, devi installare Ops Agent versione 2.25.0 o successive.

Il ricevitore di Ops Agent richiede un endpoint che emetta metriche Prometheus. Pertanto, l'applicazione deve fornire direttamente un endpoint di questo tipo o utilizzare un'esportatrice o una libreria Prometheus per esporne uno. Molte librerie e framework di linguaggi come Spring e DropWizard o applicazioni come StatsD, DogStatsD e Graphite che emettono metriche non Prometheus possono utilizzare librerie client o esportatori Prometheus per emettere metriche in stile Prometheus. Ad esempio, per emettere le metriche Prometheus:

Gli utenti di Spring possono utilizzare la libreria Spring Metrics.
Gli utenti di StatsD possono utilizzare il pacchetto statsd_exporter.
Gli utenti di Graphite possono utilizzare il pacchetto graphite_exporter.

Quando le metriche Prometheus vengono emesse da un'applicazione, direttamente o utilizzando una libreria o un esportatore, possono essere raccolte da un Ops Agent configurato con un ricevitore Prometheus.

Configurazione dell'agente operativo

Il modello di configurazione di Ops Agent prevede in genere la definizione di quanto segue:

Destinatari, che determinano quali metriche vengono raccolte.
Processori, che descrivono in che modo Ops Agent può modificare le metriche.
Pipeline, che collegano i ricevitori e i processori in un servizio.

La configurazione per l'importazione delle metriche Prometheus è leggermente diversa: non sono coinvolti processori.

Configurazione per le metriche Prometheus

La configurazione di Ops Agent per l'importazione delle metriche di Prometheus è diversa dalla configurazione consueta come segue:

Non crei un processore Ops Agent per le metriche di Prometheus. Il ricevitore Prometheus supporta quasi tutte le opzioni di configurazione specificate dalla specifica scrape_config di Prometheus, incluse le opzioni di rinominazione.

Anziché utilizzare un'elaborazione di Ops Agent, qualsiasi elaborazione delle metriche viene eseguita utilizzando le sezioni relabel_configs e metric_relabel_configs della configurazione di scape, come specificato nel ricevitore Prometheus. Per ulteriori informazioni, consulta Rietichettatura: modifica dei dati sottoposti a scraping.
La pipeline Prometheus viene definita solo in termini di ricevitore Prometheus. Non specifichi alcun elaboratore. Inoltre, non puoi utilizzare ricevitori non Prometheus nella pipeline per le metriche Prometheus.

La maggior parte della configurazione del ricevitore è la specifica delle opzioni di scrape-config. Per brevità, omettendo queste opzioni, di seguito è riportata la struttura di una configurazione di Ops Agent che utilizza un ricevitore Prometheus. Specifica i valori di RECEIVER_ID e PIPELINE_ID.

metrics:
  receivers:
    RECEIVER_ID:
      type: prometheus
      config:
        scrape_configs:
          [... omitted for brevity ...]

  service:
    pipelines:
      PIPELINE_ID:
        receivers: [RECEIVER_ID]

La sezione seguente descrive il ricevitore Prometheus in modo più dettagliato. Per un esempio funzionale di un ricevitore e di una pipeline, consulta Aggiungere il ricevitore e la pipeline di Ops Agent.

Il ricevitore Prometheus

Per specificare un destinatario per le metriche di Prometheus, crea un destinatario delle metriche di tipo prometheus e specifica un insieme di opzioni scrape_config. Il ricevitore supporta tutte le opzioni di Prometheus scrape_config, ad eccezione di quanto segue:

Le sezioni di discovery del servizio, *_sd_config.
L'impostazione honor_labels.

Di conseguenza, puoi copiare le configurazioni di scansione esistenti e utilizzarle per Ops Agent con poche o nessuna modifica.

La struttura completa del ricevitore Prometheus è riportata di seguito:

metrics:
  receivers:
    prom_application:
      type: prometheus
      config:
        scrape_configs:
          - job_name: 'STRING' # must be unique across all Prometheus receivers
              scrape_interval: # duration, like 10m or 15s
              scrape_timeout:  # duration, like 10m or 15s
              metrics_path: # resource path for metrics, default = /metrics
              honor_timestamps: # boolean, default = false
              scheme: # http or https, default = http
              params:
                - STRING: STRING
              basic_auth:
                username: STRING
                password: SECRET
                password_file: STRING
              authorization:
                type: STRING # default = Bearer
                credentials: SECRET
                credentials_file: FILENAME

              oauth2: OAUTH2 # See Prometheus oauth2
              follow_redirects: # boolean, default = true
              enable_http2: # boolean, default = true
              tls_config: TLS_CONFIG # See Prometheus tls_config
              proxy_url: STRING

              static_configs:
                STATIC_CONFIG # See Prometheus static_config
              relabel_configs:
                RELABEL_CONFIG # See Prometheus relabel_config
              metric_relabel_configs:
                METRIC_RELABEL_CONFIGS # See Prometheus metric_relabel_configs

Per esempi di configurazioni di rinominazione, consulta Configurazione aggiuntiva del ricevitore.

Esempio: configurazione di Ops Agent per Prometheus

Questa sezione mostra un esempio di come configurare Ops Agent per raccogliere le metriche Prometheus da un'applicazione. Questo esempio utilizza l'esportatore JSON fornito dalla community di Prometheus (json_exporter), che espone le metriche di Prometheus sulla porta 7979.

La configurazione dell'esempio richiede le seguenti risorse, che potrebbe essere necessario installare:

git
curl
make
python3
Linguaggio Go, versione 1.19 o successive

Creare o configurare l'applicazione

Per ottenere ed eseguire JSON Exporter, segui la procedura riportata di seguito:

Clona il repository json_exporter ed esegui il check out dell'esportatore eseguendo i seguenti comandi:

git clone https://github.com/prometheus-community/json_exporter.git

cd json_exporter

git checkout v0.5.0

Compila l'esportatore eseguendo il seguente comando:
```
make build
```
Avvia il server HTTP Python eseguendo il seguente comando:
```
python3 -m http.server 8000 &
```
Avvia l'esportatore JSON eseguendo il seguente comando:
```
./json_exporter --config.file examples/config.yml &
```

Esegui una query su JSON Exporter per verificare che sia in esecuzione ed esponga le metriche sulla porta 7979:

curl "http://localhost:7979/probe?module=default&target=http://localhost:8000/examples/data.json"

Se la query è andata a buon fine, viene visualizzato un output simile al seguente:

# HELP example_global_value Example of a top-level global value scrape in the json
# TYPE example_global_value untyped
example_global_value{environment="beta",location="planet-mars"} 1234
# HELP example_value_active Example of sub-level value scrapes from a json
# TYPE example_value_active untyped
example_value_active{environment="beta",id="id-A"} 1
example_value_active{environment="beta",id="id-C"} 1
# HELP example_value_boolean Example of sub-level value scrapes from a json
# TYPE example_value_boolean untyped
example_value_boolean{environment="beta",id="id-A"} 1
example_value_boolean{environment="beta",id="id-C"} 0
# HELP example_value_count Example of sub-level value scrapes from a json
# TYPE example_value_count untyped
example_value_count{environment="beta",id="id-A"} 1
example_value_count{environment="beta",id="id-C"} 3

In questo output, le stringhe come example_value_active sono i nomi delle metriche, con le etichette e i valori tra parentesi graffe. Il valore dei dati segue l'insieme di etichette.

Aggiungi il ricevitore e la pipeline di Ops Agent

Per configurare Ops Agent in modo che importi le metriche dall'applicazione JSON Exporter, devi modificare la configurazione dell'agente per aggiungere un ricevitore e una pipeline Prometheus. Per l'esempio di Esportatore JSON, utilizza la seguente procedura:

Modifica il file di configurazione di Ops Agent,/etc/google-cloud-ops-agent/config.yaml, e aggiungi le seguenti voci di pipeline e del ricevitore Prometheus:

metrics:
  receivers:
    prometheus:
        type: prometheus
        config:
          scrape_configs:
            - job_name: 'json_exporter'
              scrape_interval: 10s
              metrics_path: /probe
              params:
                module: [default]
                target: [http://localhost:8000/examples/data.json]
              static_configs:
                - targets: ['localhost:7979']
  service:
    pipelines:
      prometheus_pipeline:
        receivers:
          - prometheus

Se in questo file sono già presenti altre voci di configurazione, aggiungi il ricevitore e la pipeline Prometheus alle voci metrics e service esistenti. Per ulteriori informazioni, consulta Configurazioni delle metriche.

Per esempi di configurazioni di rinominazione nel ricevitore, consulta Configurazione aggiuntiva del ricevitore.

Riavvia l'Ops Agent

Per applicare le modifiche alla configurazione, devi riavviare Ops Agent.

LINUX

Per riavviare l'agente, esegui il seguente comando sull'istanza:
```
sudo service google-cloud-ops-agent restart
```
Per verificare che l'agente sia stato riavviato, esegui il seguente comando e verifica che i componenti "Metrics Agent" e "Logging Agent" siano stati avviati:
```
sudo systemctl status google-cloud-ops-agent"*"
```

Windows

Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.
Per riavviare l'agente, esegui il seguente comando PowerShell:
```
Restart-Service google-cloud-ops-agent -Force
```
Per verificare che l'agente sia stato riavviato, esegui il seguente comando e verifica che i componenti "Metrics Agent" e "Logging Agent" siano stati avviati:
```
Get-Service google-cloud-ops-agent*
```

Metriche Prometheus in Cloud Monitoring

Puoi utilizzare gli strumenti forniti da Cloud Monitoring con i dati raccolti dal ricevitore Prometheus. Ad esempio, puoi rappresentare i dati in un grafico utilizzando Metrics Explorer, come descritto nella console Google Cloud per il monitoraggio. Le sezioni seguenti descrivono gli strumenti di query disponibili in Cloud Monitoring con Metrics Explorer:

Puoi creare dashboard e criteri di avviso di Cloud Monitoring per le tue metriche. Per informazioni sulle dashboard e sui tipi di grafici che puoi utilizzare, consulta Dashboard e grafici. Per informazioni sui criteri di avviso, consulta Utilizzare i criteri di avviso.

Puoi anche visualizzare le metriche in altre interfacce, come l'UI di Prometheus e Grafana. Per informazioni sulla configurazione di queste interfacce, consulta le seguenti sezioni della documentazione di Google Cloud Managed Service per Prometheus:

Utilizzare PromQL

PromQL è il linguaggio di query consigliato per le metriche importate utilizzando il ricevitore Prometheus.

Il modo più semplice per verificare che i dati di Prometheus vengano importati è utilizzare la pagina Esplora metriche di Cloud Monitoring nella console Google Cloud:

Nella console Google Cloud, vai alla pagina Esplora metriche:
Vai a Esplora metriche

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante MQL o PromQL.
Verifica che PromQL sia selezionato nel pulsante di attivazione/disattivazione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
Inserisci la seguente query nell'editor e poi fai clic su Esegui query:
```
up
```

Se i dati vengono importati, viene visualizzato un grafico come il seguente:

Grafico di Metrics Explorer per la metrica json-exporter up.

Se esegui l'esempio di Esportatore JSON, puoi anche eseguire query come la seguente:

Esegui query su tutti i dati di una metrica esportata specifica per nome, ad esempio:
```
example_value_count
```
Di seguito è riportato un grafico per example_value_count, che include le etichette definite dall'applicazione JSON Exporter e quelle aggiunte dall'Ops Agent:
Esegui query sui dati di una metrica esportata che ha avuto origine in un ambito specifico. Il valore dell'etichetta namespace è l'ID istanza Compute Engine, un numero lungo come 5671897148133813325, assegnato alla VM. Una query ha il seguente aspetto:
```
example_value_count{namespace="INSTANCE_ID"}
```
Esegui query sui dati che corrispondono a un'espressione regolare specifica. JSON Exporter emette metriche con un'etichetta id che ha valori come id-A, id-B, id-C. Per filtrare in base alle metriche con un'etichetta id corrispondente a questo pattern, utilizza la seguente query:
```
example_value_count{id=~"id.*"}
```

Per ulteriori informazioni sull'utilizzo di PromQL in Metrics Explorer e nei grafici di Cloud Monitoring, consulta PromQL in Cloud Monitoring.

Utilizzare MQL

Per visualizzare i dati di Prometheus come serie temporali di Cloud Monitoring e creare grafici e dashboard, puoi anche utilizzare le interfacce basate su menu o MQL. Di seguito è riportata una semplice query in Metrics Explorer:

Nella console Google Cloud, vai alla pagina Esplora metriche:
Vai a Esplora metriche

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Specifica i dati da visualizzare nel grafico. Oltre a utilizzare la scheda PromQL descritta in precedenza, puoi anche utilizzare MQL.
- Per utilizzare MQL:
  1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante MQL o PromQL.
  2. Verifica che sia selezionato MQL nel pulsante di attivazione/disattivazione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
  3. Inserisci la seguente query:
```
fetch prometheus_target::prometheus.googleapis.com/up/gauge
```
  4. Fai clic su Esegui query.
- Per utilizzare l'interfaccia basata su menu:
  1. Nel campo Tipo di risorsa, digita "prometheus" per filtrare l'elenco, quindi seleziona Destinazione Prometheus.
  2. Nel campo Metrica, digita "up/" per filtrare l'elenco, quindi seleziona prometheus/up/gauge.

Il grafico risultante da una di queste query mostra gli stessi dati del grafico mostrato con l'esempio PromQL.

La risorsa `prometheus_target`

In Cloud Monitoring, i dati delle serie temporali vengono scritti in base a un tipo di risorsa monitorata. Per le metriche Prometheus, il tipo di risorsa monitorata è prometheus_target. Le query di monitoraggio per le metriche Prometheus non scritte in PromQL devono specificare questo tipo di risorsa.

La risorsa prometheus_target ha le seguenti etichette, che puoi utilizzare per filtrare e manipolare i dati sottoposti a query:

project_id: l'identificatore del progetto Google Cloud, ad esempio my-project, in cui è in esecuzione l&#Ops Agent.
location: la regione Google Cloud o AWS in cui è in esecuzione l'Ops Agent, ad esempio us-east1-a (Google Cloud) o aws:us-east-1a (AWS).
cluster: sempre __gce__ per le metriche Prometheus raccolte utilizzando l'Ops Agent.
namespace: l'ID istanza Compute Engine della VM su cui è in esecuzione Ops Agent.
job: il valore del campo job_name nella configurazione del ricevitore.
instance: l'etichetta dell'istanza del target Prometheus, presa dalla configurazione del ricevitore. Il valore predefinito è il target.

I valori di queste etichette vengono impostati durante la raccolta. I valori delle etichette namespace, location e cluster sono immutabili. Se le metriche tratte dalla tua applicazione hanno anche queste etichette, l'Ops Agent antepone alle etichette tratte la stringa exported_.

Visualizzare l'utilizzo delle metriche e la diagnostica in Cloud Monitoring

La pagina Gestione delle metriche di Cloud Monitoring fornisce informazioni che possono aiutarti a controllare la spesa per le metriche fatturabili senza influire sull'osservabilità. La pagina Gestione delle metriche riporta le seguenti informazioni:

Volumi di importazione sia per la fatturazione basata su byte che su sample, per i domini delle metriche e per le singole metriche.
Dati su etichette e cardinalità delle metriche.
Numero di letture per ogni metrica.
Utilizzo delle metriche nei criteri di avviso e nelle dashboard personalizzate.
Tasso di errori di scrittura delle metriche.

Puoi anche utilizzare la gestione delle metriche per escludere le metriche non necessarie, eliminando il costo di importazione.

Per visualizzare la pagina Gestione delle metriche:

Nella console Google Cloud, vai alla pagina Gestione delle metriche:
Vai a Gestione delle metriche

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Nella barra degli strumenti, seleziona l'intervallo di tempo. Per impostazione predefinita, la pagina Gestione delle metriche mostra informazioni sulle metriche raccolte nell'ultimo giorno.

Per ulteriori informazioni sulla pagina Gestione delle metriche, consulta Visualizzare e gestire l'utilizzo delle metriche.

Nuova etichettatura: modifica dei dati sottoposti a scraping

Puoi utilizzare la ridefinizione delle etichette per modificare l'insieme di etichette del target dello scraping o le relative metriche prima che il target venga sottoposto a scraping. Se in una configurazione di rinominazione sono presenti più passaggi, questi vengono applicati nell'ordine in cui compaiono nel file di configurazione.

L'agente operativo crea un insieme di meta etichette (etichette con prefisso della stringa __meta_. Queste meta etichette registrano le informazioni sull'istanza Compute Engine su cui è in esecuzione Ops Agent. Le etichette con prefisso __, incluse le meta etichette, sono disponibili solo durante la ridefinizione delle etichette. Puoi utilizzare la ridefinizione delle etichette per acquisire i valori di queste etichette nelle etichette sottoposte a scansione.

La ridesignazione delle metriche viene applicata ai campioni ed è l'ultimo passaggio prima dell'importazione. Puoi utilizzare la ridesignazione delle metriche per eliminare le serie temporali che non devi importare. L'eliminazione di queste serie temporali consente di ridurre il numero di campioni importati, il che può ridurre i costi.

Per ulteriori informazioni sul rinominazione, consulta la documentazione di Prometheus per relabel_config e metric_relabel_configs.

Etichette meta di Compute Engine disponibili durante il rinominazione

Quando Ops Agent esegue lo scraping delle metriche, include un insieme di meta etichette i cui valori si basano sulla configurazione della VM Compute Engine su cui è in esecuzione l'agente. Puoi utilizzare queste etichette e la sezione relabel_configs del ricevitore Prometheus per aggiungere metadati aggiuntivi alle metriche relative alla VM da cui sono stati importati. Per un esempio, consulta Configurazione aggiuntiva del ricevitore.

I seguenti meta-tag sono disponibili per i target e possono essere utilizzati nella sezione relabel_configs:

__meta_gce_instance_id: l'ID numerico dell'istanza Compute Engine (locale)
__meta_gce_instance_name: il nome dell'istanza Compute Engine (locale); Ops Agent inserisce automaticamente questo valore nell'etichetta instance_name mutabile delle metriche.
__meta_gce_machine_type: URL completo o parziale del tipo di macchina dell'istanza. Ops Agent inserisce automaticamente questo valore nell'etichetta machine_type mutabile delle metriche.
__meta_gce_metadata_NAME: ogni elemento dei metadati dell'istanza
__meta_gce_network: l'URL di rete dell'istanza
__meta_gce_private_ip: l'indirizzo IP privato dell'istanza
__meta_gce_interface_ipv4_NAME: indirizzo IPv4 di ogni interfaccia denominata
__meta_gce_project: il progetto Google Cloud in cui è in esecuzione l'istanza (locale)
__meta_gce_public_ip: l'indirizzo IP pubblico dell'istanza, se presente
__meta_gce_tags: elenco di tag istanza separati da virgole
__meta_gce_zone: l'URL della zona Compute Engine in cui è in esecuzione l'istanza

I valori di queste etichette vengono impostati all'avvio di Ops Agent. Se modifichi i valori, devi riavviare Ops Agent per aggiornarli.

Configurazione aggiuntiva del ricevitore

Questa sezione fornisce esempi che utilizzano le sezioni relabel_configs e metric_relabel_configs del ricevitore Prometheus per modificare il numero e la struttura delle metriche importate. Questa sezione include anche una versione modificata del ricevitore per l'esempio di Esportatore JSON che utilizza le opzioni di rinominazione.

Aggiungere metadati della VM

Puoi utilizzare la sezione relabel_configs per aggiungere etichette alle metriche. Ad esempio, il codice seguente utilizza un'etichetta meta, __meta_gce_zone, fornito dall'Ops Agent per creare un'etichetta metrica, zone, che viene conservata dopo la ridenominazione, perché zone non ha il prefisso __.

Per un elenco dei meta-etichette disponibili, consulta Meta-etichette di Compute Engine disponibili durante il rinomino. Alcune delle etichette meta vengono rinominate automaticamente dalla configurazione predefinita di Ops Agent.

relabel_configs:
  - source_labels: [__meta_gce_zone]
    regex: '(.+)'
    replacement: '${1}'
    target_label: zone

Il ricevitore Prometheus mostrato in Esempio: configurazione di Ops Agent per Prometheus include l'aggiunta di questa etichetta.

Metriche sui cali

Puoi utilizzare la sezione metrics_relabel_configs per eliminare le metriche che non vuoi importare. Questo pattern è utile per contenere i costi. Ad esempio, puoi utilizzare il seguente pattern per eliminare qualsiasi metrica con un nome corrispondente a METRIC_NAME_REGEX_1 o METRIC_NAME_REGEX_2:

metric_relabel_configs:
  - source_labels: [ __name__ ]
    regex: 'METRIC_NAME_REGEX_1'
    action: drop
  - source_labels: [ __name__ ]
    regex: 'METRIC_NAME_REGEX_2'
    action: drop

Aggiungere etichette statiche

Puoi utilizzare la sezione metrics_relabel_configs per aggiungere etichette statiche a tutte le metriche importate dal ricevitore Prometheus. Puoi utilizzare il seguente pattern per aggiungere le etichette staticLabel1 e staticLabel2 a tutte le metriche importate:

metric_relabel_configs:
  - source_labels: [ __address__ ]
    action: replace
    replacement: 'STATIC_VALUE_1'
    target_label: staticLabel1
  - source_labels: [ __address__ ]
    action: replace
    replacement: 'STATIC_VALUE_2'
    target_label: staticLabel2

La seguente versione del ricevitore Prometheus per l'esempio di JSON Exporter utilizza questi pattern di configurazione per:

Imposta l'etichetta zone dal valore dell'etichetta meta __meta_gce_zone fornito dall'Ops Agent.
Trascina la metrica example_global_value dell'esportatore.
Aggiungi l'etichetta staticLabel con il valore "Un valore statico" a tutte le metriche importate.

metrics:
  receivers:
    prometheus:
        type: prometheus
        config:
          scrape_configs:
            - job_name: 'json_exporter'
              scrape_interval: 10s
              metrics_path: /probe
              params:
                module: [default]
                target: [http://localhost:8000/examples/data.json]
              static_configs:
                - targets: ['localhost:7979']
              relabel_configs:
                - source_labels: [__meta_gce_zone]
                  regex: '(.+)'
                  replacement: '${1}'
                  target_label: zone
              metric_relabel_configs:
                - source_labels: [ __name__ ]
                  regex: 'example_global_value'
                  action: drop
                - source_labels: [ __address__ ]
                  action: replace
                  replacement: 'A static value'
                  target_label: staticLabel

Raccogliere le metriche di Prometheus

Scegli il destinatario giusto

Integrazioni esistenti

Il ricevitore Prometheus

Prerequisiti

Configurazione dell'agente operativo

Configurazione per le metriche Prometheus

Il ricevitore Prometheus

Esempio: configurazione di Ops Agent per Prometheus

Creare o configurare l'applicazione

Aggiungi il ricevitore e la pipeline di Ops Agent

Riavvia l'Ops Agent

LINUX

Windows

Metriche Prometheus in Cloud Monitoring

Utilizzare PromQL

Utilizzare MQL

La risorsa prometheus_target

Visualizzare l'utilizzo delle metriche e la diagnostica in Cloud Monitoring

Nuova etichettatura: modifica dei dati sottoposti a scraping

Etichette meta di Compute Engine disponibili durante il rinominazione

Configurazione aggiuntiva del ricevitore

Aggiungere metadati della VM

Metriche sui cali

Aggiungere etichette statiche

La risorsa `prometheus_target`