Questo documento descrive come abilitare, generare e visualizzare i log di Cloud Logging per un job batch.
Puoi utilizzare i log per ottenere informazioni utili per l'analisi dei job. Ad esempio, i log possono aiutarti a eseguire il debug dei job non riusciti.
In particolare, i log vengono generati solo dopo l'avvio di un job e solo se il logging è stato abilitato per il job. Se devi analizzare un job senza log, visualizza gli eventi di stato.
Prima di iniziare
- Se non hai mai utilizzato Batch, consulta la Guida introduttiva all'utilizzo di Batch e abilita Batch completando i prerequisiti per progetti e utenti.
-
Per ottenere le autorizzazioni necessarie per analizzare un job utilizzando i log, chiedi all'amministratore di concederti i seguenti ruoli IAM:
-
Per creare un job:
-
Editor job batch (
roles/batch.jobsEditor
) sul progetto -
Utente account di servizio (
roles/iam.serviceAccountUser
) nell'account di servizio del job, che per impostazione predefinita è l'account di servizio Compute Engine predefinito
-
Editor job batch (
-
Per visualizzare i log:
Visualizzatore log (
roles/logging.viewer
) sul progetto
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
-
Per creare un job:
Abilita il logging per un job
Per consentire la generazione dei log per un job, abilita i log di Cloud Logging quando crei il job:
- Se crei un job utilizzando la console Google Cloud, i log di Cloud Logging sono sempre abilitati.
Se crei un job utilizzando gcloud CLI o l'API Batch, i log di Cloud Logging sono disabilitati per impostazione predefinita. Per abilitare i log da Cloud Logging, includi la seguente configurazione per il campo
logsPolicy
durante la creazione del job:{ ... "logsPolicy": { "destination": "CLOUD_LOGGING" } ... }
Scrivere e generare log per un job
Quando i log di Cloud Logging sono abilitati per un job, Cloud Logging genera automaticamente uno qualsiasi dei log scritti per il job. In particolare, i job batch possono avere i seguenti tipi di log:
Log agente (
batch_agent_logs
): log per le attività dall'agente di servizio Batch.Batch scrive automaticamente i log degli agenti per ogni job in cui è abilitato il logging.
log delle attività (
batch_task_logs
): registra tutti i dati per i quali hai configurato gli elementi eseguibili di un job per la scrittura nel flusso di output standard (stdout
) o nel flusso di errori standard (stderr
).Facoltativamente, puoi scrivere log delle attività per ogni job che ha abilitato il logging.
Visualizza i log per un job
Puoi visualizzare i log di un job utilizzando la console Google Cloud, gcloud CLI, l'API Logging, Go, Java, Python o C++.
Console
Per visualizzare i log di un job utilizzando la console Google Cloud:
Nella console Google Cloud, vai alla pagina Elenco job.
Nella colonna Nome job, fai clic sul nome di un job. Si apre la pagina Dettagli job.
Fai clic sulla scheda Log. Batch visualizza tutti i log associati al job.
(Facoltativo) Per filtrare i log, esegui una delle seguenti operazioni:
Inserisci un filtro nel campo Filtro .
Nell'elenco Gravità, seleziona una gravità.
Fai clic su creare una query in Esplora log utilizzando i parametri di filtro batch.
Visualizza in Esplora log per
gcloud
Per visualizzare i log utilizzando gcloud CLI, utilizza il comando gcloud logging read
:
gcloud logging read "QUERY"
dove QUERY
è una
query per i log batch che contiene
parametri di filtro batch.
API
Per visualizzare i log utilizzando l'API Logging, utilizza il metodo entries.list
:
POST https://logging.googleapis.com/v2/entries:list
{
"resourceNames": [
"projects/PROJECT_ID"
],
"filter": "QUERY"
"orderBy": "timestamp desc"
}
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto del progetto.QUERY
: una query per i log batch che contiene i parametri di filtro batch.
Go
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Batch Go.
Per eseguire l'autenticazione in Batch, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Batch Java.
Per eseguire l'autenticazione in Batch, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Batch Python.
Per eseguire l'autenticazione in Batch, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Batch C++.
Per eseguire l'autenticazione in Batch, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Filtra log batch
Puoi filtrare i log batch scrivendo una query
che includa uno o più dei seguenti parametri di filtro e zero o più
operatori booleani (AND
, OR
e NOT
).
Per filtrare in base ai log di un job specifico, specifica l'ID univoco (UID) del job:
labels.job_uid=JOB_UID
dove
JOB_UID
è l'UID del job. Per ottenere l'UID di un job, visualizza i dettagli del job.Per filtrare in base a un tipo specifico di log batch, specifica il tipo di log:
logName=projects/PROJECT_ID/logs/BATCH_LOG_TYPE
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto del progetto di cui vuoi visualizzare i log.BATCH_LOG_TYPE
: il tipo di log batch che vuoi visualizzare,batch_task_logs
per i log delle attività obatch_agent_logs
per i log degli agenti.
Per filtrare in base ai log con eventi di stato personalizzati, specifica che il log deve definire il campo
jsonPayload.batch/custom/event
:jsonPayload.batch"/"custom"/"event!=NULL_VALUE
Per filtrare in base ai log con una o più gravità specifiche, specifica questo confronto:
severityCOMPARISON_OPERATORSEVERITY_ENUM
Sostituisci quanto segue:
COMPARISON_OPERATOR
: un operatore di confronto, ad esempio>=
.SEVERITY_ENUM
: un'enumerazioneLogSeverity
, che descrive la gravità di un log, ad esempioERROR
.
Per ulteriori opzioni di filtro, consulta la documentazione sul linguaggio delle query di Cloud Logging.
Passaggi successivi
- Scopri di più sulla risoluzione dei problemi.
- Scopri di più su Cloud Logging.
- Scopri come scrivere i log delle attività.
- Scopri come eliminare ed esportare i job.