Audit logging Trace

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

Nome servizio

Gli audit log di Cloud Trace utilizzano il nome 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 audit log 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 audit log degli Accessi ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type ADMIN_WRITE generano audit log delle Attività di amministrazione.

I metodi API nel seguente elenco contrassegnati con (LRO) sono operazioni a lunga esecuzione (LRO). Questi metodi in genere generano due voci del log di controllo: una all'inizio dell'operazione e un'altra al termine. Per saperne di più, consulta Audit log per le operazioni a lunga esecuzione.
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 audit log sono associati ai metodi appartenenti a google.devtools.cloudtrace.v1.TraceService.

GetTrace

  • Metodo: google.devtools.cloudtrace.v1.TraceService.GetTrace
  • Tipo di audit log: 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 audit log: 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 audit log sono associati ai metodi appartenenti a google.devtools.cloudtrace.v2beta1.TracingConfigService.

CreateTraceSink

  • Metodo: google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink
  • Tipo di audit log: 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 audit log: 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 audit log: 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 audit log: 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 audit log: 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 audit log

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 auditing basso.
  • Un altro audit log o log della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano audit log:

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