Trace-Audit-Logging

In diesem Dokument wird das Audit-Logging für Cloud Trace beschrieben. Google Cloud-Dienste generieren Audit-Logs, die Verwaltungs- und Zugriffsaktivitäten in Ihren Google Cloud-Ressourcen aufzeichnen. Weitere Informationen zu Cloud-Audit-Logs finden Sie hier:

• Arten von Audit-Logs
• Struktur von Audit-Logeinträgen
• Audit-Logs speichern und weiterleiten
• Preisübersicht für Cloud Logging
• Audit-Logs zum Datenzugriff aktivieren

Dienstname

Für Audit-Logs von Cloud Trace wird der Dienstname cloudtrace.googleapis.com verwendet. Nach diesem Dienst filtern:

    protoPayload.serviceName="cloudtrace.googleapis.com"
  

Methoden nach Berechtigungstyp

Jede IAM-Berechtigung hat ein type-Attribut, dessen Wert ein Enum ist, der einen der folgenden vier Werte haben kann: ADMIN_READ, ADMIN_WRITE, DATA_READ oder DATA_WRITE. Wenn Sie eine Methode aufrufen, Cloud Trace generiert ein Audit-Log, dessen Kategorie vom type-Eigenschaft der Berechtigung, die zum Ausführen der Methode erforderlich ist. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert DATA_READ, DATA_WRITE oder ADMIN_READ erfordern, generieren Audit-Logs zum Datenzugriff. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert ADMIN_WRITE erfordern, generieren Audit-Logs zur Administratoraktivität.

Berechtigungstyp	Methoden
ADMIN_READ	google.devtools.cloudtrace.v2beta1.TracingConfigService.GetTraceSink google.devtools.cloudtrace.v2beta1.TracingConfigService.ListTraceSinks
ADMIN_WRITE	google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink google.devtools.cloudtrace.v2beta1.TracingConfigService.DeleteTraceSink google.devtools.cloudtrace.v2beta1.TracingConfigService.UpdateTraceSink
DATA_READ	google.devtools.cloudtrace.v1.TraceService.GetTrace google.devtools.cloudtrace.v1.TraceService.ListTraces

Audit-Logs der API-Schnittstelle

Informationen dazu, wie und welche Berechtigungen für die einzelnen Methoden evaluiert werden, finden Sie in der Dokumentation zur Identitäts- und Zugriffsverwaltung für Cloud Trace.

google.devtools.cloudtrace.v1.TraceService

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.devtools.cloudtrace.v1.TraceService gehören.

GetTrace

• Methode: google.devtools.cloudtrace.v1.TraceService.GetTrace
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • cloudtrace.traces.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.devtools.cloudtrace.v1.TraceService.GetTrace"
  

ListTraces

• Methode: google.devtools.cloudtrace.v1.TraceService.ListTraces
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • cloudtrace.traces.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.devtools.cloudtrace.v1.TraceService.ListTraces"
  

google.devtools.cloudtrace.v2beta1.TracingConfigService

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.devtools.cloudtrace.v2beta1.TracingConfigService gehören.

CreateTraceSink

• Methode: google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • cloudtrace.tracesinks.create - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink"
  

DeleteTraceSink

• Methode: google.devtools.cloudtrace.v2beta1.TracingConfigService.DeleteTraceSink
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • cloudtrace.tracesinks.delete - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.DeleteTraceSink"
  

GetTraceSink

• Methode: google.devtools.cloudtrace.v2beta1.TracingConfigService.GetTraceSink
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • cloudtrace.tracesinks.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.GetTraceSink"
  

ListTraceSinks

• Methode: google.devtools.cloudtrace.v2beta1.TracingConfigService.ListTraceSinks
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • cloudtrace.tracesinks.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.ListTraceSinks"
  

UpdateTraceSink

• Methode: google.devtools.cloudtrace.v2beta1.TracingConfigService.UpdateTraceSink
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • cloudtrace.tracesinks.update - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.UpdateTraceSink"
  

Methoden, die keine Audit-Logs generieren

Eine Methode kann aus folgenden Gründen keine Audit-Logs erstellen:

• Dies ist eine Methode mit hohem Volumen, die erhebliche Loggenerierungs- und Speicherkosten mit sich bringt.
• Sie hat einen geringen Prüfwert.
• Ein anderes Audit- oder Plattformlog bietet bereits eine Methodenabdeckung.

Die folgenden Methoden generieren keine Audit-Logs:

• google.devtools.cloudtrace.v1.TraceService.PatchTraces
• google.devtools.cloudtrace.v2.TraceService.BatchWriteSpans
• google.devtools.cloudtrace.v2.TraceService.CreateSpan