Questa pagina è stata tradotta dall'API Cloud Translation.

Scrivi voci di log ed esegui query con gcloud CLI

Questo documento presenta alcune delle funzionalità di Cloud Logging e mostra come:

Scrivi le voci di log utilizzando Google Cloud CLI.
Elenca le voci di log utilizzando gcloud CLI.
Elenca le voci di log utilizzando l'API Logging.
Visualizza ed esegui query sulle voci di log utilizzando Esplora log.

Prima di iniziare

Per completare questa guida rapida, devi avere un progetto Google Cloud con fatturazione abilitata. Se non hai un progetto Google Cloud o se non hai abilitato la fatturazione per il tuo progetto Google Cloud, segui questi passaggi:

Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Per iniziare

gcloud CLI ha un gruppo di comandi, gcloud logging, che forniscono un'interfaccia a riga di comando per l'API Cloud Logging.

In questa guida rapida puoi utilizzare l'ambiente Cloud Shell o un'istanza di macchina virtuale (VM) Compute Engine per i comandi gcloud CLI. gcloud CLI è preinstallato nell'ambiente Cloud Shell.

Cloud Shell

Verifica che gcloud CLI sia configurato per utilizzare il progetto Google Cloud corretto:

Nella console Google Cloud, fai clic su Attiva Cloud Shell:

Cloud Shell si apre in una finestra e mostra un messaggio di benvenuto. Il messaggio di benvenuto mostra l'eco dell'ID progetto configurato:
Se vuoi utilizzare un progetto Google Cloud diverso da quello elencato nel messaggio di benvenuto, esegui questo comando dopo aver sostituito PROJECT_ID con il tuo ID progetto:
```
   gcloud config set project PROJECT_ID
   
```
Per ottenere l'ID progetto, consulta Identificazione dei progetti.

Istanza VM

Per creare un'istanza VM di Compute Engine nella console Google Cloud, segui questi passaggi:

Nella console Google Cloud, seleziona Compute Engine e seleziona Istanze VM.
Seleziona Crea istanza.
In Identità e accesso API in Ambiti di accesso, seleziona Imposta l'accesso per ogni API.
Scorri le API fino a trovare l'API Stackdriver Logging. Attiva/disattiva l'accesso Completo.
Lascia invariati i valori predefiniti di tutte le altre impostazioni e fai clic su Crea. L'istanza VM è pronta per essere utilizzata.
Fai clic su SSH per connetterti alla shell dell'istanza VM. Dopo un istante, si apre una shell di Debian GNU/Linux in una finestra che mostra un messaggio di benvenuto.
Esegui questo comando per verificare che gcloud CLI sia configurato per il tuo progetto Compute Engine:
```
gcloud config list
```
Se vuoi utilizzare un altro progetto Google Cloud, esegui questo comando dopo aver sostituito PROJECT_ID con il tuo ID progetto:
```
  gcloud config set project PROJECT_ID
  
```
Per ottenere l'ID progetto, consulta Identificazione dei progetti.

Scrivi le voci di log utilizzando gcloud CLI

Logging supporta le voci di log con dati strutturati e non strutturati. I dati strutturati sono costituiti da una struttura di dati JSON, ad esempio {"weather": "partly cloudy"}. I dati non strutturati sono una stringa di caratteri, ad esempio "A simple entry". Nei passaggi successivi, utilizzerai gcloud CLI per scrivere una voce di log con dati non strutturati e una voce di log con dati strutturati:

Scrivi una voce di log con dati non strutturati nel log my-test-log:
```
gcloud logging write my-test-log "A simple entry."
```
Al termine del comando, viene visualizzato il messaggio: Created log entry.
Scrivi una voce di log con dati strutturati nel log my-test-log:
```
gcloud logging write --payload-type=json my-test-log '{ "message": "My second entry", "weather": "partly cloudy"}'
```
Quando scrivi una voce di log con dati strutturati, devi includere --payload-type=json. Se ometti questo campo, Logging interpreta il payload come dati non strutturati.

Se il log my-test-log non esiste, Logging lo crea quando viene ricevuta la voce di log.

Elenca le voci di log utilizzando gcloud CLI

Puoi recuperare le voci di log da Logging e visualizzarle utilizzando gcloud CLI. Ad esempio, per recuperare e visualizzare le voci dei log con un tipo di risorsa global, esegui questo comando:

