Beobachtbarkeit in Cloud Tasks

Mit Google Cloud Observability können Sie Cloud Tasks-Aktivitäten, das Warteschlangenwachstum und das Ausführungsverhalten überwachen und analysieren. Anhand der erfassten Messwerte und Logs können Sie den Zustand der Anwendung bewerten, Aufgabenfehler diagnostizieren und Leistungsprobleme beheben.

Standardmäßig sendet Cloud Tasks System- und Ressourcenmesswerte an Cloud Monitoring und exportiert Audit-Logs zu Administratoraktivitäten in Cloud Logging. Audit-Logs zum Datenzugriff sind standardmäßig deaktiviert und müssen explizit konfiguriert werden.

Audit-Logs an Cloud Logging senden

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

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

Weitere Informationen finden Sie unter Audit-Logging für Cloud Tasks.

Cloud Logging mit Warteschlangen verwenden

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

  • Aufgabenvorgänge:
    • CreateTask
    • DeleteTask
  • Vorgänge versuchen:
    • 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 „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 Protokolle aktivieren und dann zur Bestätigung auf Aktivieren.

    Screenshot

gcloud

Zum Aktivieren des Loggings können Sie entweder den Befehl gcloud tasks queues create oder gcloud tasks queues update verwenden.

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. Bei jedem Wert zwischen 1.0 und 0.0 wird dieser Bruchteil der Vorgänge protokolliert. Wenn Sie alle Vorgänge protokollieren möchten, legen Sie 1.0 fest. Wenn Sie keine Vorgänge protokollieren möchten, legen Sie den Wert auf 0.0 fest (dies ist die Standardeinstellung).

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 „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ü > Protokolle deaktivieren. Klicken Sie zur Bestätigung auf Deaktivieren.

    Screenshot

gcloud

Verwenden Sie zum Deaktivieren des Loggings den Befehl gcloud tasks queues update und setzen Sie das Flag log-sampling-ratio auf 0.0.

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

Ersetzen Sie QUEUE_ID durch die ID Ihrer Warteschlange.

Logs abfragen und ansehen

Sie können die folgenden Tools verwenden, um Ihre Logs anzusehen und zu analysieren:

  • Der Log-Explorer soll Ihnen bei der Fehlerbehebung und Analyse der Leistung Ihrer Dienste und Anwendungen helfen. Informationen zum Aufrufen von Logs im Log-Explorer finden Sie unter Logs mit dem Log-Explorer aufrufen.
  • Observability Analytics ist für das Ausführen von Abfragen zur Analyse Ihrer Logs und das anschließende Anzeigen oder Darstellen der Ergebnisse in einem Diagramm konzipiert. 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 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 einen eindeutigen Satz 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:

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 mit der Ressource verknüpften Messwerte verfügbar und werden in der folgenden Tabelle beschrieben.

Ressourcenmesswerte und -labels

Den Strings vom Typ "metric type" in dieser Tabelle muss cloudtasks.googleapis.com/ vorangestellt werden. 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 (Ressourcenhierarchieebenen)
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)
Größe der Warteschlange
GAUGE, INT64, 1
cloud_tasks_queue 		Die 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 Taskversuche
DELTA, INT64, 1
cloud_tasks_queue 		Anzahl der Taskversuche, 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 Taskversuchen
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Verzögerung zwischen der geplanten und der tatsächlichen Zeit des Versuchs. Alle 60 Sekunden wird eine Stichprobe erstellt. Nach der Stichprobe werden bis zu 120 Sekunden lang keine Daten angezeigt.

Die Tabelle wurde am 22.10.2026 um 02:44:18 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 mehrere Möglichkeiten, die Methode aufzurufen, z. B. mit einer sprachspezifischen Clientbibliothek oder durch Erstellen eines Diagramms mit Metrics Explorer. Eine Einführung in Messwerte und Zeitreihen finden Sie unter Messwerte, Zeitreihen und Ressourcen. Informationen zum Lesen Ihrer Messwertdaten finden Sie unter Zeitreihendaten 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 anzuzeigen.

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