Fehler beim Routing und Speichern von Logs beheben

In diesem Dokument werden häufige Routing- und Speicherprobleme erläutert. Außerdem erfahren Sie, wie Sie mit der Google Cloud Console Konfigurationsfehler oder unerwartete Ergebnisse ansehen und beheben können.

Allgemeine Informationen zur Verwendung von Logs an Senkenzielen finden Sie unter Logs in Senkenzielen ansehen.

Fehlerbehebung bei Routinglogs

In diesem Abschnitt wird beschrieben, wie Sie häufige Probleme beim Routing von Logs beheben.

Ziel enthält unerwünschte Logs

Sie sehen sich die an ein Ziel weitergeleiteten Logs an und stellen fest, dass das Ziel unerwünschte Logs enthält.

Um diesen Fehler zu beheben, aktualisieren Sie die Ausschlussfilter für die Senken, die Logs an das Ziel weiterleiten. Mit Ausschlussfiltern können Sie die Weiterleitung bestimmter Logs an ein Ziel ausschließen.

Angenommen, Sie erstellen eine aggregierte Senke, um Logs in einer Organisation an ein Ziel weiterzuleiten. Wenn Sie möchten, dass die Logs eines bestimmten Projekts nicht an das Ziel weitergeleitet werden, fügen Sie der Senke den folgenden Ausschlussfilter hinzu:

logName:projects/PROJECT_ID

Sie können auch Logs aus mehreren Projekten ausschließen, indem Sie logName-Klauseln mit dem logischen ODER-Operator verbinden.

Im Ziel fehlen Logs

Das häufigste Problem in Bezug auf Senken besteht wahrscheinlich darin, dass Logs in einem Senkenziel fehlen.

In einigen Fällen wird kein Fehler generiert, aber Sie stellen möglicherweise fest, dass Logs nicht verfügbar sind, wenn Sie versuchen, auf sie in Ihrem Ziel zuzugreifen. Wenn Sie vermuten, dass Ihre Senke Logs nicht ordnungsgemäß weiterleitet, prüfen Sie die logbasierten Systemmesswerte der Senke:

  • exports/byte_count: Anzahl der Byte in Logeinträgen, die weitergeleitet wurden
  • exports/log_entry_count: Anzahl der weitergeleiteten Logeinträge
  • exports/error_count: Anzahl der Logeinträge, die nicht weitergeleitet werden konnten

Die Messwerte haben Labels, mit denen die Anzahl nach Senkennamen und Zielnamen aufgezeichnet wird. Diese geben an, ob Ihre Senke Logdaten erfolgreich weiterleitet oder fehlschlägt. Weitere Informationen zum Aufrufen von Messwerten finden Sie unter Logbasierte Messwerte ansehen.

Wenn die Senkenmesswerte darauf hinweisen, dass die Senke nicht wie erwartet funktioniert, kann dies u. a. folgende Gründe haben:

Latenz

  • Seit dem Erstellen oder Aktualisieren der Senke wurden keine übereinstimmenden Logeinträge empfangen. Es werden nur neue Logeinträge weitergeleitet.

    Warten Sie eine Stunde und prüfen Sie dann Ihr Ziel noch einmal.

  • Übereinstimmende Logeinträge kömmen spät an.

    Es kann einige Zeit dauern, bis Ihre Logs am Ziel angezeigt werden. Spät ankommende Logs werden besonders häufig bei Senken verwendet, für die Cloud Storage-Buckets als Ziele konfiguriert wurden. Warten Sie einige Stunden und prüfen Sie dann Ihr Ziel noch einmal.

Ansichtsbereich/Filter ist falsch

  • Der Bereich, den Sie zum Ansehen von Logs in Logging-Bucket-Zielen verwenden, ist falsch.

    Begrenzen Sie Ihre Suche so auf eine oder mehrere Speicheransichten:

    • Wenn Sie den Log-Explorer verwenden, klicken Sie auf die Schaltfläche Bereich eingrenzen.

    • Wenn Sie die gcloud CLI verwenden, führen Sie den Befehl gcloud logging read aus und fügen Sie ein --view=AllLogs-Flag hinzu.

  • Der Zeitraum, den Sie zum Auswählen und Aufrufen von Daten im Senkenziel verwenden, ist zu eng gefasst.

    Erweitern Sie den Zeitraum, den Sie bei der Auswahl von Daten im Senkenziel verwenden.

