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 nachvollziehen.

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

• Senden Sie Daten und System-Audit-Logs an Cloud Logging. Sie können die erfassten Logs verwenden, um Fehler in Ihren Anwendungen zu beheben, sie zu debuggen und Informationen über sie zu erhalten.
• System- und Ressourcenmesswerte an Cloud Monitoring senden. Mithilfe der erfassten Messwerte können Sie den Zustand und die Leistung im Blick behalten, Trends und Probleme erkennen und Benachrichtigungen bei Verhaltensänderungen erhalten.

Audit-Logs an Cloud Logging senden

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

• Audit-Logs zur Administratoraktivität
• Audit-Logs zum Datenzugriff
• Audit-Logs zu Systemereignissen
• Audit-Logs zu Richtlinienverstößen

Da Audit-Logs zum 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 in den folgenden Artikeln:

• Audit-Logging für Workflows
• Audit-Logging für Workflow-Ausführungen

Sie können auch Ausführungsprotokolle 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 Einheit 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 auch eine Reihe von Ressourcenlabels, die Schlüssel/Wert-Paare sind und zusätzliche Informationen zur Ressource enthalten. Ressourcenlabels sind für alle Messwerte verfügbar, die der Ressource zugeordnet sind.

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

Messwertdaten lesen

Sie können Messwertdaten, auch Zeitachsendaten genannt, mit der Methode timeSeries.list in der Cloud Monitoring API lesen. Es gibt verschiedene Möglichkeiten, die Methode aufzurufen, z. B. über eine sprachspezifische Clientbibliothek oder indem Sie ein Diagramm mit dem Metrics Explorer erstellen. Sie können die timeSeries.list-Methode auch mit dem formularbasierten APIs Explorer ausprobieren. Eine Einführung in Messwerte und Zeitachsen finden Sie unter Messwerte, Zeitachsen und Ressourcen. Informationen zum Lesen Ihrer Messwertdaten finden Sie unter Zeitachsendaten abrufen.

Kontingentmesswerte überwachen

Im folgenden Beispiel wird gezeigt, wie Sie mit dem APIs Explorer das insgesamt verbrauchte Zuweisungskontingent für Workflows abfragen. Dazu wird der Messwert serviceruntime.googleapis.com/quota/allocation/usage für den Ressourcentyp Consumer Quota verwendet. Sie können zusätzliche 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 timeSeries.list Referenzseite.

2. Wenn der Bereich Diese Methode ausprobieren nicht angezeigt wird, klicken Sie auf Jetzt 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. Er 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. 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. 350 steht für das Kontingentmesswert gleichzeitige Ausführungen.

   {
   "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. Klicken Sie in der minimierten Seitenleiste des APIs Explorer auf „Vollbildmodus“ fullscreen, um den APIs Explorer zu maximieren. Im Vollbildbereich wird ein zusätzlicher Bereich mit Codebeispielen, application/json-Antworten und Roh-HTTP-Antworten 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

• Übersicht zum Debugging
• Bekannte Probleme bei Workflows
• Fehlerbehebung