Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione dei problemi

Questa pagina mostra come risolvere i problemi relativi a Batch.

Se stai tentando di risolvere i problemi di un job per il quale non vedi un messaggio di errore, controlla se la cronologia del job contiene messaggi di errore visualizzando gli eventi di stato prima di esaminare questo documento.

Per ulteriori informazioni sulla risoluzione dei problemi di un job, vedi anche i seguenti documenti:

Errori di creazione del job

Se non riesci a creare un job, la causa potrebbe essere uno degli errori in questa sezione.

Quota insufficiente

Problema

Quando provi a creare un job, si verifica uno dei seguenti problemi:

Quando il job è nello stato QUEUED, nel campo statusEvents viene visualizzato il seguente problema:
```
Quota checking process decides to delay scheduling for the job JOB_UID due to inadequate quotas [Quota: QUOTA_NAME, limit: QUOTA_LIMIT, usage: QUOTA_CURRENT_USAGE, wanted: WANTED_QUOTA.].
```
Questo problema indica che il job è stato ritardato perché l'utilizzo attuale (QUOTA_USAGE) e il limite (QUOTA_LIMIT) di QUOTA_NAME hanno impedito l'utilizzo richiesto del job (WANT_QUOTA).
Quando il job è nello stato QUEUED, SCHEDULED o FAILED, nel campo statusEvents viene visualizzato uno dei seguenti problemi:
```
RESOURCE_NAME creation failed:
Quota QUOTA_NAME exceeded. Limit: QUOTA_LIMIT in region REGION
```
```
RESOURCE_NAME creation failed:
Quota QUOTA_NAME exceeded. Limit: QUOTA_LIMIT in zone ZONE
```
Questo problema indica che la creazione di una risorsa non è riuscita perché la richiesta ha superato la quota QUOTA_NAME, che ha un limite di QUOTA_LIMIT nella località specificata.

Soluzione

Per risolvere il problema:

Se il job è stato ritardato, prova ad attendere il rilascio di una quota maggiore.
Se il job non è riuscito a causa di una quota insufficiente o se questi ritardi persistono, prova a evitare una quota insufficiente eseguendo una delle seguenti operazioni:
- Crea job che utilizzano una quota inferiore o inferiore a quella quota. Ad esempio, specifica una località consentita o un tipo di risorsa diversi per il job oppure suddividi l'utilizzo della quota tra progetti aggiuntivi.
- Richiedi a Google Cloud un limite di quota più elevato per il tuo progetto.

Per ulteriori informazioni, consulta Quote e limiti per i batch e Utilizzo delle quote.

Autorizzazioni insufficienti per agire come account di servizio

Problema

Quando provi a creare un job, si verifica il seguente problema:

Se il job non utilizza un modello di istanza, il problema si presenta come segue:

caller does not have access to act as the specified service account: SERVICE_ACCOUNT_NAME

Se il job utilizza un modello di istanza, il problema si presenta come segue:

Error: code - CODE_SERVICE_ACCOUNT_MISMATCH, description - The service account specified in the instance template INSTANCE_TEMPLATE_SERVICE_ACCOUNT doesn't match the service account specified in the job JOB_SERVICE_ACCOUNT for JOB_UID, project PROJECT_NUMBER

Questo problema si verifica in genere perché l'utente che crea il job non dispone di autorizzazioni sufficienti per agire come account di servizio utilizzato dal job, che è controllato dall'autorizzazione iam.serviceAccounts.actAs.

Soluzione

Per risolvere il problema:

Se il job utilizza un modello di istanza, verifica che l'account di servizio specificato nel modello di istanza corrisponda all'account di servizio specificato nella definizione del job.
Assicurati che all'utente che sta creando il job sia stato concesso il ruolo Utente account di servizio (roles/iam.serviceAccountUser) sull'account di servizio specificato per il job. Per maggiori informazioni, vedi Gestire l'accesso.
Ricrea il job.

Reti ripetute

Problema

