YAML-Datei - Standard-Labels

Die von diesem Client verwendete YAML-Datei ist in mehrere Abschnitte unterteilt, die jeweils einen bestimmten Zweck erfüllen:
Tabelle 1. YAML File Structure
globalVariables Definiert globale Variablen, die in der gesamten YAML-Datei verwendet werden können.
defaultLabels Legt Standardbeschriftungen fest, die auf alle Metriken angewendet werden.
metricObjects Definiert die Metriken, die an Prometheus übermittelt werden sollen, einschließlich ihrer Typen und spezifischen Bezeichnungen.
metricData Gibt die zu erfassenden Datenpunkte zusammen mit den anzuwendenden Verarbeitungsfunktionen an.

Überblick

Standard-Labels sind eine Reihe von Schlüssel-Wert-Paaren, die automatisch an jede Metrik im Prometheus-Client angehängt werden. Sie bieten eine bequeme Möglichkeit, gemeinsame Informationen für alle Metriken zu erfassen.

Konfiguration

  • Definiert unter `defaultLabels` in der YAML-Datei.
  • Wird global auf alle Metriken angewandt, um eine einheitliche Kennzeichnung zu gewährleisten.

Zweck

  • Sicherstellen, dass jede Metrik wichtige Informationen wie Umgebungsdetails, Versionsnummern oder Systemidentifikatoren enthält.
  • Vereinfacht die Abfrage und Aggregation von Metriken in Prometheus durch gemeinsame Bezeichnungen.

Beispiel

In diesem Beispiel enthält jede vom Prometheus-Client gemeldete Metrik die Bezeichnungen `environment` (Umgebung) und `appVersion` (Anwendungsversion).

```
defaultLabels:
  environment: "production"
  appVersion: "1.0.0"
```
Anmerkung: In der Prometheus-Client-Konfiguration können Standard-Labels dynamisch den Echtzeit-Zustand des WinCC OA widerspiegeln. Diese Funktionalität wird durch YAML-Befehle oder die Notation "${}" ermöglicht, welche die Integration von WinCC OA-Funktionen direkt in Label-Definitionen erlaubt.