Integrazione con Cloud Logging

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questo documento descrive come associare una traccia a un LogEntry di Cloud Logging.

Associazione di una traccia a una voce di log

Quando utilizzi le librerie client di Trace o quando usi la libreria OpenCensus per Python o per Java, associ una traccia a una voce di log impostando il campo trace nell'oggetto LogEntry.

Il campo trace deve essere impostato su una stringa con il seguente formato:

   projects/PROJECT_ID/traces/TRACE_ID

dove PROJECT_ID è il tuo ID progetto Google Cloud e TRACE_ID è l'identificatore della traccia

Per associare uno span a una voce di log quando utilizzi l'API REST, imposta il campo span_id nell'oggetto LogEntry sulla codifica esadecimale di 16 caratteri dell'ID span. Se utilizzi l'API gRPC, imposta il campo spanId. Ad esempio, per associare un intervallo a un ID 74 a una voce di log quando utilizzi l'API REST, imposta span_id su 000000000000004a.

Per indicare che stai utilizzando il campionamento della traccia e che la traccia è stata campionata per l'archiviazione al momento della scrittura della voce di log, imposta il campo trace_sampled nell'oggetto LogEntry quando utilizzi l'API REST. Se utilizzi l'API gRPC, imposta il campo traceSampled. Quando utilizzi il campionamento delle tracce, è possibile che venga creata una voce di log quando la traccia stessa non viene acquisita.

Per scoprire di più, consulta le seguenti risorse:

Visualizzazione dei log

Puoi visualizzare la voce di log per una traccia accanto al grafico a cascata o in Esplora log. Quando utilizzi Esplora log, questo viene automaticamente limitato all'intervallo di timestamp della traccia. Se non ci sono voci di log da visualizzare, in Esplora log viene visualizzato il messaggio No entries found matching current filter.

Nel riquadro Dettagli traccia, per visualizzare la voce di log per la traccia, procedi in uno dei seguenti modi:

  • Per visualizzare le voci del log di traccia accanto al grafico a cascata, vai al grafico e fai clic su Mostra log. Quando l'opzione Mostra log non è visualizzata, non sono disponibili voci di log.

  • Per visualizzare la voce di log in Esplora log, fai clic su Visualizza accanto all'etichetta Log nella sezione Dettagli. Tieni presente che, quando hai una traccia di Cloud Load Balancing, fai clic su Visualizza accanto all'etichetta Log VM.

Per ulteriori informazioni sulla visualizzazione delle voci di log in Cloud Logging, consulta Utilizzo di Esplora log.

Autorizzazioni di visualizzazione dei log

Per visualizzare qualsiasi voce di log, devi disporre dell'autorizzazione logging.logEntries.list nel progetto. Questa autorizzazione è fornita dai ruoli Visualizzatore log e Visualizzatore progetto per Identity and Access Management (IAM).

Per visualizzare i log delle istanze VM, devi avere l'autorizzazione compute.instances.get nel progetto. Questa autorizzazione è fornita dai ruoli IAM Visualizzatore rete Compute Engine e Visualizzatore progetto.