Beobachtbarkeit in Cloud Tasks

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

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

  • 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

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

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

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 Warteschlangen

  2. Klicken Sie auf den Namen der Warteschlange, für die Sie die Protokollierung 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.

    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. Wenn Sie einen Wert zwischen 1.0 und 0.0 festlegen, wird dieser Anteil der Vorgänge protokolliert. Wenn Sie alle Vorgänge protokollieren möchten, legen Sie den Wert auf 1.0 fest. Wenn Sie keine Vorgänge protokollieren möchten, legen Sie den Wert auf 0.0 fest (das ist der Standardwert).

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 die Protokollierung 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.

    Screenshot

gcloud

Verwenden Sie den Befehl gcloud tasks queues update und setzen Sie das Flag log-sampling-ratio 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

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

  • Der Log-Explorer wurde entwickelt, um Ihnen bei der Fehlerbehebung und Analyse der Leistung Ihrer Dienste und Anwendungen zu helfen. Eine Anleitung zum Aufrufen von Logs im Log-Explorer finden Sie unter Logs mit dem Log-Explorer aufrufen.
  • Mit Log 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 Loganalysen finden Sie unter Logs mit Loganalysen 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 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.

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

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 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 (Ebenen der Ressourcenhierarchie)
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 		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 Task-Versuchen
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 23.07.2025 um 17:22:13 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 in Messwerte 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.