Audit logging di Pub/Sub

Questo documento descrive l'audit logging per Pub/Sub. 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:

Note

Al momento Pub/Sub non scrive audit log di accesso ai dati per le operazioni sui messaggi, come Pubblica, Sottoscrivi e Riconosci.

Nome servizio

Gli audit log di Pub/Sub utilizzano il nome servizio pubsub.googleapis.com. Filtra per questo servizio: 

    protoPayload.serviceName="pubsub.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, Pub/Sub 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.iam.v1.IAMPolicy.GetIamPolicy
google.pubsub.v1.SchemaService.GetSchema
google.pubsub.v1.SchemaService.ListSchemaRevisions
google.pubsub.v1.SchemaService.ListSchemas
google.pubsub.v1.SchemaService.ValidateMessage
google.pubsub.v1.SchemaService.ValidateSchema
google.pubsub.v1.Subscriber.GetSnapshot
google.pubsub.v1.Subscriber.ListSnapshots
google.pubsub.v1.Subscriber.Seek
ADMIN_WRITE google.iam.v1.IAMPolicy.SetIamPolicy
google.pubsub.v1.Publisher.CreateTopic
google.pubsub.v1.Publisher.DeleteTopic
google.pubsub.v1.Publisher.DetachSubscription
google.pubsub.v1.Publisher.UpdateTopic
google.pubsub.v1.SchemaService.CommitSchema
google.pubsub.v1.SchemaService.CreateSchema
google.pubsub.v1.SchemaService.DeleteSchema
google.pubsub.v1.SchemaService.DeleteSchemaRevision
google.pubsub.v1.SchemaService.RollbackSchema
google.pubsub.v1.Subscriber.CreateSnapshot
google.pubsub.v1.Subscriber.CreateSubscription
google.pubsub.v1.Subscriber.DeleteSnapshot
google.pubsub.v1.Subscriber.DeleteSubscription
google.pubsub.v1.Subscriber.ModifyPushConfig
google.pubsub.v1.Subscriber.UpdateSnapshot
google.pubsub.v1.Subscriber.UpdateSubscription
DATA_READ google.pubsub.v1.Publisher.GetTopic
google.pubsub.v1.Publisher.ListTopicSnapshots
google.pubsub.v1.Publisher.ListTopicSubscriptions
google.pubsub.v1.Publisher.ListTopics
google.pubsub.v1.Subscriber.GetSubscription
google.pubsub.v1.Subscriber.ListSubscriptions

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 Pub/Sub.

google.iam.v1.IAMPolicy

I seguenti audit log sono associati ai metodi appartenenti a google.iam.v1.IAMPolicy.

GetIamPolicy

  • Metodo: google.iam.v1.IAMPolicy.GetIamPolicy
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.subscriptions.getIamPolicy - ADMIN_READ
    • pubsub.topics.getIamPolicy - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.iam.v1.IAMPolicy.GetIamPolicy"

SetIamPolicy

  • Metodo: google.iam.v1.IAMPolicy.SetIamPolicy
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.subscriptions.setIamPolicy - ADMIN_WRITE
    • pubsub.topics.setIamPolicy - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.iam.v1.IAMPolicy.SetIamPolicy"

google.pubsub.v1.Publisher

I seguenti audit log sono associati ai metodi appartenenti a google.pubsub.v1.Publisher.

CreateTopic

  • Metodo: google.pubsub.v1.Publisher.CreateTopic
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.topics.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.CreateTopic"

DeleteTopic

  • Metodo: google.pubsub.v1.Publisher.DeleteTopic
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.topics.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.DeleteTopic"

DetachSubscription

  • Metodo: google.pubsub.v1.Publisher.DetachSubscription
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.topics.detachSubscription - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.DetachSubscription"

GetTopic

  • Metodo: google.pubsub.v1.Publisher.GetTopic
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.topics.get - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.GetTopic"

ListTopicSnapshots

  • Metodo: google.pubsub.v1.Publisher.ListTopicSnapshots
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.topics.get - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.ListTopicSnapshots"

ListTopicSubscriptions

  • Metodo: google.pubsub.v1.Publisher.ListTopicSubscriptions
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.topics.get - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.ListTopicSubscriptions"

ListTopics

  • Metodo: google.pubsub.v1.Publisher.ListTopics
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.topics.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.ListTopics"

UpdateTopic

  • Metodo: google.pubsub.v1.Publisher.UpdateTopic
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.topics.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Publisher.UpdateTopic"

google.pubsub.v1.SchemaService

I seguenti audit log sono associati ai metodi appartenenti a google.pubsub.v1.SchemaService.

CommitSchema

  • Metodo: google.pubsub.v1.SchemaService.CommitSchema
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.schemas.commit - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.CommitSchema"

CreateSchema

  • Metodo: google.pubsub.v1.SchemaService.CreateSchema
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.schemas.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.CreateSchema"

DeleteSchema

  • Metodo: google.pubsub.v1.SchemaService.DeleteSchema
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.schemas.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.DeleteSchema"

