Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Messwerte aus Ihren Arbeitslasten erfassen

Auf dieser Seite wird beschrieben, wie Sie Messwerte aus Arbeitslasten in GDC-Umgebungen (Google Distributed Cloud) mit Air Gap extrahieren, um das Monitoring und die Datenbeobachtbarkeit zu erleichtern.

Sie können Messwerte, die Ihre Komponenten im Laufe der Zeit erzeugen, extrahieren und erfassen. Die Monitoring-Plattform bietet eine benutzerdefinierte API, mit der Messwerte aus laufenden Arbeitslasten in Ihrem Distributed Cloud-Projektnamespace extrahiert werden können. Zum Erfassen von Messwerten stellen Sie eine benutzerdefinierte MonitoringTarget-Ressource im Projekt-Namespace auf dem Management API-Server bereit. Nach der Bereitstellung dieser Ressource initiiert die Monitoring-Plattform die Datenerhebung.

Die benutzerdefinierte Ressource MonitoringTarget weist die Monitoring-Pipeline an, bestimmte Pods in Ihrem Projekt zu erfassen. Diese Pods müssen einen HTTP-Endpunkt bereitstellen, der Messwerte in einem Prometheus-Expositionsformat wie OpenMetrics liefert. Die extrahierten Messwerte werden dann in der Grafana-Instanz Ihres Projekts angezeigt und bieten Einblicke in den Betriebszustand Ihrer Anwendung.

Zum Konfigurieren der benutzerdefinierten Ressource MonitoringTarget müssen Sie die Pods in Ihrem Projekt-Namespace für die Messwerterfassung angeben. Sie können verschiedene Einstellungen anpassen, darunter die Scraping-Häufigkeit, den Messwertendpunkt der Pods, Labels und Annotationen.

Hinweis

Wenn Sie benutzerdefinierte MonitoringRule-Ressourcen verwalten möchten, fordern Sie die erforderlichen Berechtigungen von Ihrem Administrator an.

Erforderliche IAM-Rollen

Wenden Sie sich an Ihren IAM-Projektadministrator, um die folgenden Rollen anzufordern:

MonitoringRule Creator (monitoringrule-creator): Erstellt benutzerdefinierte MonitoringRule-Ressourcen im Projekt-Namespace.
MonitoringRule Editor (monitoringrule-editor): Bearbeiten oder ändern Sie benutzerdefinierte MonitoringRule-Ressourcen im Projekt-Namespace.
MonitoringRule Viewer (monitoringrule-viewer): Zum Aufrufen von benutzerdefinierten MonitoringRule-Ressourcen im Projekt-Namespace.

Benutzerdefinierte `MonitoringTarget`-Ressource konfigurieren

Die benutzerdefinierte Ressource MonitoringTarget gibt der Monitoring-Plattform an, woher Messwerte erfasst werden sollen. Sie können die Pods, für die Sie Messwerte erfassen, den Messwertendpunkt dieser Pods, die Scraping-Häufigkeit und alle zusätzlichen Einstellungen angeben.

Diese Ressource definiert die folgenden Konfigurationen:

Ziele: Die Pods und ihre Endpunkte in Ihrem Projekt, die Messwerte bereitstellen.
Scraping-Intervall: Wie oft Messwerte von den ausgewählten Endpunkten abgerufen werden sollen.
Labelanpassungen: Optionale Regeln mit Labeländerungen für Messwerte.

Wählen Sie eine der folgenden Methoden aus, um Messwertendpunkte in der benutzerdefinierten Ressource MonitoringTarget anzugeben:

Statische Endpunkte: Sie deklarieren den Endpunkt (Port, Pfad, Schema) explizit in der MonitoringTarget-Konfiguration.
Annotationen: Die Informationen zum Pod-Messwertendpunkt werden aus Annotationen in der Deployment-Datei des Containers abgerufen. Diese Methode bietet mehr Flexibilität, wenn jeder Pod unterschiedliche Endpunkte hat.

Statische Endpunkte

So machen Sie Messwerte aus den ausgewählten Pods auf einem statisch definierten Endpunkt verfügbar:

Bestimmen Sie das Distributed Cloud-Projekt, aus dem Sie Messwerte für das Monitoring erfassen möchten.
Geben Sie in der Spezifikation Ihres Pods den Port an, der Messwerte im Feld containerPort bereitstellt. Im folgenden Beispiel wird gezeigt, wie der Port 2112 in der Pod-Spezifikation deklariert wird:
```
# ...
spec:
  template:
    spec:
      containers:
      - name: your-container-name
        ports:
        - containerPort: 2112
# ...
```

Geben Sie in der MonitoringTarget-Konfiguration die Endpunktdetails (Port, Pfad, Schema) im Abschnitt podMetricsEndpoints an, damit sie mit dem Port übereinstimmen, den Sie in der Pod-Spezifikation freigegeben haben.

