Verteiltes Tracing verwenden

Alle eingehenden Anfragen an eine Cloud Functions-Funktion generieren automatisch einen grundlegenden Satz von Trace-Daten. Damit können Sie das Timing messen und Ursachen von Latenzen in Ihrer Funktion ermitteln.

Für ein detaillierteres Tracing können Sie Ihrer Cloud Functions-Funktion zusätzliche Instrumentierung hinzufügen. Dadurch können Sie die Zeit messen, die für die Ausführung verschiedener Untervorgänge innerhalb der Funktion durch die Anfrage benötigt wird, z. B. für Datenbankabfragen, API-Anfragen oder komplexe Geschäftslogik. Jede dieser ebenenspezifischen Zeitmessungen wird als Span bezeichnet.

Mit Cloud Trace können Sie eine Analyse Ihrer Traces anzeigen.

Trace Sampling-Rate

Cloud Functions führt Tracing mit einer Rate von maximal einer Anfrage pro zehn Sekunden für jede Cloud Functions-Instanz durch. Sie können auch das Tracing einer bestimmten Anfrage erzwingen.

Kosten

Für automatisch generierte Traces, ob Stichproben oder erzwungene, fallen keine Gebühren an. Wenn Sie jedoch Cloud Trace-Bibliotheken verwenden und eigene Spans hinzufügen, indem Sie sie mit von Cloud Functions bereitgestellten Spans korrelieren, werden Ihnen die Kosten von Cloud Trace in Rechnung gestellt.

Wann Instrumentierung hinzugefügt werden muss

Wenn Sie mehr Trace-Informationen als die automatisch generierten Trace-Daten benötigen, müssen Sie dem Dienst Instrumentierungscode hinzufügen, um zusätzliches Tracing zu aktivieren. Sie müssen beispielsweise Instrumentierung hinzufügen, um Folgendes zu tun:

  • Erstellen Sie benutzerdefinierte Trace-Spans. Sie können beispielsweise überwachen, wie lange Ihr Dienst benötigt, um Ergebnisse von API-Anfragen zurückzuerhalten.
  • Trace-Kontext weitergeben wollen, damit Cloud Trace den Anfragefluss über mehrere Dienste als einzelne Anfrage anzeigt.

Weitere Informationen zur Hinzufügung von Instrumentierung finden Sie unter Tracing für Anwendungen instrumentieren.

Traces ansehen

Informationen zum Aufrufen einer Analyse Ihrer Trace-Daten finden Sie unter Traces ansehen.