gcloud logging read "resource.type=global"

Il comando restituisce un risultato simile al seguente:

---
insertId: jpj9zjf73t1mn
jsonPayload:
  message: My second entry
  weather: partly cloudy
logName: projects/myloggingproject/logs/my-test-log
receiveTimestamp: '2018-11-01T18:39:31.114507977Z'
resource:
  labels:
    project_id: myloggingproject
  type: global
timestamp: '2018-11-01T18:39:31.114507977Z'
---
insertId: vd4m1if7h7u1a
logName: projects/myloggingproject/logs/my-test-log
receiveTimestamp: '2018-11-01T18:39:19.718100792Z'
resource:
  labels:
    project_id: myloggingproject
  type: global
textPayload: A simple entry
timestamp: '2018-11-01T18:39:19.718100792Z'

Elenca le voci di log utilizzando Explorer API

Per eseguire i metodi dell'API Logging senza scrivere codice, consulta Utilizzo di Explorer API. Per leggere un elenco di voci di log da Logging, segui questi passaggi:

Vai alla pagina di riferimento dell'API per il metodo API entries.list:

Vai alla pagina dell'API entry.list

Configura ed esegui il comando API:

Sostituisci PROJECT_ID nel seguente testo:

"resourceNames": [
"projects/PROJECT_ID"
],
"filter": "resource.type=global",
"orderBy": "timestamp desc"

Copia il testo aggiornato dal passaggio precedente e incollalo nel campo Corpo della richiesta di Explorer API.
Fai clic su Execute (Esegui).

Il metodo restituisce una risposta simile alla seguente:

{
  "entries": [
    {
      "textPayload": "A simple entry",
      "insertId": "vd4m1if7h7u1a",
      "resource": {
        "type": "global",
        "labels": {
          "project_id": "myloggingproject"
        }
      },
      "timestamp": "2018-11-01T18:39:19.718100792Z",
      "logName": "projects/myloggingproject/logs/my-test-log",
      "receiveTimestamp": "2018-11-01T18:39:19.718100792Z"
    },
    {
      "insertId": "jpj9zjf73t1mn",
      "jsonPayload": {
        "message": "My second entry",
        "weather": "partly cloudy"
      },
      "resource": {
        "type": "global",
        "labels": {
          "project_id": "myloggingproject"
        }
      },
      "timestamp": "2018-11-01T18:39:31.114507977Z",
      "logName": "projects/myloggingproject/logs/my-test-log",
      "receiveTimestamp": "2018-11-01T18:39:31.114507977Z"
    }
  ]
}

Visualizza le voci di log in Esplora log

Per visualizzare le voci di log nella console Google Cloud, puoi utilizzare Esplora log. La maggior parte dei progetti Google Cloud archivia un numero elevato di log; puoi selezionare determinate voci di log scrivendo una query.

Per visualizzare le voci di log che hai scritto utilizzando Esplora log:

Nel pannello di navigazione della console Google Cloud, seleziona Logging, quindi Esplora log:
Vai a Esplora log

Assicurati che il tuo progetto Google Cloud sia selezionato nella barra di navigazione di Google Cloud. Se necessario, utilizza l'elenco a discesa Progetto Google Cloud per selezionare il progetto Google Cloud.
Nel menu Risorsa, seleziona Globale.

Se non vedi l'opzione di menu Globale o se non vedi le voci di log, attendi qualche minuto e aggiorna la pagina. Logging potrebbe impiegare qualche minuto per ricevere le voci di log.
Per visualizzare i dettagli di una voce di log, fai clic sul relativo menu.

I dati della prima voce di log sono archiviati in textPayload. La seconda voce di log contiene dati strutturati archiviati in jsonPayload. Il payload strutturato contiene le chiavi message e weather.

Nota: quando message è una chiave per una voce di log strutturata, Logging la utilizza come riepilogo della voce di log quando la voce non è espansa.

Per informazioni sul formato dei dati delle voci di log, consulta il tipo LogEntry.

Esegui query sulle voci di log in Esplora log

Puoi eseguire query sulle voci di log utilizzando l'editor query e, con i log strutturati, per chiave e valore. Ad esempio, per visualizzare tutte le voci di log contenenti il testo simple, segui questi passaggi:

