Fehler beheben

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

Bekannte Probleme

In diesem Abschnitt werden bekannte Probleme aufgeführt:

  • Spans, die mit der Telemetry API in Ihr Google Cloud Projekt geschrieben wurden, sind für die Cloud Trace API nicht zugänglich. Wenn Sie beispielsweise versuchen, diese Traces aufzulisten, schlägt der Befehl mit dem Fehler 404 Not Found fehl.

Fehlerbehebung bei Loganalysen

In diesem Abschnitt wird beschrieben, wie Sie Fehler beheben, die bei der Verwendung von Loganalysen zum Abfragen Ihrer Tracedaten auftreten können.

Fehlermeldung, dass eine Ansicht nicht vorhanden ist

Sie geben eine SQL-Abfrage in den Abfragebereich der Seite Loganalysen ein, aber der SQL-Parser gibt den folgenden Fehler aus:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views/OBS_VIEW_ID does not exist

Der vorherige Fehler wird gemeldet, wenn die in der FROM-Anweisung angegebene Ansicht nicht gefunden werden kann.

So beheben Sie diesen Fehler: Prüfen Sie, ob die Syntax Ihrer Ansicht korrekt ist:

  • Prüfen Sie, ob der vollständig qualifizierte Name der Ansicht der Syntax entspricht, die für das Benennungsschema von Loganalysen erforderlich ist. Die erforderliche Syntax für eine Ansicht finden Sie, indem Sie die Standardabfrage anzeigen.

  • Wenn die Google Cloud Projekt-ID, der Speicherort, die Bucket-ID, die Dataset-ID oder die Ansichts-ID Punkte enthalten, (.), prüfen Sie, ob das Feld in einzelne Graviszeichen eingeschlossen ist, (`).

    Wenn die ID vonIhr Google Cloud Projekt beispielsweise example.com:bluebird, sieht die FROM Anweisung so aus:

    FROM `example.com:bluebird`.`us`.`_Trace`.`Spans`.`_AllSpans`

Meldung „Erste Schritte mit Loganalysen“ wird angezeigt

Sie öffnen die Seite Loganalysen und sehen ein Fenster mit einer Meldung wie der folgenden:

Get started with Log Analytics

Wenn Sie Loganalysen verwenden möchten, klicken Sie im Fenster auf Schließen.

Die vorherige Meldung wird angezeigt, wenn Sie keine Log-Buckets haben, für die ein Upgrade auf Loganalysen durchgeführt wurde. Ihre Tracedaten werden jedoch nicht in einem Log-Bucket gespeichert.

Join von mehreren Ansichten schlägt fehl

Sie schreiben eine Abfrage, die mehrere Ansichten verknüpft, aber die Abfrage wird als ungültig markiert.

Nicht alle Ansichten können verknüpft werden.

Für das Verknüpfen von Ansichten gelten die folgenden Einschränkungen:

  1. Die Speicherorte der Ansichten erfüllen eine der folgenden Bedingungen:

    • Alle Ansichten haben denselben Speicherort.
    • Alle Ansichten befinden sich entweder am Speicherort global oder us.

  2. Wenn Speicherrressourcen kundenverwaltete Verschlüsselungsschlüssel (Customer Managed Encryption Keys, CMEK) verwenden, eine der folgenden Bedingungen erfüllt sein:

    • Speicherressourcen, die CMEK verwenden, verwenden denselben Cloud KMS-Schlüssel.
    • Speicherressourcen, die CMEK verwenden, haben einen gemeinsamen Vorfahren, und dieser Vorfahre gibt einen Standard Cloud KMS-Schlüssel an, der sich am selben Speicherort wie die Speicherressourcen befindet.

    Wenn eine oder mehrere Speicherressourcen CMEK verwenden, verschlüsselt das System temporäre Daten, die durch den Join generiert werden, entweder mit dem gemeinsamen Cloud KMS-Schlüssel oder dem Standard-Cloud KMS-Schlüssel des Vorfahren.

Angenommen, Sie haben zwei Ansichten, die sich am selben Speicherort befinden. Sie können diese Ansichten verknüpfen, wenn eine der folgenden Bedingungen erfüllt ist:

  • Die Speicherressourcen verwenden keine CMEK.
  • Eine Speicherressource verwendet CMEK und die andere nicht.
  • Beide Speicherressourcen verwenden CMEK und denselben Cloud KMS-Schlüssel.

  • Beide Speicherressourcen verwenden CMEK, aber unterschiedliche Schlüssel. Die Ressourcen haben jedoch einen gemeinsamen Vorfahren, der einen Standard-Cloud KMS-Schlüssel angibt, der sich am selben Speicherort wie die Speicherressourcen befindet.

    Angenommen, die Ressourcenhierarchie für einen Log-Bucket und einen Bucket für Beobachtbarkeit umfasst dieselbe Organisation. Sie können Ansichten für diese Buckets verknüpfen, wenn Sie für diese Organisation, die Standardressourceneinstellungen für Cloud Logging und für Buckets für Beobachtbarkeit mit demselben Standard-Cloud KMS-Schlüssel für den Speicherort konfiguriert haben.

Keine Daten auf der Seite Trace Explorer

Sie haben eine Anwendung, die Tracedaten anIhr Google Cloud Projekt sendet. Wenn Sie jedoch die Seite Trace Explorer öffnen, werden keine Daten angezeigt.

Es gibt mehrere mögliche Gründe, warum Sie keine Tracedaten sehen können:

  • Sie haben nicht die Berechtigungen, die zum Aufrufen der Daten erforderlich sind.
  • Trace-Spans wurden nicht an Ihr Projekt gesendet.
  • Ihre Anwendung hat nicht die Berechtigungen, die zum Schreiben von Tracedaten erforderlich sind.
  • Ihre Trace-Spans werden nicht gespeichert.

In den folgenden Unterabschnitten finden Sie Informationen zur Fehlerbehebung bei den aufgeführten Fehlerszenarien.

Prüfen, ob Sie die Berechtigung zum Aufrufen von Tracedaten haben

Wenn Sie Tracedaten aufrufen möchten, müssen Sie die Rolle „Cloud Trace-Nutzer“ (roles/cloudtrace.user)haben.

Prüfen, ob Trace-Spans an Ihr Projekt gesendet werden

So prüfen Sie, ob Spans an Ihr Projekt gesendet werden:

  1. Aktivieren Sie die Cloud Trace API und die Telemetry API.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Informationen zum Zuweisen von Rollen.

    APIs aktivieren

    Beide APIs können Trace-Spans aufnehmen. Die Telemetry API wird jedoch empfohlen, da sie mit dem OpenTelemetry-Ökosystem kompatibel ist und großzügigere Limits als die Cloud Trace API hat.

  2. Rufen Sie die Seite Aktivierte APIs und Dienste auf und suchen Sie nach den Zeilen für die Cloud Trace API und die Telemetry API.

    Wenn die Anzahl der Anfragen für diese beiden APIs null ist, werden keine Tracedaten an Ihr Projekt gesendet.

Prüfen, ob Ihre Anwendung die erforderlichen Berechtigungen zum Schreiben von Trace-Spans hat

So prüfen Sie, ob Ihre Anwendung die Berechtigung zum Schreiben von Tracedaten in Ihr Projekt hat:

  1. Rufen Sie die Seite Aktivierte APIs und Dienste auf, suchen Sie nach den Zeilen für die Cloud Trace API und die Telemetry API und prüfen Sie die Spalte Fehler.

  2. Wenn in der Spalte Fehler für eine der beiden APIs ein Wert ungleich null angezeigt wird, treten Fehler beim Lesen oder Schreiben von Tracedaten über diese API auf. Um den Fehlertyp zu ermitteln, wählen Sie die API und dann den Messwerte Tab aus und sehen Sie sich Fehler nach API-Methode an:

    Wenn Schreibvorgänge fehlschlagen, weisen Sie dem Dienstkonto, das Anmeldedaten bereitstellt, die folgenden Rollen zu:

Prüfen, ob Ihre Tracedaten gespeichert sind

Trace-Spans werden in einem Bucket für Beobachtbarkeit mit dem Namen _Trace gespeichert. Dieser Bucket wird automatisch bereitgestellt, wenn Ihr Google Cloud Projekt Trace-Spans empfängt. Es gibt jedoch mehrere Szenarien, in denen die Bereitstellung fehlschlägt.

Um zu prüfen, ob ein Bucket für Beobachtbarkeit für Ihre Tracedaten vorhanden ist, können Sie entweder Ihre Buckets für Beobachtbarkeit auflisten oder Sie können die Seite Trace Explorer öffnen. Beispiel:

  1. Rufen Sie in der Google Cloud Console die Seite Trace Explorer auf:

    Zum Trace Explorer

    Sie können diese Seite auch über die Suchleiste finden.

  2. Wenn Sie ein Banner wie das folgende sehen, bedeutet das, dass der Speicher für Ihre Tracedaten nicht bereitgestellt wurde.

    Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

    Wenn Sie einen Bucket für Beobachtbarkeit für Ihre Tracedaten bereitstellen möchten, klicken Sie im Banner auf Aktivieren.

    Wenn Sie auf Aktivieren klicken, wird ein Span an Ihr Projekt gesendet. Wenn das System den Span empfängt, wird der Befehl zum Erstellen eines Buckets für Beobachtbarkeit mit dem Namen _Trace ausgegeben. Dieser Vorgang kann einige Minuten dauern.

    Wenn die Initialisierung erfolgreich ist, wird ein Benachrichtigungsbanner angezeigt und Cloud Trace nimmt alle Tracedaten auf, die in der letzten Stunde gesendet wurden. Diese Daten wurden in einem temporären Puffer gespeichert. Es kann einige Minuten dauern, bis die Daten im Trace Explorer angezeigt werden. Wenn Sie keine Daten sehen, aktualisieren Sie das Fenster.

  3. Wenn der Befehl zum Aktivieren fehlschlägt, wird die folgende Meldung angezeigt:

    Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

    Wenn Sie den Fehler beheben möchten, wenden Sie sich an den Google Cloud Support und klicken Sie auf Ticket einreichen.

Suche nach einem bestimmten Trace schlägt fehl

Sie geben eine Trace-ID auf der Seite Trace Explorer ein. Der Trace wird nicht gefunden und eine Meldung wie die folgende wird angezeigt:

The select trace with ID abcde does not exist or is older than 30 days and has been deleted per our retention policy.

So beheben Sie diesen Fehler:

  1. Prüfen Sie, ob der mit der Trace-ID verknüpfte Zeitstempel innerhalb des Aufbewahrungszeitraums liegt.

  2. Ermitteln Sie das Google Cloud Projekt, in dem der Trace gespeichert ist, und prüfen Sie, ob in der Ressourcenauswahl in der Google Cloud Console dieses Projekt ausgewählt ist. Standardmäßig hat die Seite Trace Explorer nur Zugriff auf Tracedaten, die im ausgewählten Projekt gespeichert sind.

Ältere Daten fehlen auf der Seite Trace Explorer

Sie verwenden die Seite Trace Explorer und können aktuelle Daten sehen. Wenn Sie jedoch die Zeitbereichsauswahl auf 30 Tage oder einen größeren Wert festlegen, werden die älteren Daten nicht angezeigt.

Auf der Seite Trace Explorer werden keine Daten für Zeiträume angezeigt, die länger als der Aufbewahrungszeitraum von Cloud Trace sind (30 Tage).

Wenn die Zeitbereichsauswahl 30 Tage oder weniger beträgt, bedeutet das Fehlen von Daten, dass die Datenbank, die von der Seite Trace Explorer abgefragt wird, erst nach der Festlegung des Zeitbereichs erstellt wurde. Wenn Sie diesen Wert beispielsweise auf 20 Tage festlegen und nur die Daten der letzten 10 Tage sehen können, wurde die Datenbank vor 10 Tagen erstellt. Außerdem enthält diese Datenbank nur Traces, die an Ihr Google Cloud Projekt gesendet wurden, nachdem die Datenbank erstellt wurde.

Unvollständiger Trace wird angezeigt

Sie öffnen die Seite Trace Explorer und wählen einen Span aus, um ihn anzusehen. Im Flyout Details wird der Trace angezeigt, aber er ist nicht vollständig. Einige Spans werden nicht angezeigt.

Spans können aus folgenden Gründen fehlen:

  • Die Seite Trace Explorer durchsucht nicht alle Google Cloud Projekte , in denen Spandaten für den Trace gespeichert sind.

  • Ihre IAM-Rolle für ein Google Cloud Projekt, in dem Spandaten für den Trace gespeichert sind, enthält nicht die Berechtigungen, die zum Aufrufen von Tracedaten erforderlich sind.

  • Es gibt ein Problem mit der Instrumentierung. Beispielsweise wurden nur einige Spans in einem Trace an Ihr Google Cloud Projekt gesendet.

So beheben Sie diese Probleme:

  1. Legen Sie auf der Seite Trace Explorer das Element Bereich auf einen Tracebereich fest, in dem die Projekte aufgeführt sind, in denen die Spans für den ausgewählten Trace gespeichert sind.

    Wenn kein Tracebereich vorhanden ist, der die im vorherigen Schritt ermittelten Projekte enthält, erstellen oder ändern Sie einen vorhandenen Tracebereich. Weitere Informationen finden Sie unter Tracebereiche erstellen und verwalten.

  2. Prüfen Sie, ob Sie für die Projekte, in denen die Spandaten gespeichert sind, die Rolle „Cloud Trace-Nutzer“ (roles/cloudtrace.user) haben.

Sie haben nicht die erforderlichen Berechtigungen zum Aufrufen von Tracedaten

Sie rufen die Seite Trace Explorer auf und sehen die folgende Benachrichtigung:

You don't have the required permissions to view trace data for one or more projects listed in the trace scope.

So beheben Sie dieses Problem: Führen Sie in der Symbolleiste die folgenden Schritte aus:

  1. Maximieren Sie das Element Bereich und ermitteln Sie den ausgewählten Tracebereich.
  2. Wählen Sie im Flyout Bereich eingrenzen die Option Bereiche verwalten aus.
  3. Suchen Sie den im ersten Schritt ermittelten Tracebereich und maximieren Sie die Details, um die Liste der Google Cloud Projekte aufzurufen.
  4. Prüfen Sie für jedes Google Cloud Projekt im Tracebereich, ob Sie die Rolle „Cloud Trace-Nutzer“ (roles/cloudtrace.user) haben. Wenn Sie diese Rolle für ein Projekt nicht haben, bitten Sie einen Administrator oder Projektinhaber, Ihnen diese Rolle zuzuweisen.

Regionenübergreifende Abfragen werden nicht unterstützt

Sie öffnen die Seite Trace Explorer und sehen eine Meldung wie die folgende:

Error loading chart data. Cross-regional queries are not supported. The selected scope comprises buckets residing in multiple locations: list of locations.

Die Fehlermeldung gibt an, dass die Seite Trace Explorer eine Abfrage für Daten ausgeben muss, die an verschiedenen Speicherorten gespeichert sind.

So beheben Sie diesen Fehler:

  • Beschränken Sie die Tracedaten auf die Daten, die von Ihrem ausgewählten Projekt gespeichert werden:

    • Rufen Sie die Symbolleiste der Seite Trace Explorer auf und maximieren Sie das Menü Bereich.
    • Wählen Sie im Flyout Bereich eingrenzen die Option Aktuelles Projekt aus.

  • Wählen Sie einen Tracebereich aus, in dem Projekte aufgeführt sind, deren Daten am selben Speicherort gespeichert sind. Verwenden Sie dazu die Optionen im Menü Bereich.

  • Entfernen Sie aus dem ausgewählten Tracebereich die Projekte, deren Daten an einem anderen Speicherort als Ihr ausgewähltes Projekt gespeichert sind:

    • Rufen Sie die Symbolleiste der Seite Trace Explorer auf und maximieren Sie das Menü Bereich.
    • Wählen Sie im Flyout Bereich eingrenzen die Option Bereiche verwalten aus.
    • Auf der Seite Tracebereiche können Sie jeden Tracebereich bearbeiten.

    Führen Sie den Befehl zum Auflisten von Buckets für Beobachtbarkeit aus, um den Speicherort Ihrer Tracedaten zu ermitteln. Geben Sie im Pfadparameter Ihr Projekt an und legen Sie für den LOCATION das Feld auf einen Bindestrich (-) fest, der als Platzhalter dient.

Meldung „Fehlende Span-ID“ im Trace

Ihr Trace enthält die Meldung „Fehlende Span-ID“.

In Systemen für verteiltes Tracing sind unvollständige Traces zu erwarten. Ein Trace ist unvollständig, wenn ein Stichproben-Span einen Verweis auf einen anderen Span enthält, der nicht empfangen wurde. Der nicht aufgelöste Verweis kann folgende Ursachen haben:

  • Der referenzierte Span wurde nicht als Stichprobe erfasst.
  • Der referenzierte Span wurde als Stichprobe erfasst, aber noch nicht von Cloud Trace empfangen. Oder der Span wurde empfangen, aber nicht gespeichert.

Wenn Sie einen unvollständigen Trace ansehen, wird im Bereich mit den Trace-Details die Meldung „Fehlende Span-ID“ angezeigt.

Wenn Sie die Meldung „Fehlende Span-ID“ immer wieder sehen, versuchen Sie Folgendes:

Log- und Tracedaten können nicht korreliert werden

Sie führen eine der folgenden Aktionen aus:

  • Sie sehen einen Trace-Span und möchten die zugehörigen Logeinträge aufrufen. Es werden jedoch entweder keine Logdaten aufgeführt oder auf der Seite Log-Explorer werden keine Logeinträge angezeigt.

  • Sie sehen einen Logeintrag und möchten die zugehörigen Trace-Spans aufrufen. Wenn Sie jedoch die Optionen im Logeintrag verwenden, um die Seite Trace Explorer zu öffnen, werden keine Tracedaten angezeigt.

Konfigurieren Sie den Bereich für Beobachtbarkeit, um diese Fehler zu beheben. In diesem Bereich wird angegeben, welche Ihrer Tracebereiche und Logbereiche verwendet werden sollen, wenn die entsprechenden Explorer-Seiten geöffnet werden. Weitere Informationen finden Sie unter Bereiche für Beobachtbarkeit für Abfragen mit mehreren Projekten konfigurieren.

Keine Tracedaten nach dem Aktualisieren der Go-App zur Verwendung von OpenTelemetry

Ihre Anwendung verwendet die Clientbibliothek, um Traces zu erfassen. Nachdem Sie Ihre Anwendung auf OpenTelemetry aktualisiert haben, werden keine Cloud Trace-Daten mehr angezeigt.

Da einige Cloud-Clientbibliotheken für Go in OpenCensus integriert sind, müssen Sie eine OpenCensus-Bridge verwenden. Weitere Informationen zum Problem, das durch die Bridge gelöst wird, finden Sie unter OpenCensus-Bridge.

Informationen zum Update der Cloud-Clientbibliotheken für Go finden Sie unter Problem 4237.