Visualizzazione dei log delle istanze

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina descrive come trovare e utilizzare Cloud Logging per visualizzare ed eseguire query sui log della tua istanza Cloud SQL.

Cloud SQL utilizza Cloud Logging. Consulta la documentazione di Cloud Logging per informazioni complete ed esamina le query di esempio di Cloud SQL.

Visualizza i log

Per visualizzare le voci di log della tua istanza Cloud SQL:

Console

1. Nella Google Cloud console, vai alla pagina Cloud Logging.

   Vai a Cloud Logging

2. Seleziona un progetto Cloud SQL esistente nella parte superiore della pagina.
3. In Query Builder, aggiungi quanto segue:
• Risorsa: seleziona Database Cloud SQL. Nella finestra di dialogo, seleziona un' istanza Cloud SQL.
• Nomi dei log: scorri fino alla sezione Cloud SQL e seleziona file di log appropriati per la tua istanza. Ad esempio:
  • cloudsql.googleapis.com/postgres.log
• Gravità: seleziona un livello di log.
• Intervallo di tempo: seleziona un intervallo preimpostato o creane uno personalizzato.

gcloud

Utilizza il gcloud logging comando per visualizzare le voci di log. Nell'esempio riportato di seguito, sostituisci PROJECT_ID. Il limit flag è un parametro facoltativo che indica il numero massimo di voci da restituire.

gcloud logging read "resource.type=cloudsql_database" \
--project=PROJECT-ID \
--limit=10 \
--format=json

Visualizza il log delle operazioni dell'istanza

Puoi visualizzare i log di un'istanza nel riquadro Operazioni. Il riquadro Operazioni registra ogni operazione eseguita sull'istanza con le seguenti informazioni:

• L'ora in cui l'operazione è stata completata, indicata nel tuo fuso orario locale.
• Il tipo di operazione.
• Lo stato dell'operazione.
• Un messaggio che descrive il risultato dell'operazione.

Se l'operazione non riesce, puoi utilizzare il messaggio per risolvere il problema.

Per visualizzare un log delle operazioni dell'istanza:

1. Nella Google Cloud console, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Fai clic su Operazioni per passare al riquadro che mostra il log delle operazioni.

Nota: il log delle operazioni non include le operazioni eseguite utilizzando strumenti di gestione esterni, come il client psql. Nel log delle operazioni vengono visualizzate solo le operazioni di gestione degli utenti e di modifica della password eseguite utilizzando la Google Cloud console, gcloud strumento a riga di comando o l'API Cloud SQL Admin.

Visualizza log applicazione

Le applicazioni che si connettono a Cloud SQL archiviano i log in posizioni diverse.

App Engine (ambiente flessibile)

In Compute > App Engine > Servizi:

• Cerca il tuo servizio nell'elenco dei servizi.
• Fai clic sul menu a discesa Strumenti.
• Seleziona Log.

Nella sezione Operazioni > Logging > Esplora log della Google Cloud console, utilizza la seguente query:

resource.type="gae_app"
resource.labels.module_id="default"

Cloud Run

Visualizza i log nella sezione Esplora log di Cloud Run nella Google Cloud console. Tieni presente che Cloud Run segnala solo i messaggi di errore del proxy di autenticazione Cloud SQL. Utilizza una query simile alla seguente:

resource.type="cloud_run_revision"
resource.labels.service_name="$SERVICE_NAME"
resource.labels.revision_name="$REVISION_NAME"

Proxy di autenticazione Cloud SQL

In Operazioni > Logging > Esplora log, utilizza la seguente query:

log_id("appengine.googleapis.com/cloud-sql-proxy")

Visualizza audit log

Puoi visualizzare i seguenti tipi di audit log per le tue istanze Cloud SQL:

• Attività di amministrazione: include le operazioni di amministrazione che scrivono i metadati o le informazioni di configurazione. Non puoi disattivare questi log.
• Accesso ai dati: include le operazioni di amministrazione che leggono i metadati o le informazioni di configurazione. Questi log includono anche le operazioni che leggono o scrivono i dati forniti dall'utente. Per ricevere gli audit log di accesso ai dati, devi abilitarli esplicitamente.
• Eventi di sistema: identifica le azioni automatizzate in Google Cloud che modificano la configurazione delle risorse. Non puoi disattivare questi log.

Per saperne di più sulla visualizzazione degli audit log di attività di amministrazione, accesso ai dati ed eventi di sistema, consulta Visualizza i log.

Prezzi

Per saperne di più sui prezzi di Cloud Logging, consulta il riepilogo dei prezzi di Cloud Logging.

Risoluzione dei problemi

Problema	Risoluzione dei problemi
Logging utilizza molta CPU e memoria sulla tua istanza Cloud SQL.	È necessario ottimizzare la registrazione. Il flag log_statement può essere impostato su none e il logging_collector flag può essere impostato su off. Se la registrazione continua, potrebbero essere presenti altri flag correlati ai log che possono essere ottimizzati. Puoi modificare l'istanza per modificare questi flag.
Non vengono trovati audit log.	I log di accesso ai dati vengono scritti solo se l'operazione è una chiamata API autenticata guidata dall'utente che crea, modifica o legge i dati creati dall'utente, oppure se l'operazione accede ai file di configurazione o ai metadati delle risorse.
Le informazioni sulle operazioni non vengono trovate nei log.	Vuoi trovare maggiori informazioni su un'operazione. Ad esempio, un utente è stato eliminato, ma non riesci a scoprire chi l'ha fatto. I log mostrano che l' operazione è iniziata, ma non forniscono ulteriori informazioni. Devi abilitare l'audit logging per registrare informazioni dettagliate e di identificazione personale (PII) come queste.
I file di log sono difficili da leggere.	Preferisci visualizzare i log in formato JSON o di testo.Puoi utilizzare il gcloud logging read comando insieme ai comandi di post-elaborazione di Linux per scaricare i log. Per scaricare i log in formato JSON: gcloud logging read \ "resource.type=cloudsql_database \ AND logName=projects/PROJECT_ID \ /logs/cloudsql.googleapis.com%2FLOG_NAME" \ --format json \ --project=PROJECT_ID \ --freshness="1d" \ > downloaded-log.json Per scaricare i log in formato TEXT: gcloud logging read \ "resource.type=cloudsql_database \ AND logName=projects/PROJECT_ID \ /logs/cloudsql.googleapis.com%2FLOG_NAME" \ --format json \ --project=PROJECT_ID \ --freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \ | .textPayload' \ --order=asc > downloaded-log.txt
I log delle query non vengono trovati nei log di PostgreSQL.	Devi abilitare i flag pgaudit. Da un terminale, connettiti al database: gcloud sql connect INSTANCE_NAME Esegui questo comando per creare l'estensione: CREATE EXTENSION pgaudit; Esci dal database ed esegui il comando seguente da un terminale: gcloud sql instances patch INSTANCE_NAME \ --database-flags=cloudsql.enable_pgaudit=on,pgaudit.log=all