Fehler im Senkenfilter

  • Der Filter der Senke ist falsch und es werden nicht die Logs erfasst, die im Ziel erwartet werden.

    • Bearbeiten Sie den Filter der Senke mit dem Logrouter in der Google Cloud Console. Wählen Sie im Bereich Senke bearbeiten die Option Logs ansehen aus, um zu prüfen, ob Sie den richtigen Filter eingegeben haben. Dadurch wird der Log-Explorer in einem neuen Tab mit bereits ausgefülltem Filter geöffnet. Eine Anleitung zum Aufrufen und Verwalten von Senken finden Sie unter Senken verwalten.

Fehler ansehen

Für jedes unterstützte Senkenziel bietet Logging Fehlermeldungen für falsch konfigurierte Senken.

Es gibt mehrere Möglichkeiten, diese senkenbezogenen Fehler aufzurufen. Diese Methoden werden in den folgenden Abschnitten beschrieben:

  • Sehen Sie sich die Fehlerlogs an, die für die Senke generiert wurden.
  • Sie erhalten Benachrichtigungen zu Senkenfehlern per E-Mail.

Fehlerlogs

Es wird empfohlen, die mit Senken verbundenen Fehler im Detail zu prüfen, indem Sie sich die von der Senke generierten Fehlerlogeinträge ansehen. Weitere Informationen zum Aufrufen von Logs finden Sie unter Logs mit dem Log-Explorer ansehen.

Sie können die folgende Abfrage im Abfrageeditor im Log-Explorer verwenden, um die Fehlerlogs Ihrer Senke zu überprüfen. Die gleiche Abfrage funktioniert in der Logging API und der gcloud CLI.

Ersetzen Sie vor dem Kopieren der Abfrage die Variable SINK_NAME durch den Namen der Senke, für die Sie eine Fehlerbehebung durchführen möchten. Sie finden den Namen der Senke in der Google Cloud Console auf der Seite Logrouter.

logName:"logging.googleapis.com%2Fsink_error"
resource.type="logging_sink"
resource.labels.name="<var>SINK_NAME</var>"

Wenn der Name der Senke beispielsweise my-sink-123 lautet, könnte der Logeintrag in etwa so aussehen:

{
  "textPayload": "Cloud Logging export config error in my-logs-project, export sink my-sink-123: dataset_not_found ()",
  "insertId": "12akhzyb14452",
  "resource": {
    "type": "logging_sink",
    "labels": {
      "project_id": "my-logs-test-project",
      "destination": "",
      "name": "my-sink-123"
    }
  },
  "timestamp": "2021-08-02T17:01:28.620961700Z",
  "severity": "ERROR",
  "labels": {
    "error_code": "dataset_not_found",
    ...
    "destination": "bigquery.googleapis.com/projects/my-logs-project/datasets/my-dataset",
    "sink_id": "my-sink-123",
    "activity_type_name": "LoggingSinkConfigErrorV2"
  },
  "logName": "projects/cloud-logs-test-project/logs/logging.googleapis.com%2Fsink_error",
  "receiveTimestamp": "2021-08-02T17:01:30.148869575Z"
}

Das LogEntry-Feld labels und die Informationen zu den verschachtelten Schlüssel/Wert-Paaren unterstützen Sie dabei, die Quelle des Fehlers der Senke zu ermitteln. Es enthält die betroffene Ressource, die betroffene Senke und den Fehlercode. Das Feld labels.error_code enthält eine Kurzbeschreibung des Fehlers, die angibt, welche Komponente Ihrer Senke neu konfiguriert werden muss.

Verwenden Sie zum Aktualisieren der Senke den Logrouter.

Wählen Sie im Navigationsbereich der Google Cloud Console Logging und dann Log Router aus:

Zum Logrouter

E-Mail-Benachrichtigungen

Wenn Sie ein Google Cloud-Projekt oder die übergeordnete Ressource als Technical Essential Contact abonniert haben, erhalten Sie E-Mail-Benachrichtigungen zu Fehlern in der Senkenkonfiguration. Wenn für eine Ressource keine Technical Essential Contacts konfiguriert sind, erhalten Nutzer, die als IAM-Projektinhaber (roles/owner) für die Ressource aufgeführt sind, die E-Mail-Benachrichtigung.

