Questo documento descrive il logging di controllo per Pub/Sub. I servizi Google Cloud generano audit log che registrano le attività amministrative e di accesso all'interno delle risorse Google Cloud. Per ulteriori informazioni sugli audit log di Cloud, consulta quanto segue:
- Tipi di audit log
- Struttura voce di log log
- Archiviazione e routing degli audit log
- Riepilogo dei prezzi di Cloud Logging
- Attivare gli audit log di accesso ai dati
Note
Pub/Sub al momento non scrive gli audit log di accesso ai dati per le operazioni sui messaggi come pubblicazione, sottoscrizione e conferma.
Nome servizio
Gli audit log di Pub/Sub utilizzano il nome del 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 dal
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.
Metodi che richiedono un'autorizzazione IAM con il valore della proprietà type
di ADMIN_WRITE
generano
Audit log delle attività di amministrazione.
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 a metodi appartenenti a
google.iam.v1.IAMPolicy
.
GetIamPolicy
- Metodo:
google.iam.v1.IAMPolicy.GetIamPolicy
- Tipo di log di controllo: 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 log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.subscriptions.setIamPolicy - ADMIN_WRITE
pubsub.topics.setIamPolicy - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.iam.v1.IAMPolicy.SetIamPolicy"
google.pubsub.v1.Publisher
I seguenti log di controllo sono associati ai metodi appartenenti a
google.pubsub.v1.Publisher
.
CreateTopic
- Metodo:
google.pubsub.v1.Publisher.CreateTopic
- Tipo di log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.topics.create - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Publisher.CreateTopic"
DeleteTopic
- Metodo:
google.pubsub.v1.Publisher.DeleteTopic
- Tipo di log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.topics.delete - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Publisher.DeleteTopic"
DetachSubscription
- Metodo:
google.pubsub.v1.Publisher.DetachSubscription
- Tipo di log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.topics.detachSubscription - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Publisher.DetachSubscription"
GetTopic
- Metodo:
google.pubsub.v1.Publisher.GetTopic
- Tipo di log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.topics.get - DATA_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Publisher.GetTopic"
ListTopicSnapshots
- Metodo:
google.pubsub.v1.Publisher.ListTopicSnapshots
- Tipo di log di controllo: 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 log di controllo: 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 log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.topics.list - DATA_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Publisher.ListTopics"
UpdateTopic
- Metodo:
google.pubsub.v1.Publisher.UpdateTopic
- Tipo di log di controllo: 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 a metodi appartenenti a
google.pubsub.v1.SchemaService
.
CommitSchema
- Metodo:
google.pubsub.v1.SchemaService.CommitSchema
- Tipo di log di controllo: 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 log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.schemas.create - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.SchemaService.CreateSchema"
DeleteSchema
- Metodo:
google.pubsub.v1.SchemaService.DeleteSchema
- Tipo di log di controllo: 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 log di controllo: 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 log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.schemas.get - ADMIN_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.SchemaService.GetSchema"
ListSchemaRevisions
- Metodo:
google.pubsub.v1.SchemaService.ListSchemaRevisions
- Tipo di log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.schemas.listRevisions - ADMIN_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.SchemaService.ListSchemaRevisions"
ListSchemas
- Metodo:
google.pubsub.v1.SchemaService.ListSchemas
- Tipo di log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.schemas.list - ADMIN_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.SchemaService.ListSchemas"
RollbackSchema
- Metodo:
google.pubsub.v1.SchemaService.RollbackSchema
- Tipo di log di controllo: 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 log di controllo: 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.ValidateMessage"
ValidateSchema
- Metodo:
google.pubsub.v1.SchemaService.ValidateSchema
- Tipo di log di controllo: 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 log di controllo sono associati ai metodi appartenenti a
google.pubsub.v1.Subscriber
.
CreateSnapshot
- Metodo:
google.pubsub.v1.Subscriber.CreateSnapshot
- Tipo di log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.snapshots.create - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Subscriber.CreateSnapshot"
CreateSubscription
- Metodo:
google.pubsub.v1.Subscriber.CreateSubscription
- Tipo di log di controllo: 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 log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.snapshots.delete - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Subscriber.DeleteSnapshot"
DeleteSubscription
- Metodo:
google.pubsub.v1.Subscriber.DeleteSubscription
- Tipo di log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.subscriptions.delete - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Subscriber.DeleteSubscription"
GetSnapshot
- Metodo:
google.pubsub.v1.Subscriber.GetSnapshot
- Tipo di log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.snapshots.get - ADMIN_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Subscriber.GetSnapshot"
GetSubscription
- Metodo:
google.pubsub.v1.Subscriber.GetSubscription
- Tipo di log di controllo: 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 log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.snapshots.list - ADMIN_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Subscriber.ListSnapshots"
ListSubscriptions
- Metodo:
google.pubsub.v1.Subscriber.ListSubscriptions
- Tipo di log di controllo: 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 log di controllo: Attività di amministrazione
- Autorizzazioni:
pubsub.subscriptions.update - ADMIN_WRITE
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Subscriber.ModifyPushConfig"
Seek
- Metodo:
google.pubsub.v1.Subscriber.Seek
- Tipo di log di controllo: Accesso ai dati
- Autorizzazioni:
pubsub.snapshots.seek - ADMIN_READ
- Il metodo è un'operazione a lunga esecuzione o in modalità flusso:
N.
- Filtra per questo metodo:
protoPayload.methodName="google.pubsub.v1.Subscriber.Seek"
UpdateSnapshot
- Metodo:
google.pubsub.v1.Subscriber.UpdateSnapshot
- Tipo di log di controllo: 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 log di controllo: 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 Log di controllo 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 producono 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 implica la generazione e l'archiviazione di log significativi costi aggiuntivi.
- Ha un valore di controllo basso.
- La copertura dei metodi è già fornita da un altro log di controllo o di piattaforma.
I seguenti metodi non producono 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