Quando provi a creare un job, si verifica il seguente problema:

Networks must be distinct for NICs in the same InstanceTemplate

Questo problema si verifica perché hai specificato la rete per un job più di una volta.

Soluzione

Per risolvere il problema, ricrea il job e specifica la rete utilizzando una delle seguenti opzioni:

Modello di istanza VM: se vuoi utilizzare un modello di istanza VM durante la creazione del job, devi specificare la rete nel modello di istanza VM.
Campi network e subnetwork: questi campi possono essere utilizzati nel corpo della richiesta quando crei un job utilizzando l'API Batch o nel file di configurazione JSON quando crei un job utilizzando gcloud CLI.
Flag --network e --subnetwork: questi flag possono essere utilizzati con il comando gcloud batch jobs submit quando crei un job utilizzando gcloud CLI.

Per ulteriori informazioni, consulta Specificare la rete per un job.

Rete non valida per Controlli di servizio VPC

Problema

Quando provi a creare un job, si verifica il seguente problema:

no_external_ip_address field is invalid. VPC Service Controls is enabled for the project, so external ip address must be disabled for the job. Please set no_external_ip_address field to be true

Soluzione

Questo problema si verifica perché stai tentando di creare ed eseguire un job con VM che hanno indirizzi IP esterni in un perimetro di servizio Controlli di servizio VPC.

Per risolvere il problema, crea un job che blocchi l'accesso esterno per tutte le VM.

Per ulteriori informazioni su come configurare il networking per un job in un perimetro di servizio Controlli di servizio VPC, consulta Utilizzare Controlli di servizio VPC con batch.

Problemi di job ed errori di errore

Se hai problemi con un job che non viene eseguito correttamente o non è riuscito per motivi poco chiari, la causa potrebbe essere uno degli errori in questa sezione o uno dei codici di uscita nella seguente sezione Codici di uscita di errore delle attività.

Nessun log in Cloud Logging

Problema

Devi eseguire il debug di un job, ma non viene visualizzato alcun log per il job in Cloud Logging.

Questo problema si verifica spesso per i seguenti motivi:

L'API Cloud Logging non è abilitata per il tuo progetto. Anche se configuri correttamente tutto il resto per i log di un job, l'operazione non produrrà log se il servizio non è abilitato per il tuo progetto.
L'account di servizio del job non dispone dell'autorizzazione per scrivere log. Un job non può produrre log senza autorizzazioni sufficienti.
Il job non è stato configurato per produrre log. Per produrre i log in Cloud Logging, Cloud Logging deve essere abilitato su un job. Gli elementi eseguibili del job devono inoltre essere configurati in modo da scrivere le informazioni che vuoi visualizzare nei log nei flussi di output standard (stdout) e errore standard (stderr). Per ulteriori informazioni, consulta Analizzare un job utilizzando i log.
Le attività non sono state eseguite. I log non possono essere generati finché le attività non sono state assegnate alle risorse e non ne iniziano l'esecuzione.
Cloud Logging è stato configurato in modo da escludere automaticamente i log del job. I log dei job batch non possono essere visualizzati se hai configurato filtri di esclusione per Cloud Logging che causano l'esclusione dei log dei job batch.

Soluzione

Per risolvere il problema:

Assicurati che i log non siano stati esclusi automaticamente da Cloud Logging disabilitando gli attuali filtri di esclusione per Cloud Logging.
Assicurati che l'API Cloud Logging sia abilitata per il tuo progetto.
Assicurati che l'account di servizio per il job abbia il ruolo IAM Writer log (roles/logging.logWriter). Per maggiori informazioni, consulta Abilitare Batch per un progetto.
Visualizza i dettagli del job utilizzando gcloud CLI o l'API Batch. I dettagli del job possono aiutarti a capire perché il job non ha prodotto log e potrebbero fornire informazioni che speravi di ottenere dai log. Ad esempio, procedi nel seguente modo:
1. Per verificare che il logging sia abilitato, esamina il campo logsPolicy del job.
2. Per verificare che l'esecuzione del job sia riuscita, esamina il campo status del job.

