Gerar registros de auditoria do Trace

Neste documento, descrevemos a geração de registros de auditoria do Cloud Trace.Os serviços do Google Cloud geram registros de auditoria das atividades administrativas e de acesso nos recursos do Google Cloud . Para mais informações sobre os Registros de auditoria do Cloud, consulte:

Nome do serviço

Os registros de auditoria do Cloud Trace usam o nome de serviço cloudtrace.googleapis.com. Filtrar por este serviço: 

    protoPayload.serviceName="cloudtrace.googleapis.com"

Métodos por tipo de permissão

Cada permissão do IAM tem uma propriedade type, que tem o valor de um tipo enumerado que pode ser um dos quatro valores: ADMIN_READ, ADMIN_WRITE, DATA_READ ou DATA_WRITE. Quando você chama um método, o Cloud Trace gera um registro de auditoria com uma categoria dependente da propriedade type da permissão necessária para executar o método. Métodos que exigem uma permissão do IAM com o valor da propriedade type de DATA_READ, DATA_WRITE ou ADMIN_READ geram registros de auditoria de acesso aos dados. Métodos que exigem uma permissão do IAM com o valor da propriedade type de ADMIN_WRITE geram registros de auditoria de Atividade do administrador.

Os métodos de API na lista a seguir marcados com (LRO) são operações de longa duração (LROs). Esses métodos geralmente geram duas entradas de registro de auditoria: uma quando a operação começa e outra quando ela termina. Para mais informações, consulte Registros de auditoria para operações de longa duração.
Tipo de permissão Métodos
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

Registros de auditoria da interface da API

Para saber como e quais permissões são avaliadas para cada método, consulte a documentação do Identity and Access Management para o Cloud Trace.

google.devtools.cloudtrace.v1.TraceService

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.devtools.cloudtrace.v1.TraceService.

GetTrace

  • Método: google.devtools.cloudtrace.v1.TraceService.GetTrace
  • Tipo de registro de auditoria: acesso a dados
  • Permissões:
    • cloudtrace.traces.get - DATA_READ
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.devtools.cloudtrace.v1.TraceService.GetTrace"

ListTraces

  • Método: google.devtools.cloudtrace.v1.TraceService.ListTraces
  • Tipo de registro de auditoria: acesso a dados
  • Permissões:
    • cloudtrace.traces.list - DATA_READ
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.devtools.cloudtrace.v1.TraceService.ListTraces"

google.devtools.cloudtrace.v2beta1.TracingConfigService

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.devtools.cloudtrace.v2beta1.TracingConfigService.

CreateTraceSink

  • Método: google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • cloudtrace.tracesinks.create - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.CreateTraceSink"

DeleteTraceSink

  • Método: google.devtools.cloudtrace.v2beta1.TracingConfigService.DeleteTraceSink
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • cloudtrace.tracesinks.delete - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.DeleteTraceSink"

GetTraceSink

  • Método: google.devtools.cloudtrace.v2beta1.TracingConfigService.GetTraceSink
  • Tipo de registro de auditoria: acesso a dados
  • Permissões:
    • cloudtrace.tracesinks.get - ADMIN_READ
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.GetTraceSink"

ListTraceSinks

  • Método: google.devtools.cloudtrace.v2beta1.TracingConfigService.ListTraceSinks
  • Tipo de registro de auditoria: acesso a dados
  • Permissões:
    • cloudtrace.tracesinks.list - ADMIN_READ
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.ListTraceSinks"

UpdateTraceSink

  • Método: google.devtools.cloudtrace.v2beta1.TracingConfigService.UpdateTraceSink
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • cloudtrace.tracesinks.update - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.devtools.cloudtrace.v2beta1.TracingConfigService.UpdateTraceSink"

Métodos que não geram registros de auditoria

Um método pode não gerar registros de auditoria por um ou mais dos seguintes motivos:

  • É um método de alto volume que envolve geração de registros significativos e custos de armazenamento.
  • Tem pouco valor para a auditoria.
  • Outro registro de auditoria ou plataforma já oferece cobertura do método.

Os métodos abaixo não geram registros de auditoria:

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