Die E-Mail enthält die folgenden Informationen:

  • Ressourcen-ID: Der Name des Google Cloud-Projekts oder einer anderen Google Cloud-Ressource, in der die Senke konfiguriert wurde.
  • Senkenname: Der Name der Senke, die den Konfigurationsfehler enthält.
  • Senkenziel: Der vollständige Pfad des Weiterleitungsziels der Senke. Beispiel: bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID
  • Fehlercode: Kurzbeschreibung der Fehlerkategorie. Beispiel: dataset_not_found
  • Fehlerdetail: Detaillierte Informationen zum Fehler, einschließlich Empfehlungen zur Behebung des zugrunde liegenden Fehlers.

Verwenden Sie den Logrouter, um Ihre Senken anzusehen und zu verwalten.

Wählen Sie im Navigationsbereich der Google Cloud Console Logging und dann Log Router aus:

Zum Logrouter

Alle für die Ressource geltenden Senkenkonfigurationsfehler werden in der Liste als Cloud Logging sink configuration error angezeigt. Jeder Fehler enthält einen Link zu einem der Logeinträge, die von der fehlerhaften Senke generiert wurden. Informationen zum genauen Prüfen der zugrunde liegenden Fehler finden Sie im Abschnitt Fehlerlogs.

Arten von Senkenfehlern

In den folgenden Abschnitten werden weit gefasste Kategorien von Senkenfehlern und deren Behebung beschrieben.

Falsches Ziel

Wenn Sie eine Senke eingerichtet haben und dann ein Konfigurationsfehler angezeigt wird, der besagt, dass das Ziel beim Versuch, Logs weiterzuleiten, nicht gefunden werden konnte, kann dies folgende Gründe haben:

  • Die Konfiguration der Senke enthält für das angegebene Senkenziel einen Rechtschreib- oder Formatierungsfehler.

    Sie müssen die Konfiguration der Senke aktualisieren, um das vorhandene Ziel ordnungsgemäß anzugeben.

  • Das angegebene Ziel wurde möglicherweise gelöscht.

    Sie können entweder die Konfiguration der Senke ändern, um ein anderes vorhandenes Ziel zu verwenden, oder das Ziel mit demselben Namen neu erstellen.

Rufen Sie in beiden Fällen die Seite Logrouter auf, um Probleme zu beheben.

Wählen Sie im Navigationsbereich der Google Cloud Console Logging und dann Log Router aus:

Zum Logrouter

Ihre Senke beginnt mit der Weiterleitung von Logs, wenn das Ziel gefunden wurde und neue Logs, die Ihrem Filter entsprechen, von Logging empfangen werden.

Probleme mit Senken verwalten

Wenn Sie eine Senke deaktiviert haben, um das Speichern von Logs in einem Log-Bucket zu beenden, aber weiterhin Logs weitergeleitet werden, warten Sie einige Minuten, bis Änderungen an der Senke wirksam werden.

Berechtigungsprobleme

Wenn beim Weiterleiten eines Logeintrags durch eine Senke nicht die erforderlichen IAM-Berechtigungen für das Ziel der Senke vorhanden sind, wird ein Fehler ausgegeben, den Sie aufrufen können. Der Logeintrag wird übersprungen.

Wenn Sie eine Senke erstellen, müssen dem Dienstkonto der Senke die entsprechenden Zielberechtigungen gewährt werden. Wenn Sie die Senke in der Google Cloud Console im selben Google Cloud-Projekt erstellen, werden diese Berechtigungen von der Google Cloud Console automatisch zugewiesen. Wenn Sie die Senke in einem anderen Google Cloud-Projekt oder über die gcloud CLI oder die Logging API erstellen, müssen Sie die Berechtigungen manuell konfigurieren.

Wenn berechtigungsbezogene Fehler für Ihre Senke auftreten, fügen Sie dem Ziel die erforderlichen Berechtigungen hinzu oder aktualisieren Sie die Senke, um ein anderes Ziel zu verwenden. Eine Anleitung zum Aktualisieren dieser Berechtigungen finden Sie unter Zielberechtigungen.

