Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Pub/Sub genera audit log che acquisiscono le attività amministrative e di accesso delle risorse Pub/Sub. Alcuni esempi di queste attività includono la creazione di un argomento, l'aggiornamento di un abbonamento o l'eliminazione di un'istantanea. Puoi utilizzare questi log per risolvere i problemi
e garantire la sicurezza della tua infrastruttura di messaggistica.
Di seguito sono riportati alcuni punti importanti da ricordare in merito ai log di controllo in Pub/Sub:
Gli audit log di Pub/Sub utilizzano il nome del servizio pubsub.googleapis.com.
Pub/Sub ha diversi tipi di log. Di seguito sono elencati alcuni esempi:
I log delle attività di amministrazione registrano azioni come la creazione, l'eliminazione o l'aggiornamento di argomenti e iscrizioni.
I log di accesso ai dati registrano azioni come il recupero di un argomento o l'elenco delle iscrizioni.
I log eventi di sistema registrano eventi come la rimozione di abbonamenti inattivi.
Pub/Sub non registra le operazioni sui messaggi come pubblicazione,
sottoscrizione o conferma dei messaggi.
Per ulteriori informazioni sui log di controllo per Pub/Sub, vedi Log di controllo.
Visualizzare i log di controllo di Pub/Sub
Esplora log fornisce un luogo centralizzato per accedere a tutti i dati dei log Google Cloud. Puoi utilizzare Esplora log per visualizzare i log di Pub/Sub.
Ottieni le autorizzazioni necessarie per visualizzare Esplora log.
Seleziona un progetto, una cartella o un'organizzazione Google Cloud esistente.
Per visualizzare tutti gli audit log relativi a Pub/Sub, inserisci la seguente query nel campo editor di query:
protoPayload.serviceName="pubsub.googleapis.com"
Figura 1 Inserisci una query.
Fai clic su Esegui query.
Per visualizzare gli audit log per una risorsa e un tipo di log di controllo specifici, nel riquadro Query Builder:
Per Tutte le risorse, seleziona la Google Cloud risorsa di cui vuoi visualizzare i log di controllo. Ad esempio, seleziona Argomento Cloud Pub/Sub e poi il nome dell'argomento.
In Tutti i nomi dei log, seleziona il tipo di log di controllo che vuoi visualizzare.
Ad esempio:
Per gli audit log delle attività dell'amministratore, seleziona Invio activity.
Per gli audit log degli eventi di sistema, seleziona system_event.
La query viene eseguita automaticamente.
Come utilizzare i log di controllo per risolvere i problemi di Pub/Sub
Determina il problema specifico che stai esaminando. Ecco un elenco di potenziali problemi:
Identifica chi ha creato, eliminato o modificato argomenti, sottoscrizioni, snapshot o schemi.
Monitorare le modifiche alle impostazioni degli argomenti o degli abbonamenti.
Verifica se esiste un argomento o una sottoscrizione e il relativo stato attuale.
Tuttavia, non puoi utilizzare i log di controllo per risolvere i problemi relativi alla pubblicazione e alla consegna dei messaggi. Non troverai log relativi a errori di recapito dei messaggi, duplicazione dei messaggi o problemi di ordinamento dei messaggi. Inoltre, i log di controllo non ti aiuteranno a identificare gli iscritti lenti o i problemi relativi ai riconoscimenti dei messaggi.
Per risolvere i problemi a livello di messaggio, dovrai utilizzare altri strumenti come le metriche di monitoraggio, le code di messaggi non recapitabili e i log delle applicazioni.
In base al problema, crea una query per filtrare i log di controllo.
Ad esempio, per scoprire chi ha eliminato un abbonamento, filtra per
protoPayload.methodName="google.pubsub.v1.Publisher.DeleteSubscription".
Per esaminare un potenziale errore durante la creazione di un abbonamento, filtra per
protoPayload.methodName="google.pubsub.v1.Subscriber.CreateSubscription".
Esamina i timestamp, i principali e i nomi delle risorse nelle voci di log per comprendere la sequenza di eventi e identificare eventuali anomalie.
Per ulteriori informazioni su come creare una query sul log di controllo per Pub/Sub, consulta Log di controllo.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-09 UTC."],[],[],null,["Pub/Sub generates audit logs that capture administrative\nand access activities of Pub/Sub resources. Some examples of\nthese activities include creating a topic, updating a subscription, or\ndeleting a snapshot. You can use these logs for troubleshooting issues\nand ensuring the security of your messaging infrastructure.\n\nHere are some important points to remember regarding audit logs in\nPub/Sub:\n\n- Pub/Sub audit logs use the service name `pubsub.googleapis.com`.\n\n- Pub/Sub has different types of logs. These include the following:\n\n - Admin activity logs record actions like creating, deleting, or updating\n topics and subscriptions.\n\n - Data access logs record actions like retrieving a topic or listing\n subscriptions.\n\n - System event logs record events like removing inactive\n subscriptions.\n\n- Pub/Sub does not log message operations like publishing,\n subscribing, or acknowledging messages.\n\nFor more information about audit logs for\nPub/Sub, see [Audit logging](/pubsub/docs/audit-logging).\n\nView Pub/Sub audit logs\n\n**Logs Explorer** provides a centralized location to access all your log data\nwithin Google Cloud. You can use **Logs Explorer** to view Pub/Sub logs.\n\n1. Get the required permissions to view **Logs Explorer**.\n\n For more information, see [Before you begin](/logging/docs/view/logs-explorer-interface#before-you-begin).\n2. In the Google Cloud console, go to the **Logs Explorer** page.\n\n [Go to Logs Explorer](https://console.cloud.google.com/logs)\n3. Select an existing Google Cloud project, folder, or organization.\n\n4. To display all audit logs related to Pub/Sub, enter the\n following query into the query-editor field:\n\n protoPayload.serviceName=\"pubsub.googleapis.com\"\n\n **Figure 1** Enter a query.\n5. Click **Run query**.\n\n6. To display the audit logs for a specific resource and audit log type,\n in the Query builder pane, do the following:\n\n 1. For **All resources** , select the Google Cloud resource whose\n audit logs you want to see. For example, select **Cloud Pub/Sub Topic** and then\n select the topic name.\n\n 2. For **All log names**, select the audit log type that you want to see.\n\n For example:\n - For Admin activity audit logs, select enter `activity`.\n\n - For System event audit logs, select `system_event`.\n\nThe query runs automatically.\n\nHow to use audit logs to troubleshoot Pub/Sub issues\n\n1. Determine the specific problem that you're investigating. Here is a list of\n potential issues:\n\n - Identify who created, deleted, or modified topics, subscriptions, snapshots,\n or schemas.\n\n - Track changes to topic or subscription settings.\n\n - Verify if a topic or subscription exists and its current status.\n\n However, you cannot use audit logs to troubleshoot issues related to message\n publishing and delivery. You won't find logs for message delivery failures,\n message duplication, or message ordering problems. Audit logs also won't help\n you identify slow subscribers or issues with message acknowledgments.\n For troubleshooting message-level issues, you'll need to rely on other tools\n like monitoring metrics, dead-letter queues, and application logs.\n2. Based on the issue, construct a query to filter the audit logs.\n For example, to find out who deleted a subscription, filter by\n `protoPayload.methodName=\"google.pubsub.v1.Publisher.DeleteSubscription\"`.\n\n To investigate a potential error with creating a subscription, filter by\n `protoPayload.methodName=\"google.pubsub.v1.Subscriber.CreateSubscription\"`.\n3. Examine the timestamps, principals, and resource names in the log entries\n to understand the sequence of events and identify any anomalies.\n\nFor more information on how to construct an audit log query for\nPub/Sub, see [Audit logging](/pubsub/docs/audit-logging)."]]