Dopo aver apportato le modifiche, ricrea il job e attendi che ne venga completata l'esecuzione prima di controllare i log.

Nessun report sull'agente di servizio

Problema

Il seguente problema viene visualizzato nel campo statusEvents per un job non eseguito correttamente o con errori prima della creazione delle VM:

No VM has agent reporting correctly within time window NUMBER_OF_SECONDS seconds, VM state for instance VM_NAME is TIMESTAMP,agent,start

Il problema indica che nessuna delle VM di un job sta segnalando l'agente di servizio batch.

Questo problema si verifica spesso per i seguenti motivi:

Le VM del job non hanno autorizzazioni sufficienti. Le VM di un job richiedono autorizzazioni specifiche per segnalare il loro stato all'agente di servizio batch. Puoi fornire queste autorizzazioni per le VM di un job concedendo il ruolo Reporter agente batch (roles/batch.agentReporter) all'account di servizio del job.
Le VM del job presentano problemi di rete. Le VM di un job richiedono l'accesso alla rete per comunicare con l'agente di servizio Batch.
Le VM del job utilizzano un'immagine del sistema operativo VM batch obsoleta o utilizzano un'immagine del sistema operativo VM con software agente di servizio Batch obsoleto. Le VM del job richiedono un software nell'immagine del sistema operativo VM che fornisce le dipendenze attuali per la segnalazione all'agente di servizio batch.

Soluzione

Per risolvere il problema:

Verifica che le VM del job dispongano delle autorizzazioni necessarie per segnalare il loro stato all'agente di servizio Batch.
1. Per identificare l'account di servizio del job, visualizza i dettagli del job utilizzando gcloud CLI o l'API Batch. Se non è elencato alcun account di servizio, il job utilizza l'account di servizio predefinito di Compute Engine per impostazione predefinita.
2. Verifica che l'account di servizio del job disponga delle autorizzazioni per il ruolo Reporter agente batch (roles/batch.agentReporter). Per ulteriori informazioni, consulta Gestire l'accesso e Limitazione dell'utilizzo degli account di servizio.
  
  Ad esempio, per concedere all'account di servizio predefinito di Compute Engine le autorizzazioni richieste, utilizza il comando seguente:
```
gcloud projects add-iam-policy-binding PROJECT_ID \
  --role roles/batch.agentReporter \
  --member serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com
```
  - Sostituisci PROJECT_NUMBER con il tuo numero di progetto
  - Sostituisci PROJECT_ID con il tuo ID progetto
Verifica che le VM del job abbiano l'accesso alla rete corretto. Per ulteriori informazioni, consulta Panoramica del networking batch e Risoluzione dei problemi di rete più comuni.
Se hai specificato l'immagine del sistema operativo VM per il job, verifica che l'immagine del sistema operativo VM sia attualmente supportata.
1. Se hai abilitato Cloud Logging per il job, puoi identificare il problema controllando i seguenti log degli agenti (batch_agent_logs). Per ulteriori informazioni, consulta Analisi di un job utilizzando i log.
  - Log per l'errore software dell'agente di servizio batch obsoleto:
```
rpc error: code = FailedPrecondition, desc = Invalid resource state for BATCH_AGENT_VERSION: outdated Batch agent version used.
```
    BATCH_AGENT_VERSION è la versione del software per comunicare con l'agente di servizio Batch utilizzato dal job, ad esempio cloud-batch-agent_20221103.00_p00.
  - Registra un errore relativo all'immagine del sistema operativo delle VM batch obsoleta:
```
rpc error: code = FailedPrecondition, desc = Invalid resource state for BATCH_VM_OS_IMAGE_NAME: outdated Batch image version.
```
    BATCH_VM_OS_IMAGE_NAME è la versione specifica di un'immagine del sistema operativo VM in batch utilizzata dal job, ad esempio batch-debian-11-20220909-00-p00.
