Beobachtbarkeit in Cloud Tasks

Google Cloud Observability bietet Monitoring-, Logging- und Diagnosetools. Mit diesen Tools können Sie Cloud Tasks-Aktivitäten und ‑Wachstum beobachten und analysieren sowie das Verhalten, den Zustand und die Leistung Ihrer Anwendungen nachvollziehen.

Standardmäßig ist Cloud Tasks für Folgendes konfiguriert:

• Daten und System-Audit-Logs an Cloud Logging senden 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 Sie können die erfassten Messwerte verwenden, um Zustand und Leistung zu beobachten, Trends und Probleme zu erkennen und sich über Verhaltensänderungen benachrichtigen zu lassen.

Audit-Logs an Cloud Logging senden

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

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

Audit-Logs zum Datenzugriff sind standardmäßig deaktiviert, da diese Audit-Logs sehr groß sein können.

Weitere Informationen finden Sie unter Cloud Tasks-Audit-Logging.

Cloud Logging mit Warteschlangen verwenden

Sie können Cloud Logging mit Cloud Tasks-Warteschlangen verwenden. Die folgenden Vorgänge werden protokolliert:

• Task-Vorgänge:
  • CreateTask
  • DeleteTask
• Attempt-Vorgänge:
  • AttemptDispatch
  • AttemptResponse

Logging aktivieren

Sie können das Logging über die Google Cloud Console oder die Google Cloud CLI aktivieren.

Console

1. Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

   Zu den Warteschlangen

2. Klicken Sie auf den Namen der Warteschlange, für die Sie das Logging aktivieren möchten.

3. Klicken Sie auf der Seite Warteschlangendetails auf den Tab Logs.

4. Klicken Sie auf Logs aktivieren und zur Bestätigung auf Aktivieren.

   

gcloud

Verwenden Sie den gcloud tasks queues create oder den gcloud tasks queues update Befehl, um das Logging zu aktivieren.

gcloud tasks queues create QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATION

oder

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATIO

Ersetzen Sie Folgendes:

• QUEUE_ID: die ID Ihrer Warteschlange
• LOG_SAMPLING_RATIO: der Anteil der protokollierten Vorgänge. Mit einem Wert zwischen 1.0 und 0.0 wird dieser Anteil der Vorgänge protokolliert. Setzen Sie den Wert auf 1.0, um alle Vorgänge zu protokollieren. Setzen Sie den Wert auf 0.0, um keine Vorgänge zu protokollieren (Standard).

Logging deaktivieren

Sie können das Logging über die Google Cloud Console oder die Google Cloud CLI deaktivieren.

Console

1. Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

   Zu den Warteschlangen

2. Klicken Sie auf den Namen der Warteschlange, für die Sie das Logging deaktivieren möchten.

3. Klicken Sie auf der Seite Warteschlangendetails auf den Tab Logs.

4. Klicken Sie auf das Dreipunkt-Menü > Logs deaktivieren. Klicken Sie zur Bestätigung auf Deaktivieren.

   

gcloud

Verwenden Sie den gcloud tasks queues update Befehl und setzen Sie das log-sampling-ratio Flag auf 0.0, um das Logging zu deaktivieren.

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=0.0

Ersetzen Sie QUEUE_ID durch die ID Ihrer Warteschlange.

Logs abfragen und ansehen

Mit den folgenden Tools können Sie Ihre Logs ansehen und analysieren:

• Der Log-Explorer soll Ihnen bei der Fehlerbehebung und Leistungsanalyse Ihrer Dienste und Anwendungen helfen. Eine Anleitung zum Ansehen von Logs im Log-Explorer finden Sie unter Logs mit dem Log-Explorer ansehen.
• Mit Observability Analytics können Sie Abfragen ausführen, um Ihre Logs zu analysieren und die Ergebnisse dann anzusehen oder in einem Diagramm darzustellen. Eine Anleitung zur Verwendung von Observability Analytics finden Sie unter Logs mit Observability Analytics abfragen und analysieren.