Die folgende YAML-Datei zeigt ein Beispiel für eine MonitoringTarget-Konfiguration, bei der jeder ausgewählte Pod Messwerte auf demselben Endpunkt (http://your-container-name:2112/metrics) bereitstellen muss:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: your-project-namespace
  name: your-container-name
spec:
  selector:
      # Choose pod labels to consider for this job.
      # Optional: Map of key-value pairs.
      # Default: No filtering by label.
      # To consider every pod in the project namespace, remove selector fields.
    matchLabels:
      app: your-app-label
  podMetricsEndpoints:
    port:
      value: 2112
    path:
      # Choose any value for your endpoint.
      # The /metrics value is an example.
      value: /metrics
    scheme:
      value: http

Wenden Sie die MonitoringTarget-Konfiguration auf den Management API-Server im selben Namespace wie Ihre Ziel-Pods an:
```
kubectl --kubeconfig KUBECONFIG_PATH apply -f MONITORING_TARGET_NAME.yaml
```
Ersetzen Sie Folgendes:
- KUBECONFIG_PATH: der Pfad zur kubeconfig-Datei für den Management API-Server.
- MONITORING_TARGET_NAME: der Name der MonitoringTarget-Definitionsdatei.

Die Monitoring-Plattform beginnt mit der Erfassung von Messwerten.

Annotationen

So stellen Sie Messwerte mithilfe von Annotationen bereit, wenn jeder Pod unterschiedliche Endpunkte hat:

Bestimmen Sie das Distributed Cloud-Projekt, aus dem Sie Messwerte für das Monitoring erfassen möchten.

Fügen Sie dem Abschnitt annotations der Deployment-Datei Ihres Containers die folgenden Annotationen hinzu:

prometheus.io/path
prometheus.io/port
prometheus.io/scheme

Das folgende Beispiel zeigt Annotationen für Messwerte auf Port 2112:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: your-container-name
  namespace: your-project-namespace
  labels:
    app: your-app-label
  annotations:
    # These annotations are not required. They demonstrate selecting
    # pod metric endpoints through annotations.
    prometheus.io/path: /metrics
    prometheus.io/port: \"2112\"
    prometheus.io/scheme: http

Geben Sie in Ihrer MonitoringTarget-Konfiguration die Annotationen an, die Sie der Deployment-Datei des Containers im Abschnitt podMetricsEndpoints hinzugefügt haben. Diese Spezifikation weist die benutzerdefinierte Ressource an, die Informationen zum Messwertendpunkt aus Annotationen auf den ausgewählten Pods zu erfassen.

Die folgende YAML-Datei zeigt ein Beispiel für eine MonitoringTarget-Konfiguration mit Annotationen:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
metadata:
  # Choose the same namespace as the workload pods.
  namespace: your-project-namespace
  name: your-container-name
spec:
  selector:
    matchLabels:
      app: your-app-label
  podMetricsEndpoints:
    port:
      annotation: prometheus.io/port
    path:
      annotation: prometheus.io/path
    scheme:
      annotation: prometheus.io/scheme

Wenden Sie die MonitoringTarget-Konfiguration auf den Management API-Server im selben Namespace wie Ihre Ziel-Pods an:
```
kubectl --kubeconfig KUBECONFIG_PATH apply -f MONITORING_TARGET_NAME.yaml
```
Ersetzen Sie Folgendes:
- KUBECONFIG_PATH: der Pfad zur kubeconfig-Datei für den Management API-Server.
- MONITORING_TARGET_NAME: der Name der MonitoringTarget-Definitionsdatei.

Die Monitoring-Plattform beginnt mit der Erfassung von Messwerten.

Weitere Felder und Optionen finden Sie in der vollständigen MonitoringTarget-Spezifikation und in der API-Referenzdokumentation.

Spezifikation für „`MonitoringTarget`“ vervollständigen

Die folgende YAML-Datei zeigt ein Beispiel für die vollständige Spezifikation der benutzerdefinierten Ressource MonitoringTarget. Weitere Informationen und eine vollständige Beschreibung der Felder finden Sie in der API-Referenzdokumentation.

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  # Choose matching pattern that identifies pods for this job.
  # Optional
  # Relationship between different selectors: AND
  selector:
    # Choose clusters to consider for this job.
    # Optional: List
    # Default: All clusters applicable to this project.
    # Relationship between different list elements: OR
    matchClusters:
    - string

    # Choose pod labels to consider for this job.
    # Optional: Map of key-value pairs.
    # Default: No filtering by label.
    # Relationship between different pairs: AND
    matchLabels:
      key1: value1

    # Choose annotations to consider for this job.
    # Optional: Map of key-value pairs
    # Default: No filtering by annotation
    # Relationship between different pairs: AND
    matchAnnotations:
      key1: value1

  # Configure the endpoint exposed for this job.
  podMetricsEndpoints:
    # Choose a port either through static value or annotation.
    # Optional
    # Annotation takes priority.
    # Default: static port 80
    port:
      value: integer
      annotation: string

    # Choose a path either through static value or annotation.
    # Optional
    # Annotation takes priority
    # Default: static path /metrics
    path:
      value: string
      annotation: string

    # Choose a scheme either through a static value (http or https) or annotation.
    # Optional
    # Annotation takes priority
    # Default: static scheme http
    scheme:
      value: string
      annotation: string

    # Choose the frequency to scrape the metrics endpoint defined in podMetricsEndpoints
    # Optional
    # Default: 60s
    scrapeInterval: string

    # Dynamically rewrite the label set of a target before it gets scraped.
    # https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
    # Optional
    # Default: No filtering by label
    metricsRelabelings:
    - sourceLabels:
      - string
      separator: string
      regex: string
      action: string
      targetLabel: string
      replacement: string

Ersetzen Sie Folgendes:

PROJECT_NAMESPACE: Ihr Projekt-Namespace.
MONITORING_TARGET_NAME: der Name der MonitoringTarget-Definitionsdatei.

Messwerte aus Ihren Arbeitslasten erfassen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.