Geração de registros de auditoria da API Data Lineage

Os Registros de auditoria do Cloud para a API Data Lineage no Knowledge Catalog (antigo Dataplex Universal Catalog) permitem registrar operações administrativas e de acesso a dados nos seus recursos de linhagem de dados. Use esses registros para monitorar as mudanças na configuração de linhagem, monitorar atividades em processos, execuções e eventos e verificar a segurança e a conformidade nos seus projetos do Google Cloud . Para mais informações sobre a linhagem de dados, consulte Sobre a linhagem de dados.

Para mais informações sobre os Registros de Auditoria do Cloud, confira:

Nome do serviço

Para ver os registros de auditoria da API Data Lineage, faça o seguinte:

  1. No console do Google Cloud , acesse a página Análise de registros:

    Acessar a Análise de registros

  2. Copie e cole a consulta a seguir no campo Consulta da Análise de registros e clique em Executar consulta.

        protoPayload.serviceName="datalineage.googleapis.com"
      

Métodos por tipo de permissão

Cada permissão do IAM tem uma propriedade type, com um tipo enumerado que pode ser um dos quatro seguintes valores: ADMIN_READ, ADMIN_WRITE, DATA_READ ou DATA_WRITE. Quando você chama um método, a API Data Lineage gera um registro de auditoria com 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. Em geral, esses métodos 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.longrunning.Operations.GetOperation
DATA_READ google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService.GetConfig
google.cloud.datacatalog.lineage.v1.Lineage.BatchSearchLinkProcesses
google.cloud.datacatalog.lineage.v1.Lineage.GetLineageEvent
google.cloud.datacatalog.lineage.v1.Lineage.GetProcess
google.cloud.datacatalog.lineage.v1.Lineage.GetRun
google.cloud.datacatalog.lineage.v1.Lineage.ListLineageEvents
google.cloud.datacatalog.lineage.v1.Lineage.ListProcesses
google.cloud.datacatalog.lineage.v1.Lineage.ListRuns
google.cloud.datacatalog.lineage.v1.Lineage.SearchLineageStreaming
google.cloud.datacatalog.lineage.v1.Lineage.SearchLinks
DATA_WRITE google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService.UpdateConfig
google.cloud.datacatalog.lineage.v1.Lineage.CreateLineageEvent
google.cloud.datacatalog.lineage.v1.Lineage.CreateProcess
google.cloud.datacatalog.lineage.v1.Lineage.CreateRun
google.cloud.datacatalog.lineage.v1.Lineage.DeleteLineageEvent
google.cloud.datacatalog.lineage.v1.Lineage.DeleteProcess (LRO)
google.cloud.datacatalog.lineage.v1.Lineage.DeleteRun (LRO)
google.cloud.datacatalog.lineage.v1.Lineage.ProcessOpenLineageRunEvent
google.cloud.datacatalog.lineage.v1.Lineage.UpdateProcess
google.cloud.datacatalog.lineage.v1.Lineage.UpdateRun

Registros de auditoria da interface da API

Para informações sobre como e quais permissões são avaliadas para cada método, consulte a documentação do Identity and Access Management para a API Data Lineage.

google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService.

GetConfig

  • Método: google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService.GetConfig
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.configs.get - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService.GetConfig"

UpdateConfig

  • Método: google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService.UpdateConfig
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.configs.update - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.configmanagement.v1.ConfigManagementService.UpdateConfig"

google.cloud.datacatalog.lineage.v1.Lineage

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.cloud.datacatalog.lineage.v1.Lineage.

BatchSearchLinkProcesses

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.BatchSearchLinkProcesses
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.locations.searchLinks - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.BatchSearchLinkProcesses"

CreateLineageEvent

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.CreateLineageEvent
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.events.create - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.CreateLineageEvent"

CreateProcess

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.CreateProcess
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.processes.create - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.CreateProcess"

CreateRun

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.CreateRun
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.runs.create - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.CreateRun"

DeleteLineageEvent

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.DeleteLineageEvent
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.events.delete - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.DeleteLineageEvent"

DeleteProcess

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.DeleteProcess
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.processes.delete - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.DeleteProcess"

DeleteRun

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.DeleteRun
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.runs.delete - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.DeleteRun"

GetLineageEvent

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.GetLineageEvent
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.events.get - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.GetLineageEvent"

GetProcess

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.GetProcess
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.processes.get - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.GetProcess"

GetRun

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.GetRun
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.runs.get - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.GetRun"

ListLineageEvents

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.ListLineageEvents
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.events.list - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.ListLineageEvents"

ListProcesses

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.ListProcesses
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.processes.list - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.ListProcesses"

ListRuns

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.ListRuns
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.runs.list - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.ListRuns"

ProcessOpenLineageRunEvent

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.ProcessOpenLineageRunEvent
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.locations.processOpenLineageMessage - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.ProcessOpenLineageRunEvent"

SearchLineageStreaming

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.SearchLineageStreaming
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.locations.searchLinks - DATA_READ
  • O método é uma operação de streaming ou de longa duração: RPC de streaming
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.SearchLineageStreaming"
  • Método: google.cloud.datacatalog.lineage.v1.Lineage.SearchLinks
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.locations.searchLinks - DATA_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.SearchLinks"

UpdateProcess

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.UpdateProcess
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.processes.update - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.UpdateProcess"

UpdateRun

  • Método: google.cloud.datacatalog.lineage.v1.Lineage.UpdateRun
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.runs.update - DATA_WRITE
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.cloud.datacatalog.lineage.v1.Lineage.UpdateRun"

google.longrunning.Operations

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.longrunning.Operations.

GetOperation

  • Método: google.longrunning.Operations.GetOperation
  • Tipo de registro de auditoria: acesso aos dados
  • Permissões:
    • datalineage.operations.get - ADMIN_READ
  • O método é uma operação de streaming ou de longa duração: nenhum
  • Filtrar para este método: protoPayload.methodName="google.longrunning.Operations.GetOperation"

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.longrunning.Operations.CancelOperation
  • google.longrunning.Operations.DeleteOperation
  • google.longrunning.Operations.ListOperations
  • google.longrunning.Operations.WaitOperation