Sie können im Log-Explorer nach Cloud Tasks-Logs filtern, indem Sie im Suchfeld nach cloudtasks suchen.

Weitere Informationen zum Abfragen und Analysieren von Logs finden Sie unter Logs abfragen und ansehen.

Messwerte an Cloud Monitoring senden

Cloud Tasks 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 eine eindeutige Reihe von Messwerten, die untersucht, über ein Dashboard gemeldet oder zum Erstellen von Benachrichtigungen verwendet werden können.

Cloud Tasks sendet Messwertdaten von der folgenden überwachten Ressource an Google Cloud Observability:

• cloud_tasks_queues

Jede Ressource hat auch 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. Sie sind in der folgenden Tabelle aufgeführt.

Ressourcenmesswerte und ‑labels

Den Strings vom Typ "metric type" in dieser Tabelle muss vorangestellt werden mit cloudtasks.googleapis.com/. Dieses Präfix wurde in den Einträgen der Tabelle weggelassen. Verwenden Sie beim Abfragen eines Labels das Präfix metric.labels.. Beispiel: metric.labels.LABEL="VALUE".

Messwerttyp ^Startphase (Hierarchieebenen der Ressource) Anzeigename
Art, Typ, Einheit Überwachte Ressourcen	Beschreibung Labels
api/request_count ^GA  (Projekt) API-Anfragen
DELTA, INT64, 1 cloud_tasks_queue	Anzahl der Cloud Tasks API-Aufrufe Alle 60 Sekunden wird eine Stichprobe erstellt. Nach der Stichprobe werden bis zu 240 Sekunden lang keine Daten angezeigt. api_method: Die aufgerufene API-Methode (z.B. CreateTask). response_code: Kanonischer Antwortcode als String (z.B. „ok“).
queue/depth ^GA  (Projekt) Warteschlangentiefe
GAUGE, INT64, 1 cloud_tasks_queue	Anzahl der Aufgaben in der Warteschlange. Alle 60 Sekunden wird eine Stichprobe erstellt. Nach der Stichprobe werden bis zu 120 Sekunden lang keine Daten angezeigt.
queue/task_attempt_count ^GA  (Projekt) Anzahl der Aufgabenversuche
DELTA, INT64, 1 cloud_tasks_queue	Anzahl der Aufgabenversuche aufgeschlüsselt nach Antwortcode. Alle 60 Sekunden wird eine Stichprobe erstellt. Nach der Stichprobe werden bis zu 180 Sekunden lang keine Daten angezeigt. response_code: Kanonischer Antwortcode als String (z.B. „ok“).
queue/task_attempt_delays ^GA  (Projekt) Verzögerungen bei Aufgabenversuchen
DELTA, DISTRIBUTION, ms cloud_tasks_queue	Verzögerung zwischen dem Zeitpunkt des geplanten Versuchs und des tatsächlichen Versuchs. Alle 60 Sekunden wird eine Stichprobe erstellt. Nach der Stichprobe werden bis zu 120 Sekunden lang keine Daten angezeigt.

Die Tabelle wurde am 20.03.2026 um 22:10:00 Uhr (UTC) erstellt.

Eine Liste aller Ressourcentypen finden Sie unter Überwachte Ressourcentypen. Eine Liste aller Messwerttypen finden Sie unter Google Cloud Messwerte.

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. mit einer sprachspezifischen Clientbibliothek oder durch Erstellen eines Diagramms mit dem Metrics Explorer. Eine Einführung zu Messwerten und Zeitachsen finden Sie unter Messwerte, Zeitachsen und Ressourcen. Informationen zum Lesen Ihrer Messwertdaten finden Sie unter Zeitachsendaten abrufen.

Monitoring-Dashboards und -Benachrichtigungen verwenden

Sie können Monitoring-Dashboards und die zugehörigen Diagramme verwenden, um die Daten für Cloud Tasks-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.