Zwischen dem Erstellen der Senke und dem Gewähren der Schreibberechtigung für das Exportziel mithilfe des neuen Dienstkontos der Senke kommt es zu einer kleinen Verzögerung. Ihre Senke beginnt mit dem Weiterleiten von Logs, wenn Berechtigungen korrigiert wurden und neue Logs, die Ihrem Filter entsprechen, von Logging empfangen werden.

Probleme mit Organisationsrichtlinien

Wenn Sie versuchen, einen Logeintrag weiterzuleiten, aber auf eine Organisationsrichtlinie stoßen, die Logging daran hindert, in das Senkenziel zu schreiben, kann die Senke kein Routing an das ausgewählte Ziel vornehmen und meldet einen Fehler.

Wenn Fehler im Zusammenhang mit Organisationsrichtlinien auftreten, können Sie Folgendes tun:

  • Aktualisieren Sie die Organisationsrichtlinie für das Ziel, um die Einschränkungen zu entfernen, die die Senke am Routing von Logeinträgen blockieren. Dies setzt voraus, dass Sie die entsprechenden Berechtigungen zum Aktualisieren der Organisationsrichtlinie haben. Eine Anleitung finden Sie unter Richtlinien erstellen und bearbeiten.

  • Wenn Sie die Organisationsrichtlinie nicht aktualisieren können, aktualisieren Sie die Senke auf der Seite Logrouter, um ein konformes Ziel zu verwenden.

    Wählen Sie im Navigationsbereich der Google Cloud Console Logging und dann Log Router aus:

    Zum Logrouter

Ihre Senke beginnt mit dem Weiterleiten von Logs, wenn die Organisationsrichtlinie das Schreiben in das Ziel durch die Senke nicht mehr verhindert und neue Logs, die Ihrem Filter entsprechen, von Logging empfangen werden.

Probleme mit Verschlüsselungsschlüsseln

Wenn Sie zum Verschlüsseln der Daten im Ziel der Senke Verschlüsselungsschlüssel verwenden, die mit dem Cloud Key Management Service oder von Ihnen verwaltet werden, werden möglicherweise ähnliche Fehler angezeigt. Hier sind einige mögliche Probleme und Möglichkeiten, sie zu beheben:

  • Die Abrechnung wird für das Google Cloud-Projekt, das den Cloud KMS-Schlüssel enthält, nicht aktiviert.

    • Auch wenn die Senke erfolgreich mit dem richtigen Ziel erstellt wurde, wird diese Fehlermeldung angezeigt, wenn dem Google Cloud-Projekt, das den Schlüssel enthält, kein gültiges Rechnungskonto zugeordnet ist.

    • Achten Sie darauf, dass ein gültiges Rechnungskonto mit dem Google Cloud-Projekt verknüpft ist, das den Schlüssel enthält. Wenn kein Rechnungskonto mit dem Google Cloud-Projekt verknüpft ist, aktivieren Sie die Abrechnung für dieses Google Cloud-Projekt oder verwenden Sie einen Cloud KMS-Schlüssel aus einem Google Cloud-Projekt, mit dem ein gültiges Rechnungskonto verknüpft ist.

  • Der Cloud KMS-Schlüssel wurde nicht gefunden.

    • Das Google Cloud-Projekt, das den Cloud KMS-Schlüssel enthält, der zum Verschlüsseln der Daten konfiguriert ist, wurde nicht gefunden.

    • Verwenden Sie einen gültigen Cloud KMS-Schlüssel aus einem vorhandenen Google Cloud-Projekt.

  • Der Standort des Cloud KMS-Schlüssels stimmt nicht mit dem Standort des Ziels überein.

    • Wenn sich das Google Cloud-Projekt, das den Cloud KMS-Schlüssel enthält, in einer anderen Region als der des Ziels befindet, schlägt die Verschlüsselung fehl und die Senke kann keine Daten an dieses Ziel weiterleiten.

    • Verwenden Sie einen Cloud KMS-Schlüssel, der in einem Google Cloud-Projekt enthalten ist, dessen Region mit dem Ziel der Senke übereinstimmt.

  • Der Zugriff auf den Verschlüsselungsschlüssel wird für das Dienstkonto der Senke verweigert.

    • Auch wenn die Senke erfolgreich mit den richtigen Dienstkontoberechtigungen erstellt wurde, wird diese Fehlermeldung angezeigt, wenn das Senkenziel einen Verschlüsselungsschlüssel verwendet, der dem Dienstkonto keine ausreichenden Berechtigungen zum Verschlüsseln oder Entschlüsseln der Daten gibt.

    • Weisen Sie dem in der Senke im Feld writerIdentity angegebenen Dienstkonto die Role Cloud KMS CryptoKey-Verschlüsseler/Entschlüsseler für den am Ziel verwendeten Schlüssel zu. Prüfen Sie außerdem, ob die Cloud KMS API aktiviert ist.

