Questa pagina descrive come trovare e utilizzare Cloud Logging per visualizzare e eseguire query sui log per la tua istanza Cloud SQL.
Cloud SQL utilizza Cloud Logging. Consulta la documentazione di Cloud Logging per informazioni complete e consulta le query di esempio di Cloud SQL.
Visualizza i log
Per visualizzare i log per le voci del log dell'istanza Cloud SQL:
Console
-
Nella console Google Cloud, vai alla pagina Cloud Logging.
- Seleziona un progetto Cloud SQL esistente nella parte superiore della pagina.
- 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
i 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'opzione preimpostata o crea un intervallo personalizzato.
gcloud
Utilizza il comando gcloud logging per visualizzare le voci di log. Nell'esempio seguente, sostituisci PROJECT_ID.
Il flag limit è 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 di completamento dell'operazione, indicata nel fuso orario locale.
- Il tipo di operazione.
- Lo stato dell'operazione.
- Un messaggio che descrive il risultato dell'operazione.
Se l'operazione non va a buon fine, puoi utilizzare il messaggio per risolvere il problema.
Per visualizzare un log delle operazioni dell'istanza:
-
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- Fai clic su Operazioni per passare al riquadro che mostra il log delle operazioni.
gcloud 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:
- Nell'elenco dei servizi, trova il tuo servizio.
- Fai clic sul menu a discesa Strumenti.
- Seleziona Log.
Nella sezione Operations > Logging > Logs Explorer della console Google Cloud, 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 della console Google Cloud. Tieni presente che Cloud Run segnala solo i messaggi di errore del proxy di autenticazione Cloud SQL. Utilizza una query come la 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 log di controllo per le tue istanze Cloud SQL:
- Attività di amministrazione: include le operazioni di amministrazione che scrivono metadati o informazioni di configurazione. Non puoi disattivare questi log.
- Accesso ai dati: include le operazioni di amministratore che leggono i metadati o le informazioni di configurazione. Questi log includono anche le operazioni che leggono o scrivono i dati forniti dagli utenti. Per ricevere gli audit log di accesso ai dati, devi attivarli esplicitamente.
- Evento di sistema: identifica le azioni automatiche in Google Cloud che modificano la configurazione delle risorse. Non puoi disattivare questi log.
Per ulteriori informazioni sulla visualizzazione degli audit log Attività di amministrazione, Accesso ai dati ed Evento di sistema, consulta Visualizzare i log.
Prezzi
Per ulteriori informazioni sui prezzi di Cloud Logging, consulta Riepilogo dei prezzi di Cloud Logging.
Risoluzione dei problemi
| Problema | Risoluzione dei problemi |
|---|---|
| La registrazione utilizza molta CPU e memoria nell'istanza Cloud SQL. | La registrazione deve essere ottimizzata.
Il flag |
| Gli audit log non sono stati trovati. | 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 sono presenti nei log. | Vuoi trovare ulteriori 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 è stata avviata, ma non forniscono ulteriori informazioni. Per consentire la registrazione di informazioni dettagliate e che consentono l'identificazione personale (PII) come queste, devi attivare la registrazione dei controlli. |
| I file di log sono difficili da leggere. | Preferisci visualizzare i log come file JSON o di testo.Puoi utilizzare il comando
gcloud logging read
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 attivare i flag pgaudit.
|