Logs exportieren und in BigQuery importieren

Sie können Plattformlogs, die von Google Cloud Fraud Defense generiert wurden, von Cloud Logging zu BigQuery weiterleiten, indem Sie im Logrouter eine Logsenke erstellen.

Sie können Plattformlogs nach BigQuery exportieren, um Bewertungs daten langfristig aufzubewahren, Risikobewertungen und Begründungscodes mit SQL zu analysieren und Traffic-Trends in Data Studio zu visualisieren. Plattformlogs in Logging haben eine standardmäßige Aufbewahrungsdauer von 30 Tagen, die Sie auf bis zu 3.650 Tage konfigurieren können.

Fraud Defense unterstützt Plattform-Logging für die folgenden v1-API-Vorgänge:

• Assessment -Antwort von projects.assessments.create
• AnnotateAssessmentRequest -Anfrage an projects.assessments.annotate

Hinweis: Plattform-Logging ist für die v1beta1 und Legacy SiteVerify APIs nicht verfügbar. Zum Schutz der Privatsphäre enthalten Plattformprotokolle keine personenidentifizierbaren Informationen (PII), die zur Betrugsprävention bereitgestellt wurden.

Hinweis

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen (Identity and Access Management) für Ihr Google Cloud Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktivieren von Plattformlogs und zum Weiterleiten an BigQuery benötigen:

• Plattform-Logging für Fraud Defense aktivieren: reCAPTCHA Enterprise-Administrator (roles/recaptchaenterprise.admin)
• Logging-Senken erstellen und verwalten: Autor von Log-Konfigurationen (roles/logging.configWriter)
• BigQuery-Datasets erstellen und Schreibberechtigungen für Senken gewähren: BigQuery-Dateneditor (roles/bigquery.dataEditor)

Plattformlogs aktivieren

Bevor Sie Logs an BigQuery weiterleiten, aktivieren Sie Plattformlogs in Fraud Defense:

1. Rufen Sie in der Google Cloud Console die Seite Fraud Defense auf.

   Zu Fraud Defense

2. Prüfen Sie, ob Ihr Projektname in der Ressourcenauswahl angezeigt wird.

   Wenn Ihr Projektname nicht angezeigt wird, klicken Sie auf die Ressourcenauswahl und wählen Sie Ihr Projekt aus.

3. Klicken Sie auf Einstellungen.

4. Klicken Sie auf der Karte Plattform-Logging auf Konfigurieren.

5. Klicken Sie im Bereich Plattform-Logging auf die Schaltfläche für Bewertungslogs aktivieren.

6. Optional: Wenn Sie Anmerkungsanfragen exportieren möchten, klicken Sie auf die Schaltfläche neben Anmerkungslogs aktivieren.

7. Klicken Sie auf Speichern.

Weitere Informationen zum Verwalten der Einstellungen für Plattformlogs finden Sie unter Mit Plattformlogs arbeiten.

BigQuery-Senke erstellen

Nachdem Sie Plattformlogs aktiviert haben, erstellen Sie im Logrouter eine Senke, um neue reCAPTCHA-Bewertungslogeinträge nach BigQuery zu exportieren:

1. Rufen Sie in der Google Cloud Console die Seite Logrouter auf.

   Zum Logrouter

2. Klicken Sie auf Senke erstellen.

3. Geben Sie im Bereich Senkendetails einen Namen und optional eine Beschreibung für die Senke ein und klicken Sie dann auf Weiter.

4. Führen Sie im Bereich Senkenziel die folgenden Schritte aus, um das Ziel-Dataset zu konfigurieren:

   1. Wählen Sie im Menü Senkendienst auswählen die Option BigQuery-Dataset aus.
   2. Wählen Sie im Menü BigQuery-Dataset auswählen ein vorhandenes Dataset aus oder wählen Sie Neues BigQuery-Dataset erstellen aus.
   3. Wenn Sie ein neues Dataset erstellen, geben Sie einen Namen ein und klicken Sie dann auf Dataset erstellen.
   4. Wählen Sie Partitionierte Tabellen verwenden aus und klicken Sie dann auf Weiter.

5. Wenn Sie alle Bewertungslogeinträge einbeziehen möchten, geben Sie im Bereich Logs auswählen, die in der Senke enthalten sind im Feld Einschlussfilter erstellen den folgenden Einschlussfilter ein:

   resource.type="recaptchaenterprise.googleapis.com/Key"
   log_id("recaptchaenterprise.googleapis.com/assessment")
   

6. Optional: Wenn Sie sowohl assessment- als auch annotation-Plattformlogs in die Senke aufnehmen möchten, geben Sie stattdessen den folgenden Filter ein:

   resource.type="recaptchaenterprise.googleapis.com/Key"
   (log_id("recaptchaenterprise.googleapis.com/assessment") OR
     log_id("recaptchaenterprise.googleapis.com/annotation"))
   

7. Klicken Sie auf Weiter.

8. Optional: Konfigurieren Sie bei Bedarf Ausschlussfilter und klicken Sie dann auf Senke erstellen.

Nachdem die Senke erstellt wurde, wird in Logging eine Bestätigungsnachricht angezeigt und automatisch ein Writer-Dienstkonto mit Berechtigungen zum Schreiben von Logeinträgen in Ihr BigQuery-Dataset bereitgestellt.

Hinweis: Logsenken exportieren nur neue Logeinträge, die nach dem Erstellen der Senke empfangen wurden. Sie können Logeinträge, die in Logging empfangen wurden, bevor Sie die Senke erstellt haben, nicht nachträglich exportieren.

Preise

Für den Export von Plattformlogs nach BigQuery fallen Standardgebühren für Logging und BigQuery an:

• Informationen zu den Kosten für die Logaufnahme und das Logrouting finden Sie unter Logging-Preise.
• Informationen zu den Kosten für die Datenspeicherung und SQL-Abfrage finden Sie unter BigQuery-Preise.

Hinweis: Um eine doppelte Abrechnung von Logs zu vermeiden, achten Sie darauf, dass die veralteten DATA_WRITE Audit Logs für reCAPTCHA nicht aktiviert sind. Weitere Informationen finden Sie unter Audit-Logging für Fraud Defense.

Nächste Schritte

• Dashboards mit Data Studio erstellen.
• Weitere Informationen zu BigQuery-Speicher.
• Weitere Informationen zu BigQuery-Analysen.