Kontingentprobleme

Wenn Senken Logs schreiben, gelten zielspezifische Kontingente für die Google Cloud-Projekte, in denen die Senken erstellt wurden. Wenn die Kontingente erschöpft sind, beendet die Senke das Weiterleiten von Logs an das Ziel.

Wenn Sie beispielsweise Daten an BigQuery weiterleiten, wird möglicherweise ein Fehler angezeigt, der darauf hinweist, dass Ihr Kontingent für Streaming-Insert-Anweisungen für eine bestimmte Tabelle in Ihrem Dataset überschritten wurde. In diesem Fall leitet die Senke möglicherweise zu viele Logeinträge zu schnell weiter. Dasselbe Konzept gilt für die anderen unterstützten Senkenziele, z. B. für Pub/Sub-Themen.

Zur Behebung von Problemen mit einer Kontingentüberschreitung reduzieren Sie die Menge der Logdaten, die weitergeleitet werden. Aktualisieren Sie dazu den Filter der Senke, damit er mit weniger Logeinträgen übereinstimmt. Mit der Funktion sample in Ihrem Filter können Sie einen Teil der Gesamtzahl von Logeinträgen auswählen.

Ihre Senke beginnt, Logs an Ihr Ziel weiterzuleiten, wenn Sie Ihre Senke so aktualisiert haben, dass sie mit weniger Logeinträgen übereinstimmt, oder wenn Ihre Kontingente erneuert wurden.

Details zu den Limits, die beim Weiterleiten von Logs gelten können, finden Sie in den Kontingentinformationen des entsprechenden Ziels:

Zusätzlich zu den allgemeinen Senkenfehlertypen sind hier die häufigsten zielspezifischen Fehlertypen sowie Hinweise zu ihrer Behebung aufgeführt.

Fehler beim Weiterleiten an Cloud Storage

Die folgenden Fehler treten beim Weiterleiten von Logs an Cloud Storage am häufigsten auf:

  • Spät ankommende Logeinträge:

    • Logeinträge werden stündlich in Batches in Cloud Storage-Buckets gespeichert. Es kann zwei bis drei Stunden dauern, bis die ersten Einträge angezeigt werden.

    • Weitergeleitete Logdatei-Shards mit dem Suffix An ("Append") enthalten Logeinträge, die verspätet angekommen sind. Wenn am Cloud Storage-Ziel ein Ausfall auftritt, führt Cloud Logging eine Zwischenspeicherung der Daten durch, bis der Ausfall vorüber ist.

  • Dem Ziel können nicht die richtigen Berechtigungen zugewiesen werden:

    • Auch wenn die Senke mit den richtigen Dienstkontoberechtigungen erstellt wurde, wird diese Fehlermeldung angezeigt, wenn das Zugriffssteuerungsmodell für den Cloud Storage-Bucket beim Erstellen des Buckets auf einheitlichen Zugriff festgelegt wurde.

    • Für vorhandene Cloud Storage-Buckets können Sie das Zugriffssteuerungsmodell in den ersten 90 Tagen nach der Bucket-Erstellung über den Tab Berechtigungen ändern. Wählen Sie für neue Buckets das Zugriffssteuerungsmodell Detailgenau während der Bucket-Erstellung aus. Weitere Informationen finden Sie unter Cloud Storage-Buckets erstellen.

Fehler beim Weiterleiten an BigQuery

