Audit logging Trace

Questo documento descrive la registrazione degli audit per Cloud Trace. I servizi Google Cloud generano audit log che registrano le attività amministrative e di accesso all'interno delle risorse Google Cloud. Per ulteriori informazioni su Cloud Audit Logs, consulta quanto segue:

• Tipi di log di controllo
• Struttura voce di log di controllo
• Archiviazione e inoltro dei log di controllo
• Riepilogo dei prezzi di Cloud Logging
• Attivare gli audit log di accesso ai dati

Nome servizio

Gli audit log di Cloud Trace utilizzano il nome del servizio cloudtrace.googleapis.com. Filtra per questo servizio:

    protoPayload.serviceName="cloudtrace.googleapis.com"
  

Metodi per tipo di autorizzazione

Ogni autorizzazione IAM ha una proprietà type, il cui valore è un enum che può essere uno dei quattro valori: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Quando chiami un metodo, Cloud Trace genera un log di controllo la cui categoria dipende dalla proprietà type dell'autorizzazione richiesta per eseguire il metodo. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a DATA_READ, DATA_WRITE o ADMIN_READ generano log di controllo Accesso ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type ADMIN_WRITE generano log di controllo per le attività amministrative.

Tipo di autorizzazione	Metodi
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 log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ogni metodo, consulta la documentazione di Identity and Access Management per Cloud Trace.

google.devtools.cloudtrace.v1.TraceService

I seguenti log di controllo sono associati ai metodi appartenenti a google.devtools.cloudtrace.v1.TraceService.

GetTrace

• Metodo: google.devtools.cloudtrace.v1.TraceService.GetTrace
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudtrace.traces.get - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.devtools.cloudtrace.v1.TraceService.GetTrace"
  

ListTraces

• Metodo: google.devtools.cloudtrace.v1.TraceService.ListTraces
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudtrace.traces.list - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.devtools.cloudtrace.v1.TraceService.ListTraces"
  

google.devtools.cloudtrace.v2beta1.TracingConfigService

I seguenti log di controllo sono associati ai metodi appartenenti a google.devtools.cloudtrace.v2beta1.TracingConfigService.

CreateTraceSink

• Metodo: google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudtrace.tracesinks.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink"
  

DeleteTraceSink

• Metodo: google.devtools.cloudtrace.v2beta1.TracingConfigService.DeleteTraceSink
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudtrace.tracesinks.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.DeleteTraceSink"
  

GetTraceSink

• Metodo: google.devtools.cloudtrace.v2beta1.TracingConfigService.GetTraceSink
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudtrace.tracesinks.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.GetTraceSink"
  

ListTraceSinks

• Metodo: google.devtools.cloudtrace.v2beta1.TracingConfigService.ListTraceSinks
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudtrace.tracesinks.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.ListTraceSinks"
  

UpdateTraceSink

• Metodo: google.devtools.cloudtrace.v2beta1.TracingConfigService.UpdateTraceSink
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudtrace.tracesinks.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.UpdateTraceSink"
  

Metodi che non generano log di controllo

Un metodo potrebbe non generare audit log per uno o più dei seguenti motivi:

• Si tratta di un metodo ad alto volume che comporta costi significativi per la generazione e l'archiviazione dei log.
• Ha un valore di controllo basso.
• Un altro log di controllo o della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano log di controllo:

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