Invia le metriche di Config Sync a un sistema di monitoraggio personalizzato

La pagina descrive come inviare le metriche da Config Sync a un Esportatore OpenTelemetry.

Attenzione: questa soluzione è fornita per comodità e non è gestita da Config Sync. Le configurazioni personalizzate hanno la precedenza sulle impostazioni predefinite e persiste tra un upgrade e l'altro. Config Sync tenta di mantenere coerenza delle metriche.

Config Sync utilizza OpenCensus per creare e registrare metriche e OpenTelemetry per esportare le relative metriche. Questa pagina spiega come configurare queste metriche in un esportatore personalizzato. Per altri modi per esportare le metriche, consulta Monitorare Config Sync con Cloud Monitoring oppure Monitora Config Sync con Prometheus.

Configura un esportatore OpenTelemetry personalizzato

Se vuoi inviare le metriche a un sistema di monitoraggio diverso da Prometheus o Cloud Monitoring può modificare la configurazione OpenTelemetry. Per una lista sistemi di monitoraggio supportati, Esportatori per la raccolta OpenTelemetry e gli esportatori di OpenTelemetry Collector-Contrib.

Le risorse di monitoraggio di OpenTelemetry sono gestite in un ambiente config-management-monitoring. Per configurare un sistema OpenTelemetry personalizzato da utilizzare con Config Sync, è necessario creare un ConfigMap nome otel-collector-custom nello spazio dei nomi config-management-monitoring. Il ConfigMap deve contenere una chiave otel-collector-config.yaml e il valore dovrebbe essere il contenuto del file della configurazione personalizzata di OpenTelemetry Collector. Per ulteriori informazioni sulle opzioni di configurazione, consulta Documentazione sulla configurazione di OpenTelemetry Collector.

Il seguente ConfigMap è un esempio di ConfigMap con un esportatore di log personalizzato:

# otel-collector-custom-cm.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: otel-collector-custom
  namespace: config-management-monitoring
  labels:
    app: opentelemetry
    component: otel-collector
data:
  otel-collector-config.yaml: |
    receivers:
      opencensus:
    exporters:
      logging:
        logLevel: debug
    processors:
      batch:
    extensions:
      health_check:
    service:
      extensions: [health_check]
      pipelines:
        metrics:
          receivers: [opencensus]
          processors: [batch]
          exporters: [logging]

Tutte le configurazioni personalizzate devono definire un ricevitore opencensus e metrics una pipeline o un blocco note personalizzato. Gli altri campi sono facoltativi e configurabili, ma consigliamo di includere un processore batch e un'estensione per il controllo di integrità come nelle esempio.

Dopo aver creato un ConfigMap, utilizza kubectl per creare la risorsa:

kubectl apply -f otel-collector-custom-cm.yaml

Il deployment OpenTelemetry Collector seleziona questo ConfigMap e automaticamente per applicare la configurazione personalizzata.

Limitazioni

Quando esegui l'upgrade di Config Sync a una nuova versione, se hai creato otel-collector-custom ConfigMap per una versione precedente, le tue impostazioni personalizzate potrebbe non essere compatibile con la nuova versione di Config Sync. Per Ad esempio, i nomi, le etichette e gli attributi delle metriche possono cambiare Versioni di Config Sync.

Le modifiche apportate alle metriche di Config Sync vengono annunciate nella note di rilascio. Queste modifiche potrebbero richiedere aggiorna la configurazione personalizzata di otel-collector.

A causa di questa limitazione, consigliamo di utilizzare solo metriche personalizzate configurazioni per soluzioni temporanee. Se ritieni di dover utilizzare un modello configurazione, invia un ticket di assistenza per richiedere la soluzione alternativa la funzionalità o la correzione di un bug.