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

Messwerte aus Ihren Arbeitslasten erfassen

Mit der Google Distributed Cloud (GDC) mit Air Gap können Sie Messwerte aus Ihren Arbeitslasten im Laufe der Zeit erfassen und sammeln, um die Anwendungsleistung zu überwachen und die Datenbeobachtbarkeit aufrechtzuerhalten. Um die Messwerterfassung zu starten, stellen Sie eine benutzerdefinierte MonitoringTarget-Ressource im Projekt-Namespace auf dem Management API-Server bereit.

Die benutzerdefinierte Ressource MonitoringTarget weist die Monitoring-Pipeline an, bestimmte Pods zu scrapen, die einen HTTP-Endpunkt in einem Prometheus-Expositionsformat wie OpenMetrics bereitstellen. Sie können die Scraping-Häufigkeit, die Endpunkteinstellungen, die Labels und die Annotationen für Ihre Ziel-Pods anpassen. Die Grafana-Instanz Ihres Projekts zeigt die erfassten Messwerte an, damit Sie den Betriebszustand Ihrer Anwendung analysieren können.

Hinweis

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

Erforderliche IAM-Rollen

Wenden Sie sich an den IAM-Administrator Ihres Projekts, um die folgenden Rollen anzufordern:

MonitoringTarget Creator (monitoringtarget-creator): Erstellt benutzerdefinierte MonitoringTarget-Ressourcen im Projekt-Namespace.
MonitoringTarget-Bearbeiter (monitoringtarget-editor): Bearbeiten oder Löschen von benutzerdefinierten MonitoringTarget-Ressourcen im Projekt-Namespace.
MonitoringTarget Viewer (monitoringtarget-viewer): Benutzerdefinierte MonitoringTarget-Ressourcen im Projekt-Namespace ansehen.

Benutzerdefinierte `MonitoringTarget`-Ressource konfigurieren

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

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 stellen Sie Messwerte aus den ausgewählten Pods auf einem statisch definierten Endpunkt bereit:

Bestimmen Sie das GDC-Projekt mit Air Gap, 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 angegeben 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 GDC-Projekt mit Air Gap, 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.