Metriche delle etichette

Le risorse personalizzate MonitoringTarget in Google Distributed Cloud (GDC) air-gapped appliance ti consentono di etichettare le metriche sottoposte a scraping per differenziare le caratteristiche delle metriche e filtrare i dati delle serie temporali. Oltre a raccogliere le metriche, puoi configurare regole di ridenominazione per indirizzare le metriche a un altro progetto, aggiungere etichette coppia chiave-valore personalizzate o rinominare le metriche prima dell'importazione.

Ogni combinazione univoca di coppie di etichette chiave-valore crea una nuova serie temporale, che può aumentare in modo significativo lo spazio di archiviazione dei dati. Evita di utilizzare etichette per dimensioni ad alta cardinalità con molti valori possibili, come ID utente o indirizzi email. Per saperne di più sulla ridenominazione delle metriche, consulta Come funziona la ridenominazione in Prometheus.

Prima di iniziare

Per gestire le risorse personalizzate MonitoringTarget, richiedi le autorizzazioni necessarie all'amministratore.

Ruoli IAM richiesti

Contatta l'amministratore IAM del progetto per richiedere i seguenti ruoli:

  • MonitoringTarget Creator (monitoringtarget-creator): crea risorse personalizzate MonitoringTarget nello spazio dei nomi del progetto.
  • MonitoringTarget Editor (monitoringtarget-editor): modifica le risorse personalizzate MonitoringTarget nello spazio dei nomi del progetto.
  • MonitoringTarget Viewer (monitoringtarget-viewer): visualizza le risorse personalizzate MonitoringTarget nello spazio dei nomi del progetto.

Invia metriche a un altro progetto

Gli autori dei container possono programmare l'invio di metriche specifiche a un progetto diverso, anche a progetti di cui non sono proprietari. Per inviare una metrica a un progetto specifico, aggiungi l'etichetta _gdch_project alla metrica nel codice, impostando il relativo valore sul nome del progetto di destinazione.

In alternativa, utilizza la risorsa personalizzata MonitoringTarget per inviare tutti i dati delle metriche raccolti a un altro progetto. Imposta l'etichetta _gdch_project come etichetta di destinazione nel campo metricsRelabelings, con il nuovo nome del progetto come valore sostitutivo.

Il seguente esempio di codice mostra come impostare l'etichetta di destinazione _gdch_project nella risorsa personalizzata MonitoringTarget per inviare le metriche al progetto denominato another-project-name:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  [...]
  podMetricsEndpoints:
    [...]
    metricsRelabelings:
      - action: replace
        targetLabel: _gdch_project
        replacement: another-project-name
      [...]

Sostituisci quanto segue:

  • PROJECT_NAMESPACE: lo spazio dei nomi del progetto.
  • MONITORING_TARGET_NAME: il nome del file di definizione MonitoringTarget.

Aggiungi nuove etichette alle metriche

Le etichette aiutano con l'osservabilità e il monitoraggio identificando le caratteristiche delle metriche. Puoi aggiungere etichette che i container sottoposti a scraping non espongono inizialmente. Nella risorsa personalizzata MonitoringTarget, imposta la nuova etichetta come etichetta di destinazione e fornisci un valore sostitutivo. Questa coppia chiave-valore viene aggiunta a tutte le metriche raccolte dalla risorsa.

Il seguente esempio di codice mostra come impostare l'etichetta di destinazione my_new_label e configurare il relativo valore su my_label_value nella risorsa personalizzata MonitoringTarget:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  [...]
  podMetricsEndpoints:
    [...]
    metricsRelabelings:
      - action: replace
        targetLabel: my_new_label
        replacement: my_label_value
      [...]

Sostituisci quanto segue:

  • PROJECT_NAMESPACE: lo spazio dei nomi del progetto.
  • MONITORING_TARGET_NAME: il nome del file di definizione MonitoringTarget.

Rinomina una metrica

Puoi rinominare la metrica di un container utilizzando la risorsa MonitoringTarget. Imposta il nome della metrica originale e la sua sostituzione nel campo metricsRelabelings. Il nome originale viene trattato come un'espressione regolare (regex) e viene sostituito dal nuovo nome.

Il seguente esempio di codice mostra come sostituire il nome della metrica cpu_usage (regex) con cpu_usage_new_name nella risorsa personalizzata MonitoringTarget:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  [...]
  podMetricsEndpoints:
    [...]
    metricsRelabelings:
      - action: replace
        regex: cpu_usage
        replacement: cpu_usage_new_name
        sourceLabels: [__name__]
        targetLabel: __name__
      [...]

Sostituisci quanto segue:

  • PROJECT_NAMESPACE: lo spazio dei nomi del progetto.
  • MONITORING_TARGET_NAME: il nome del file di definizione MonitoringTarget.