2. Puoi risolvere il problema utilizzando un'immagine del sistema operativo VM più recente. Se il job utilizza un'immagine personalizzata, ricrea l'immagine personalizzata in base a una delle versioni più recenti di un'immagine pubblica supportata.
  
  Per ulteriori informazioni, vedi Immagini del sistema operativo VM supportate e Visualizzare le immagini del sistema operativo VM.
Ricrea il job.

Metriche delle risorse mancanti in Cloud Monitoring

Problema

Vuoi visualizzare le metriche delle risorse per un job, ma mancano alcune o tutte le metriche previste.

Questo problema si verifica spesso per i seguenti motivi:

L'API non è stata abilitata per il progetto. Anche se configuri correttamente tutto il resto del progetto, le metriche delle risorse potrebbero non essere visualizzate finché l'API Cloud Monitoring non viene abilitata. Per Ops Agent, devi abilitare anche l'API Cloud Logging.
Non hai autorizzazioni sufficienti per visualizzare le metriche. Non puoi visualizzare le metriche senza autorizzazioni sufficienti.
Le VM del job non sono state eseguite. Le metriche non possono essere prodotte per un job finché almeno una delle VM del job è in esecuzione.
La configurazione o le autorizzazioni del job non supportavano le metriche di Ops Agent. Alcune metriche delle risorse possono essere fornite solo da Ops Agent. Per supportare le metriche Ops Agent, un job deve soddisfare i requisiti per Ops Agent, installare Ops Agent e utilizzare un account di servizio in grado di scrivere metriche in Monitoring.
Per visualizzare le metriche, devi utilizzare un metodo o un filtro diverso. Alcuni metodi per visualizzare le metriche non mostrano le metriche per le VM dopo che sono state eliminate. Inoltre, le metriche non vengono visualizzate se vengono omesse dai filtri o dal periodo di tempo visualizzato. Inoltre, i grafici delle metriche hanno risoluzioni regolabili che possono causare una visualizzazione ridotta di quantità ridotte di dati.
Le metriche sono state eliminate. Dopo l'eliminazione, non puoi visualizzare le metriche, che avviene automaticamente dopo i periodi di conservazione di Monitoring.

Soluzione

Se mancano solo le metriche di Ops Agent, prova innanzitutto a risolvere il problema seguendo questi passaggi:

Verifica la configurazione del job seguendo questi passaggi:
1. Per visualizzare le informazioni complete sulla configurazione del job, visualizza i dettagli del job utilizzando gcloud CLI o l'API Batch. Utilizza l'output per i passaggi rimanenti.
2. Assicurati che l'account di servizio del job disponga delle autorizzazioni per scrivere metriche di Ops Agent.
3. Assicurati che il job soddisfi tutti i requisiti di Ops Agent.
4. Assicurati che il job installi correttamente Ops Agent. Sebbene sia possibile installare manualmente Ops Agent in un file eseguibile, il metodo consigliato consiste nell'installare automaticamente Ops Agent impostando il campo installOpsAgent su true.
Se il problema persiste, consulta Risolvere i problemi di Ops Agent nella documentazione di Google Cloud Observability.

In caso contrario, risolvi il problema procedendo nel seguente modo:

Assicurati che l'API Monitoring sia abilitata per il tuo progetto:

Abilita l'API
Assicurati che le VM del job siano in esecuzione e che il tempo di esecuzione rientri nei periodi di conservazione di Monitoring. Puoi verificare il tempo di esecuzione del job visualizzando i dettagli del job.
Verifica che non ci siano problemi con i metodi che utilizzi per visualizzare le metriche procedendo nel seguente modo:
1. A meno che tu non voglia visualizzare le metriche solo per le risorse in esecuzione, assicurati di visualizzare le metriche utilizzando Metrics Explorer o una dashboard personalizzata creata dai grafici di Metrics Explorer. Altri metodi, come le dashboard di Compute Engine, non mostrano le metriche per le risorse eliminate.
2. Assicurati che il periodo di visualizzazione includa il tempo di esecuzione del job. Per i grafici, assicurati anche che la risoluzione dei grafici sia appropriata per i tuoi dati.
3. Assicurati che non siano presenti filtri che nascondono i dati.
Se il problema persiste, consulta le pagine sulla risoluzione dei problemi di Cloud Monitoring nella documentazione di Google Cloud Observability.

