Beobachtbarkeit in Cloud Tasks

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

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

  • Senden Sie Daten- und Systemprüfprotokolle 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 Anhand der erfassten Messwerte können Sie den Zustand und die Leistung im Blick behalten, Trends und Probleme erkennen und bei Verhaltensänderungen benachrichtigt werden.

Audit-Logs an Cloud Logging senden

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

Audit-Logs für den 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-Warteschlangen verwenden. Folgende Vorgänge werden protokolliert:

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

Logging aktivieren

Sie können die Protokollierung ü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 Protokolle.

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

    Screenshot

gcloud

Sie können das Logging entweder mit dem Befehl gcloud tasks queues create oder gcloud tasks queues update 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. Wenn Sie einen Wert zwischen 1.0 und 0.0 festlegen, wird dieser Anteil der Vorgänge protokolliert. Wenn alle Vorgänge protokolliert werden sollen, legen Sie 1.0 fest. Wenn keine Vorgänge protokolliert werden sollen, legen Sie den Wert auf 0.0 fest (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 Protokolle.

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

    Screenshot

gcloud

Verwenden Sie den Befehl gcloud tasks queues update, um das Logging zu deaktivieren, 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 aufrufen

Sie können die folgenden Tools verwenden, um Ihre Protokolle aufzurufen und zu analysieren:

  • Der Log-Explorer soll Ihnen bei der Fehlerbehebung und Leistungsanalyse Ihrer Dienste und Anwendungen helfen. Informationen zum Aufrufen von Logs im Log-Explorer finden Sie unter Logs mit dem Log-Explorer ansehen.
  • Log Analytics ist für die Ausführung von Abfragen zur Analyse von Protokollen und die anschließende Anzeige oder Darstellung der Ergebnisse konzipiert. Eine Anleitung zur Verwendung von Log Analytics finden Sie unter Logs mit Log 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 Protokollen 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 im Monitoring stellt eine logische oder physische Entität dar, z. B. eine virtuelle Maschine, eine Datenbank oder eine Anwendung. Überwachte Ressourcen enthalten eine Reihe von Messwerten, die untersucht, in einem Dashboard erfasst 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 (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: Canonical response code as string (e.g. 'ok').
queue/depth GA  (project)
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  (project)
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: Canonical response code as string (e.g. 'ok').
queue/task_attempt_delays GA  (project)
Verzögerungen bei Taskausführungen
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 24.01.2025 um 16:56:52 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. Dazu gehören die Verwendung einer sprachspezifischen Clientbibliothek oder das Erstellen eines Diagramms mit dem Metrics Explorer. Eine Einführung in Messwerte und Zeitachsen finden Sie unter Messwerte, Zeitachsen und Ressourcen. Informationen zum Lesen von 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.