Nel pannello di navigazione della console Google Cloud, seleziona Logging, quindi Esplora log:
Vai a Esplora log
Nel menu Risorsa, seleziona Globale.
Nell'Editor query, inserisci la stringa simple tra virgolette. La visualizzazione dei log mostra solo la voce di log A simple entry..
Dopo aver visualizzato il log, rimuovi la stringa di query aggiunta e fai clic su Esegui query. Entrambe le voci di log vengono visualizzate di nuovo sul display.

Per visualizzare tutte le voci di log con dati strutturati che hanno una chiave di weather in cui il campo value contiene partly, procedi nel seguente modo:

Editor query contiene la riga resource.type="global". Inserisci questo comando:
```
jsonPayload.weather:partly
```
Fai clic su Esegui query. Il risultato è la singola voce di log My second entry.

Esplora log offre anche le query salvate, suggerite e recenti. Per maggiori informazioni sulle query, consulta Creare query in Esplora log.

Per query di esempio, consulta Query di esempio utilizzando Esplora log.

Risoluzione dei problemi

Gli errori tipografici e i nomi dei campi sconosciuti generano il completamento dei comandi dell'interfaccia a riga di comando gcloud con messaggi di argomento non valido. Ad esempio, se dimentichi il punto in resource.type, viene visualizzato l'errore:
```
 ERROR: (gcloud.logging.read) INVALID_ARGUMENT: Field not found: 'resourcetype'.
```
Se a Cloud Logging non sono state concesse le autorizzazioni di accesso necessarie, i comandi gcloud CLI vengono completati dai messaggi Autorizzazione negata. Ad esempio, se un'istanza VM di Compute Engine è configurata con le impostazioni API predefinite, il comando list viene completato con un errore di autorizzazione negata:
```
 ERROR: (gcloud.logging.read) PERMISSION_DENIED: Request had insufficient authentication scopes.
```
Per correggere questa condizione, modifica le autorizzazioni dell'istanza VM di Compute Engine per concedere l'autorizzazione di lettura a Cloud Logging:
1. Vai alla pagina Dettagli istanza VM dell'istanza VM. Fai clic su Interrompi. Il completamento di questa azione potrebbe richiedere un paio di minuti.
2. Per modificare la configurazione, fai clic su Modifica.
3. Cerca l'intestazione Ambiti di accesso API Cloud e fai clic su Dettagli per visualizzare le impostazioni per ciascuna API. Cambia la voce dall'API Cloud Logging in Full. Fai clic su Salva.
4. Per riavviare l'istanza VM, fai clic su Avvia. Dopo qualche istante, la VM è pronta per essere utilizzata.
Quando Explorer API non riesce a completare il comando o richiede un'autorizzazione aggiuntiva, viene visualizzato un messaggio o un codice di errore:
- Codice di risposta 200 e nessuna voce: se viene visualizzato il messaggio nextPageToken, significa che Explorer API non ha avuto il tempo di completare la ricerca. Aggiungi pageToken alla richiesta, imposta il valore in modo che corrisponda a quello fornito con la chiave nextPageToken e riprova a eseguire il comando.
- Codice di risposta 400: il valore della query non è valido. Ad esempio, se digiti erroneamente global come gloobal, il messaggio è Unsupported resource type: gloobal.
- Codice di risposta 404: l'ID progetto non è valido. Controlla l'ortografia dell'identificatore del progetto.
- È possibile che ti venga chiesto di accedere al tuo Account Google e consentire a Explorer API di accedere al tuo account.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi:

(Facoltativo) Per eliminare le voci di log create, esegui il seguente comando gcloud:
```
gcloud logging logs delete my-test-log
```
Se non elimini le voci di log, scadono e vengono rimosse. Per informazioni sulla conservazione, consulta Quote e limiti.

Passaggi successivi

Per maggiori dettagli sull'interfaccia a riga di comando di Logging, leggi le pagine di riferimento per il gruppo di comandi gcloud logging.
Per la documentazione sull'API Logging, consulta API Cloud Logging.
Per maggiori dettagli su Esplora log, consulta Utilizzo di Esplora log.
Per scoprire come raccogliere le voci di log dalle istanze VM in Logging, consulta Agenti di osservabilità di Google Cloud.