Fehlerbehebung

Diese Seite enthält Informationen zur Fehlerbehebung für Trace.

Keine Daten auf der Trace-Oberfläche

Wenn Sie in Ihrem Google Cloud-Projekt keine Traces aufrufen können, obwohl Trace-Daten vorhanden sind, führen Sie die folgenden Schritte aus:

  1. Klicken Sie in der Google Cloud Console in der Symbolleiste auf das Navigationsmenü und wählen Sie APIs und Dienste aus.

  2. Prüfen Sie im Dashboard, in dem alle APIs aufgelistet sind, ob die Cloud Trace API aufgeführt ist. Wenn in der Tabelle die Cloud Trace API aufgeführt ist, ist die API aktiviert. Bitte fahren Sie mit dem nächsten nummerierten Schritt fort.

    Wenn die Cloud Trace API nicht aufgeführt ist, ist die API nicht aktiviert. Klicken Sie zum Aktivieren der Cloud Trace API auf APIs und Dienste aktivieren und suchen Sie nach Trace API. Wenn Sie einen Eintrag für die Cloud Trace API sehen, wählen Sie ihn aus. Andernfalls wählen Sie Stackdriver Trace API aus. Nachdem Sie die API ausgewählt haben, klicken Sie auf Aktivieren.

  3. Wenn im Dashboard, in dem alle APIs aufgeführt sind, die Zeile für die Cloud Trace API keine numerischen Werte für die Spalte Anfragen, Fehler oder für andere Spalten enthält, die angeben, dass keine Trace-Anfragen Ihr Google Cloud-Projekt erreichen. Prüfen Sie Ihre Anwendungen und Proxys, um zu gewährleisten, dass sie aufgrund ihrer Konfiguration Traces an das richtige Projekt senden.

  4. Klicken Sie auf Cloud Trace API und dann auf Messwerte, um Details zur API-Nutzung abzurufen.

    Grenzen Sie die Fehlerquelle mithilfe der Filter Anmeldedaten und Methoden ein und sehen Sie sich die Auswirkungen an, die Ihre Auswahl auf das Diagramm Fehler nach API-Methode hat:

    • Wenn alle Schreibvorgänge fehlschlagen, prüfen Sie, ob Ihr Dienstkonto Zugriff auf die Cloud Trace-Agent-Rolle hat. Diese Rolle enthält die Berechtigung cloudtrace.traces.patch. Weitere Informationen finden Sie unter Cloud Trace-IAM-Rollen.

    • Wenn Lesevorgänge fehlschlagen, gewährleisten Sie, dass Sie Zugriff auf die Rolle Cloud Trace-Nutzer für dieses Google Cloud-Projekt haben. Eine vollständige Liste der Berechtigungen für diese Rolle finden Sie unter IAM-Rollen für Cloud Trace.

Upload von Spans für den Go OpenCensus-Exporter schlägt fehl

Im Folgenden sind Beispiele für Fehler aufgeführt, die auftreten, wenn die vom Exporter verwendete Bundler-Bibliothek die Anzahl der Spans, die die Anwendung generiert und hochlädt, nicht verwalten kann:

OpenCensus Stackdriver exporter: failed to upload span: buffer full
OpenCensus Stackdriver exporter: failed to upload 183 spans: buffer full

Sie können dieses Problem mit einem oder mehreren der folgenden Schritte beheben:

  • Erhöhen Sie in der Struktur Options an den Konstruktor traceExporter den Wert des Felds TraceSpansBufferMaxBytes. Dieses optionale Feld gibt die maximale Anzahl von Byte an, die für die Zwischenspeicherung verwendet werden. Der Standardwert ist 8 MB.

  • Verringern Sie im Objekt Options, das an den Konstruktor traceExporter übergeben wurde, die Werte für die folgenden Felder:

    • BundleDelayThreshold: Dieses optionale Feld gibt an, wie lange der Exporter lange warten kann, bevor Trace-Spans hochgeladen werden. Der Standardwert dieses Felds beträgt zwei Sekunden.

    • BundleCountThreshold: Dieses optionale Feld gibt die Anzahl der Spans an, die zwischengespeichert werden können. Der Standardwert dieses Felds ist 50.

  • Weniger Spans exportieren. Um die Anzahl der exportierten Spans zu reduzieren, konfigurieren Sie einen globalen Sampler oder übergeben einen Sampler an jeden StartSpan. Beispielcode und weitere Informationen zu diesen Konfigurationen finden Sie unter OpenCensus Sampling.