DeleteSchemaRevision

  • Metodo: google.pubsub.v1.SchemaService.DeleteSchemaRevision
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.schemas.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.DeleteSchemaRevision"

GetSchema

  • Metodo: google.pubsub.v1.SchemaService.GetSchema
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.schemas.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.GetSchema"

ListSchemaRevisions

  • Metodo: google.pubsub.v1.SchemaService.ListSchemaRevisions
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.schemas.listRevisions - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.ListSchemaRevisions"

ListSchemas

  • Metodo: google.pubsub.v1.SchemaService.ListSchemas
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.schemas.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.ListSchemas"

RollbackSchema

  • Metodo: google.pubsub.v1.SchemaService.RollbackSchema
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.schemas.rollback - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.RollbackSchema"

ValidateMessage

  • Metodo: google.pubsub.v1.SchemaService.ValidateMessage
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.schemas.get - ADMIN_READ
    • pubsub.schemas.validate - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.ValidateMessage"

ValidateSchema

  • Metodo: google.pubsub.v1.SchemaService.ValidateSchema
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.schemas.validate - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.SchemaService.ValidateSchema"

google.pubsub.v1.Subscriber

I seguenti audit log sono associati ai metodi appartenenti a google.pubsub.v1.Subscriber.

CreateSnapshot

  • Metodo: google.pubsub.v1.Subscriber.CreateSnapshot
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.snapshots.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.CreateSnapshot"

CreateSubscription

  • Metodo: google.pubsub.v1.Subscriber.CreateSubscription
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.subscriptions.create - ADMIN_WRITE
    • pubsub.topics.attachSubscription - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.CreateSubscription"

DeleteSnapshot

  • Metodo: google.pubsub.v1.Subscriber.DeleteSnapshot
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.snapshots.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.DeleteSnapshot"

DeleteSubscription

  • Metodo: google.pubsub.v1.Subscriber.DeleteSubscription
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.subscriptions.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.DeleteSubscription"

GetSnapshot

  • Metodo: google.pubsub.v1.Subscriber.GetSnapshot
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.snapshots.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.GetSnapshot"

GetSubscription

  • Metodo: google.pubsub.v1.Subscriber.GetSubscription
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.subscriptions.get - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.GetSubscription"

ListSnapshots

  • Metodo: google.pubsub.v1.Subscriber.ListSnapshots
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.snapshots.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.ListSnapshots"

ListSubscriptions

  • Metodo: google.pubsub.v1.Subscriber.ListSubscriptions
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.subscriptions.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.ListSubscriptions"

ModifyPushConfig

  • Metodo: google.pubsub.v1.Subscriber.ModifyPushConfig
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.subscriptions.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.ModifyPushConfig"

Seek

  • Metodo: google.pubsub.v1.Subscriber.Seek
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • pubsub.snapshots.seek - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.Seek"

UpdateSnapshot

  • Metodo: google.pubsub.v1.Subscriber.UpdateSnapshot
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.snapshots.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.UpdateSnapshot"

UpdateSubscription

  • Metodo: google.pubsub.v1.Subscriber.UpdateSubscription
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • pubsub.subscriptions.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.pubsub.v1.Subscriber.UpdateSubscription"

Eventi di sistema

Gli audit log degli eventi di sistema vengono generati dai sistemi Google Cloud, non dall'azione diretta dell'utente. Per ulteriori informazioni, vedi audit log degli eventi di sistema.

Nome metodo Filtra per questo evento Note
Internal.DeletedProjectRemoveSubscription protoPayload.methodName="Internal.DeletedProjectRemoveSubscription"
Internal.DeletedProjectRemoveTopic protoPayload.methodName="Internal.DeletedProjectRemoveTopic"
Subscriber.InternalExpireInactiveSnapshot protoPayload.methodName="Subscriber.InternalExpireInactiveSnapshot"
Subscriber.InternalExpireInactiveSubscription protoPayload.methodName="Subscriber.InternalExpireInactiveSubscription"

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.pubsub.v1.Publisher.Publish
  • google.pubsub.v1.Subscriber.Acknowledge
  • google.pubsub.v1.Subscriber.ModifyAckDeadline
  • google.pubsub.v1.Subscriber.Pull
  • google.pubsub.v1.Subscriber.StreamingPull
  • tech.pubsub.PublisherService.CreateTopic
  • tech.pubsub.PublisherService.DeleteTopic
  • tech.pubsub.PublisherService.GetTopic
  • tech.pubsub.PublisherService.ListTopics
  • tech.pubsub.PublisherService.Publish
  • tech.pubsub.PublisherService.PublishBatch
  • tech.pubsub.SubscriberService.Acknowledge
  • tech.pubsub.SubscriberService.CreateSubscription
  • tech.pubsub.SubscriberService.DeleteSubscription
  • tech.pubsub.SubscriberService.GetSubscription
  • tech.pubsub.SubscriberService.ListSubscriptions
  • tech.pubsub.SubscriberService.ModifyAckDeadline
  • tech.pubsub.SubscriberService.ModifyPushConfig
  • tech.pubsub.SubscriberService.Pull
  • tech.pubsub.SubscriberService.PullBatch