Die folgenden Fehler treten beim Weiterleiten von Logs an BigQuery am häufigsten auf:

  • Ungültiges Tabellenschema:

    • Logs, die in die Tabelle in Ihrem BigQuery-Dataset gestreamt wurden, entsprechen nicht dem Schema der aktuellen Tabelle. Zu den häufigsten Problemen gehören der Versuch, Logeinträge mit unterschiedlichen Datentypen weiterzuleiten, was zu einem Schemakonflikt führt. Beispiel: Eines der Felder im Logeintrag enthält eine Ganzzahl, während eine entsprechende Spalte im Schema einen Stringtyp hat.

    • Achten Sie darauf, dass Ihre Log-Einträge dem Schema der Tabelle entsprechen. Nachdem Sie die Fehlerquelle beseitigt haben, können Sie Ihre aktuelle Tabelle umbenennen und Logging die Tabelle noch einmal erstellen lassen.

    • BigQuery unterstützt das Laden von verschachtelten Daten in seine Tabellen. Beim Laden von Daten aus Logging beträgt die maximale Tiefe einer verschachtelten Spalte für eine Spalte 13 Ebenen.

    Wenn BigQuery einen Schemakonflikt erkennt, wird eine Tabelle im entsprechenden Dataset erstellt, um die Fehlerinformationen zu speichern. Der Tabellenname richtet sich nach dem Typ. Für datumsfragmentierte Tabellen ist das Namensformat export_errors_YYYYMMDD. Bei partitionierten Tabellen ist das Namensformat export_errors. Informationen zum Schema der Fehlertabellen und dazu, wie Sie zukünftige Feldtyp-Abweichungen vermeiden können, finden Sie unter Abweichungen im Schema.

  • Logeinträge liegen außerhalb der zulässigen zeitlichen Grenzen:

    • An die partitionierte BigQuery-Tabelle gestreamte Logs liegen außerhalb der zulässigen zeitlichen Grenzen. BigQuery akzeptiert keine Logs, die zu weit in der Vergangenheit oder Zukunft liegen.

    • Sie können Ihre Senke aktualisieren, um diese Logs an Cloud Storage weiterzuleiten, und einen BigQuery-Ladejob verwenden. Weitere Informationen finden Sie in der BigQuery-Dokumentation.

  • Das Dataset erlaubt dem Dienstkonto, das mit der Logsenke verknüpft ist, nicht das Schreiben:

    • Diese Fehlermeldung wird angezeigt, wenn die Senke erfolgreich mit den richtigen Dienstkontoberechtigungen erstellt wurde und dem Google Cloud-Projekt, das das Senkenziel enthält, kein gültiges Rechnungskonto zugeordnet ist.

    • Mit Ihrem Google Cloud-Projekt muss ein Rechnungskonto verknüpft sein. Wenn ein Rechnungskonto nicht mit dem Google Cloud-Zielprojekt verknüpft ist, aktivieren Sie die Abrechnung für dieses Google Cloud-Projekt oder aktualisieren Sie das Senkenziel so, dass es sich in einem Google Cloud-Projekt mit einem gültigen Rechnungskonto befindet.

  • Dataset enthält doppelte Logeinträge:

    • Doppelte Logeinträge können auftreten, wenn beim Streamen von Logs an BigQuery Fehler auftreten, z. B. aufgrund von Wiederholungsversuchen oder Fehlkonfigurationen. Cloud Logging dedupliziert Logeinträge mit denselben timestamp und insertId zum Zeitpunkt der Abfrage. BigQuery beseitigt keine doppelten Logeinträge.

    • Wenn Sie doppelte Logeinträge in BigQuery ignorieren möchten, nehmen Sie die Klausel SELECT DISTINCT in Ihre Abfrage auf. Beispiel:

    SELECT DISTINCT insertId, timestamp FROM TABLE_NAME

Fehler beim Weiterleiten an Cloud Logging-Buckets