Vincolo violato per gli indirizzi IP esterni della VM

Problema

Nel campo statusEvents viene visualizzato il seguente problema per un job non riuscito:

Instance VM_NAME creation failed: Constraint constraints/compute.vmExternalIpAccess violated for project PROJECT_NUMBER.
Add instance VM_NAME to the constraint to use external IP with it.

Questo problema si verifica perché il progetto, la cartella o l'organizzazione ha impostato il vincolo del criterio dell'organizzazione compute.vmExternalIpAccess in modo che solo le VM incluse nella lista consentita possano utilizzare indirizzi IP esterni.

Soluzione

Per risolvere il problema, ricrea il job ed esegui una delle seguenti operazioni:

Utilizza un progetto esente dal vincolo.
Crea un job che blocchi l'accesso esterno per tutte le VM.

Vincolo violato per immagini attendibili

Problema

Nel campo statusEvents viene visualizzato il seguente problema per un job non riuscito:

Instance VM_NAME creation failed: Constraint constraints/compute.trustedImageProjects violated for project PROJECT_ID. Use of images from project batch-custom-image is prohibited.

Soluzione

Questo problema si verifica perché il progetto ha impostato il vincolo del criterio Immagini attendibili (compute.trustedImageProjects) in modo che le immagini di Batch presenti nel progetto batch-custom-image di immagini non sono consentite.

Per risolvere il problema, esegui almeno una delle seguenti operazioni:

Ricrea il job per specificare un'immagine del sistema operativo VM già consentita dal vincolo del criterio delle immagini attendibili.
Chiedi all'amministratore di consentire la modifica del vincolo criteri per l'utilizzo di immagini attendibili per consentire le immagini del sistema operativo VM dal progetto batch-custom-image. Per le istruzioni, consulta Controllare l'accesso alle immagini del sistema operativo VM per Batch.

Job non riuscito durante l'utilizzo di un modello di istanza

Problema

Il seguente problema viene visualizzato nel campo statusEvents per un job non riuscito che utilizza un modello di istanza:

INVALID_FIELD_VALUE,BACKEND_ERROR

Questo problema si verifica a causa di problemi poco chiari con il modello di istanza del job.

Soluzione

Per eseguire ulteriormente il debug del problema:

Crea un gruppo di istanze gestite utilizzando il modello di istanza e osserva se si verificano errori con ulteriori dettagli.
(Facoltativo) Per provare a trovare ulteriori informazioni, consulta l'operazione a lunga esecuzione che sta creando il gruppo di istanze gestite nella console Google Cloud.

Vai a Operazioni di Compute Engine

Codici di uscita di errore dell'attività

Quando un'attività specifica in un job ha esito negativo, l'attività restituisce un codice di uscita diverso da zero. A seconda di come configuri il campo ignoreExitStatus, un'attività non riuscita può causare o meno la mancata riuscita di un job.

Oltre ai codici di uscita definiti in un elemento eseguibile, un batch ha diversi codici di uscita riservati, inclusi i seguenti codici di uscita.

Prerilascio VM (50001)

Problema

Il seguente problema viene visualizzato nel campo statusEvents di un job:

Task state is updated from PRE-STATE to FAILED on zones/ZONE/instances/INSTANCE_ID due to Spot Preemption with exit code 50001.

Questo problema si verifica quando una VM spot per il job viene prerilasciata durante il tempo di esecuzione.

Soluzione

Per risolvere il problema, procedi in uno dei seguenti modi:

