Workflows überwachen

Google Cloud Observability bietet Monitoring-, Logging- und Diagnosetools. Mit diesen Tools können Sie Workflow-Bereitstellungen und -Ausführungen überwachen und analysieren sowie das Verhalten, den Zustand und die Leistung Ihrer Anwendungen besser nachvollziehen.

Standardmäßig ist Workflows so konfiguriert, dass Folgendes ausgeführt wird:

  • Daten- und Systemauditlogs an Cloud Logging senden. Sie können die erfassten Protokolle verwenden, um Fehler in Ihren Anwendungen zu beheben, sie zu debuggen und Einblicke über sie zu erhalten.
  • System- und Ressourcenmesswerte an Cloud Monitoring senden. Anhand der erfassten Messwerte können Sie den Zustand und die Leistung überwachen, Trends und Probleme erkennen und sich über Verhaltensänderungen benachrichtigen lassen.

Audit-Logs an Cloud Logging senden

Workflows sendet die folgenden Arten von Audit-Logdaten an Cloud Logging:

Da Audit-Logs für den Datenzugriff relativ groß sein können, sind sie standardmäßig deaktiviert. Weitere Informationen finden Sie unter Audit-Logs zum Datenzugriff aktivieren.

Weitere Informationen zu Audit-Logs in Workflows finden Sie hier:

Sie können auch Ausführungslogs an Cloud Logging senden.

Messwerte an Cloud Monitoring senden

Workflows sendet Messwertdaten von überwachten Ressourcen an Google Cloud Observability. Eine überwachte Ressource in Monitoring stellt eine logische oder physische Entität dar, z. B. eine virtuelle Maschine, eine Datenbank oder eine Anwendung. Überwachte Ressourcen enthalten einen eindeutigen Satz von Messwerten, die untersucht, über ein Dashboard gemeldet oder zum Erstellen von Benachrichtigungen verwendet werden können. Jede Ressource hat außerdem eine Reihe von Ressourcenlabels. Das sind Schlüssel/Wert-Paare, die zusätzliche Informationen zur Ressource enthalten. Ressourcenlabels sind für alle Messwerte verfügbar, die mit der Ressource verknüpft sind.

Eine Liste aller Ressourcentypen finden Sie unter Überwachte Ressourcentypen. Eine vollständige Liste der Messwerttypen finden Sie unter Google Cloud -Messwerte. Maximieren Sie den folgenden Bereich, um eine Liste der Messwerttypen zu sehen, die von Workflows an Google Cloud Observability gesendet werden:

Messwerttypen für Workflows

Messwertdaten lesen

Sie können Messwertdaten, auch Zeitachsendaten genannt, mit der Methode timeSeries.list in der Cloud Monitoring API lesen. Es gibt mehrere Möglichkeiten, die Methode aufzurufen, z. B. mit einer sprachspezifischen Clientbibliothek oder durch Erstellen eines Diagramms mit dem Metrics Explorer. Sie können die Methode timeSeries.list auch mit dem formularbasierten APIs Explorer ausprobieren. Eine Einführung in Messwerte und Zeitreihen finden Sie unter Messwerte, Zeitreihen und Ressourcen. Informationen zum Lesen Ihrer Messwertdaten finden Sie unter Zeitreihendaten abrufen.

Kontingentmesswerte überwachen

Im folgenden Beispiel wird gezeigt, wie Sie mit dem APIs Explorer das insgesamt verbrauchte Zuteilungskontingent für Workflows abfragen. Konkret wird der Messwert serviceruntime.googleapis.com/quota/allocation/usage für den Ressourcentyp Consumer Quota verwendet. Sie können weitere Labelfilter (service, quota_metric) festlegen, um den Kontingenttyp anzugeben. Weitere Informationen zum Monitoring von Kontingentmesswerten, einschließlich weiterer Beispiele und zum Erstellen von Benachrichtigungsrichtlinien, finden Sie unter Kontingentmesswerte grafisch darstellen und überwachen.

  1. Öffnen Sie die Referenzseite für timeSeries.list.

  2. Wenn der Bereich Diese Methode ausprobieren nicht sichtbar ist, klicken Sie auf Ausprobieren.

  3. Geben Sie im Feld name Ihre Google Cloud Projekt-ID im folgenden Format ein:

    projects/PROJECT_ID

  4. Geben Sie im Feld Filter einen einzelnen Messwerttyp und optional Messwertlabels und andere Informationen an. Beispiel:

    metric.type = "serviceruntime.googleapis.com/quota/allocation/usage" AND resource.labels.service = "workflowexecutions.googleapis.com"

  5. Geben Sie im Feld interval.endTime eine Endzeit ein, um die Menge der zurückgegebenen Daten zu begrenzen, die für Ihre Nutzung relevant sind. Sie sollte als RFC 3339-String formatiert sein, z. B. 2024-11-07T03:01:02Z.

  6. Geben Sie im Feld interval.startTime eine Startzeit ein, um die Menge der zurückgegebenen Daten zu begrenzen, die für Ihre Nutzung relevant sind. Er sollte als RFC 3339-String formatiert sein, z. B. 2024-11-07T03:01:00Z.

  7. Klicken Sie auf Ausführen.

    Das Ergebnis sollte in etwa so aussehen, wobei 350 das Kontingentmesswert Gleichzeitige Ausführungen angibt.

    {
"timeSeries": [
   {
      "metric": {
      "labels": {
         "quota_metric": "workflowexecutions.googleapis.com/concurrency"
      },
      "type": "serviceruntime.googleapis.com/quota/allocation/usage"
      },
      "resource": {
      "type": "consumer_quota",
      "labels": {
         "service": "workflowexecutions.googleapis.com",
         "project_id": "PROJECT_ID",
         "location": "europe-west1"
      }
      },
      "metricKind": "GAUGE",
      "valueType": "INT64",
      "points": [
      {
         "interval": {
            "startTime": "2024-11-07T03:01:02Z",
            "endTime": "2024-11-07T03:01:02Z"
         },
         "value": {
            "int64Value": "350"
         }
      }
      ]
   }

  8. In der minimierten Seitenleiste des APIs Explorer können Sie auf „Vollbild“ klicken, um den APIs Explorer zu maximieren. Im Vollbildmodus wird ein zusätzlicher Bereich mit Codebeispielen, application/json-Antworten und HTTP-Rohantworten angezeigt. In diesem Fall können Sie sich beispielsweise den vergleichbaren curl-Befehl ansehen:

    curl \
'https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries?filter=metric.type%20%3D%20%22serviceruntime.googleapis.com%2Fquota%2Fallocation%2Fusage%22%20AND%20resource.labels.service%20%3D%20%22workflowexecutions.googleapis.com%22&interval.endTime=2024-11-07T03%3A01%3A02Z&interval.startTime=2024-11-07T03%3A01%3A00Z&key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

Monitoring-Dashboards und -Benachrichtigungen verwenden

Sie können Monitoring-Dashboards und die zugehörigen Diagramme verwenden, um die Daten für Workflows-Messwerte zu visualisieren.

Zum Überwachen dieser Messwerte in Monitoring können Sie benutzerdefinierte Dashboards erstellen. Sie können auch Warnungen basierend auf diesen Metriken hinzufügen.

Nächste Schritte