Unter Umständen können Sie Logs im Log-Explorer sehen, die Sie mit Ihrer Senke ausgeschlossen haben. Sie können diese Logs weiterhin sehen, wenn eine der folgenden Bedingungen zutrifft:

  • Sie führen Ihre Abfrage in dem Google Cloud-Projekt aus, in dem die Logs generiert wurden.

    Um dieses Problem zu beheben, müssen Sie die Abfrage im richtigen Google Cloud-Projekt ausführen.

  • Die ausgeschlossenen Logs wurden an mehrere Log-Buckets gesendet. Sie sehen eine Kopie des Logs, das Sie ausschließen möchten.

    Prüfen Sie zur Behebung dieses Problems die Senken auf der Seite Logrouter, um die Logs nicht in die Filter anderer Senken einzubeziehen.

  • Sie haben Zugriff auf Ansichten in dem Log-Bucket, an den die Logs gesendet wurden. In diesem Fall werden diese Logs standardmäßig angezeigt.

    Wenn Sie diese Logs nicht im Log-Explorer sehen möchten, können Sie den Suchbereich auf das Google Cloud-Quellprojekt oder den Google Cloud-Quell-Bucket eingrenzen.

Fehlerbehebung beim Speichern von Logs

Warum kann ich diesen Bucket nicht löschen?

Wenn Sie versuchen, einen Bucket zu löschen, gehen Sie so vor:

  • Prüfen Sie, ob Sie die erforderlichen Berechtigungen zum Löschen des Buckets haben. Die Liste der erforderlichen Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

  • Bestimmen Sie, ob der Bucket gesperrt ist. Listen Sie dazu die Attribute des Buckets auf. Wenn der Bucket gesperrt ist, prüfen Sie die Aufbewahrungsdauer. Sie können gesperrte Buckets erst löschen, wenn alle Logs im Bucket die Aufbewahrungsdauer des Buckets erreicht haben.

  • Prüfen Sie, ob der Log-Bucket mit einem BigQuery-Dataset verknüpft ist. Sie können einen Log-Bucket mit einem verknüpften Dataset nicht löschen.

    Der folgende Fehler wird als Antwort auf den Befehl delete in einem Log-Bucket mit einem verknüpften Dataset angezeigt:

    FAILED_PRECONDITION: This bucket is used for advanced analytics and has an active link. The link must be deleted first before deleting the bucket

    Wenn Sie die Links auflisten möchten, die mit einem Log-Bucket verknüpft sind, führen Sie den Befehl [gcloud logging links list][link-list] oder die API-Methode projects.locations.buckets.links.list aus.

Welche Dienstkonten leiten Logs an meinen Bucket weiter?

So ermitteln Sie, ob Dienstkonten IAM-Berechtigungen zum Weiterleiten von Logs an Ihren Bucket haben:

  1. Wählen Sie im Navigationsbereich der Google Cloud Console IAM aus:

    Zu IAM

  2. Wählen Sie aus dem Tab Berechtigungen die Ansicht nach Rollen. Sie sehen nun eine Tabelle mit allen IAM-Rollen und Hauptkonten, die Ihrem Google Cloud-Projekt zugeordnet sind.

  3. Geben Sie in das Textfeld Filter der Tabelle Log-Bucket-Autor ein.

    Sie sehen alle Hauptkonten mit der Rolle Log-Bucket-Autor. Wenn ein Hauptkonto ein Dienstkonto ist, enthält dessen ID den String gserviceaccount.com.

  4. Optional: Wenn ein Dienstkonto nicht mehr in der Lage sein soll, Logs an Ihr Google Cloud-Projekt weiterzuleiten, klicken Sie das Kästchen für das Dienstkonto an und klicken Sie auf Entfernen.

Warum sehe ich Logs für ein Google Cloud-Projekt, obwohl ich sie von meiner _Default-Senke ausgeschlossen habe?

Möglicherweise sehen Sie sich Logs in einem Log-Bucket in einem zentralisierten Google Cloud-Projekt an, in dem Logs aus Ihrer Organisation zusammengefasst werden.

Wenn Sie den Log-Explorer für den Zugriff auf diese Logs verwenden und Logs sehen, die Sie von der Senke _Default ausgeschlossen haben, ist Ihre Ansicht möglicherweise auf die Google Cloud-Projektebene beschränkt.

Um dieses Problem zu beheben, wählen Sie im Bereich Bereich optimieren die Option Bereich nach Speicher und dann den Bucket _Default in Ihrem Google Cloud-Projekt aus. Die ausgeschlossenen Logs sollten nun nicht mehr angezeigt werden.