Riprova a eseguire l'attività utilizzando nuovi tentativi automatici di attività o eseguendo di nuovo il job manualmente.
Per garantire che non ci sia prerilascio, utilizza invece le VM con il modello di provisioning standard.

Timeout report VM (50002)

Problema

Il seguente problema viene visualizzato nel campo statusEvents di un job:

Task state is updated from PRE-STATE to FAILED on zones/ZONE/instances/INSTANCE_ID due to Batch no longer receives VM updates with exit code 50002.

Questo problema si verifica quando si verifica un timeout nel backend che impedisce a una VM per il job di ricevere più aggiornamenti.

Soluzione

Per risolvere il problema, riprova a eseguire l'attività utilizzando nuovi tentativi automatici di attività o eseguendo di nuovo il job manualmente.

VM riavviata durante l'esecuzione (50003)

Problema

Il seguente problema viene visualizzato nel campo statusEvents di un job:

Task state is updated from PRE-STATE to FAILED on zones/ZONE/instances/INSTANCE_ID due to VM is rebooted during task execution with exit code 50003.

Questo problema si verifica quando una VM per un job si riavvia inaspettatamente durante il tempo di esecuzione.

Soluzione

Per risolvere il problema, riprova a eseguire l'attività utilizzando nuovi tentativi automatici di attività o eseguendo di nuovo il job manualmente.

La VM e l'attività non rispondono (50004)

Problema

Il seguente problema viene visualizzato nel campo statusEvents di un job:

Task state is updated from PRE-STATE to FAILED on zones/ZONE/instances/INSTANCE_ID due to tasks cannot be canceled with exit code 50004.

Questo problema si verifica quando un'attività raggiunge il limite di tempo per cui non risponde e non può essere annullata.

Soluzione

Per risolvere il problema, riprova a eseguire l'attività utilizzando nuovi tentativi automatici di attività o eseguendo di nuovo il job manualmente.

L'attività viene eseguita oltre il runtime massimo (50005)

Problema

Il seguente problema viene visualizzato nel campo statusEvents di un job:

Task state is updated from PRE-STATE to FAILED on zones/ZONE/instances/INSTANCE_ID due to task runs over the maximum runtime with exit code 50005.

Questo problema si verifica nei seguenti casi:

Il tempo di esecuzione di un'attività supera il limite di tempo specificato nel campo maxRunDuration
Il tempo di esecuzione di un elemento eseguibile supera il limite di tempo specificato nel campo timeout

Per identificare con precisione quale limite di tempo è stato superato, visualizza i log per il job e trova un log che menzioni il codice di uscita 50005. Il campo textPayload di questo log indica dove e quando è stato superato il limite di tempo.

Soluzione

Per risolvere il problema, prova a verificare il tempo di esecuzione totale richiesto dall'attività o eseguibile che abbia superato il limite di tempo. Effettua poi una delle seguenti operazioni:

Se ti aspetti questo errore solo occasionalmente, ad esempio per un'attività o eseguibile con un tempo di esecuzione incoerente, puoi provare a ricreare il job e configurarlo in modo da automatizzare i nuovi tentativi delle attività in modo da aumentare la percentuale di successo.
In caso contrario, se l'attività o eseguibile in modo coerente e ha intenzionalmente bisogno di più tempo per terminare l'esecuzione rispetto a quanto consentito dal timeout attuale, imposta un timeout più lungo.

VM ricreata durante l'esecuzione (50006)

Problema

Il seguente problema viene visualizzato nel campo statusEvents di un job:

Task state is updated from PRE-STATE to FAILED on zones/ZONE/instances/INSTANCE_ID due to VM is recreated during task execution with exit code 50006.

Questo problema si verifica quando una VM per un job viene ricreata in modo imprevisto durante il runtime.

Soluzione

Per risolvere il problema, riprova a eseguire l'attività utilizzando nuovi tentativi automatici di attività o eseguendo di nuovo il job manualmente.

Passaggi successivi

Ricevi assistenza per Batch.