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 che non hai un messaggio di errore, controlla se la cronologia del job contiene Messaggi di errore tramite la visualizzazione degli eventi di stato prima di esaminare questo documento.

Per ulteriori informazioni sulla risoluzione dei problemi relativi a un job, consulta anche i seguenti documenti:

Errori di creazione del job

Se non riesci a creare un job, il motivo potrebbe essere uno degli errori descritti in questa sezione.

Quota insufficiente

Problema

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

Quando il job si trova QUEUED, il seguente problema si verifica Campo statusEvents:
```
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 è in ritardo perché l'utilizzo corrente (QUOTA_USAGE) e il limite (QUOTA_LIMIT) della quota QUOTA_NAME hanno impedito l'utilizzo richiesto dal job (WANT_QUOTA).
Quando il job è in 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 adottando una delle seguenti misure:
- 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 o 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 Utilizzare le 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 ha autorizzazioni sufficienti per agire come account di servizio usato dal job che è controllato 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 corrisponde all'account di servizio specificato nella definizione del job.
Assicurati che all'utente che crea il job sia stato concesso Ruolo Utente account di servizio (roles/iam.serviceAccountUser) dell'account di servizio specificato per il job. Per ulteriori informazioni, consulta 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 utilizza un modello di istanza VM durante la creazione di questo 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 saperne di più, consulta la sezione 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 la rete per un job in un perimetro di servizio VPC Service Controls, consulta Utilizzare i Controlli di servizio VPC con Batch.

Problemi relativi ai job ed errori di mancata riuscita

Se hai problemi con un job che non funziona correttamente o non è riuscito per motivi poco chiari, il problema potrebbe essere dovuto a uno degli errori riportati in questa sezione o a uno dei codici di uscita riportati nella sezione Codici di uscita relativi agli errori di esecuzione delle attività.

Nessun log in Cloud Logging

Problema

Devi eseguire il debug di un job, ma non vengono visualizzati 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, non produrrà log se il servizio non è abilitato del 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 generare i log Cloud Logging deve essere abilitato per un job. Il job gli elementi eseguibili devono essere configurati anche per scrivere le informazioni che vuoi vengono visualizzati nei log nell'output standard (stdout) con errori standard (stderr). Per ulteriori informazioni, consulta Analisi di un job tramite i log.
Le attività non sono state eseguite. I log non possono essere generati finché alle attività non sono state assegnate risorse e non iniziano a essere eseguite.
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 disattivando i servizi 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 ulteriori informazioni, vedi Abilitare Batch per un progetto.
Visualizza i dettagli del job utilizzando l'interfaccia a riga di comando gcloud o l'API Batch. I dettagli del job possono aiutarti a capire perché il job non ha prodotto log e potrebbero fornire le informazioni che speravi di ottenere dai log. Ad esempio, procedi nel seguente modo:
1. Per verificare che il logging sia abilitato, controlla il campo logsPolicy del job.
2. Per verificare che l'esecuzione del job sia riuscita, esamina la tabella Campo status:

Dopo aver apportato le modifiche, ricrea il job e attendi che sia completato prima di controllare i log.

Nessun report sull'agente di servizio

Problema

Nella sezione Campo statusEvents per un job non eseguito correttamente o non riuscito 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 riporta Agente di servizio batch.

Questo problema si verifica spesso per i seguenti motivi:

Le VM del job non dispongono di autorizzazioni sufficienti. Le VM di un job richiedono autorizzazioni specifiche per segnalare il proprio stato all'agente di servizio Batch. Puoi fornire queste autorizzazioni per le VM di un job concedendo il ruolo Report aggregato dell'agente (roles/batch.agentReporter) all'account di servizio del job.
Le VM del job presentano problemi di rete. Le VM di un job richiedono la rete l'accesso per comunicare con l'agente di servizio Batch.
Le VM del job utilizzano un'immagine del sistema operativo delle VM batch obsoleta o un'immagine del sistema operativo VM con un software agente di servizio batch obsoleto. Le VM del job richiedono software nell'immagine del sistema operativo VM che fornisca le dipendenze attuali per i report 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, per impostazione predefinita il job utilizza l'account di servizio predefinito di Compute Engine.
2. Verifica che l'account di servizio del job disponga delle autorizzazioni necessarie per Ruolo Reporter agente batch (roles/batch.agentReporter). Per ulteriori informazioni, vedi 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 seguente comando:
```
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 numero del progetto
  - Sostituisci PROJECT_ID con il tuo ID progetto
Verifica che le VM del job abbiano accesso alla rete adeguato. Per ulteriori informazioni, vedi Panoramica del networking in batch e Risolvi i problemi di rete più comuni.
Se hai specificato l'immagine del sistema operativo della VM per il job, verifica che sia attualmente supportata.
1. Se hai attivato Cloud Logging per il job, puoi identificarlo controllando se sono presenti i seguenti log dell'agente (batch_agent_logs). Per saperne di più, 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.
  - Log per errore relativo all'immagine del sistema operativo della 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 di 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, ricreala in base a una delle versioni più recenti di un'immagine pubblica supportata.
  
  Per ulteriori informazioni, consulta 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 alcune o tutte le metriche previste non sono presenti.

Questo problema si verifica spesso per i seguenti motivi:

L'API non è stata abilitata per il progetto. Anche se configuri correttamente tutto il resto nel progetto, le metriche potrebbero non essere visualizzate finché l'API Cloud Monitoring non viene abilitata. Per Ops Agent, devi abilitare anche l'API Cloud Logging.
Non disponi di autorizzazioni sufficienti per visualizzare le metriche. Non puoi visualizzare le metriche senza autorizzazioni sufficienti.
Le VM del job non sono state eseguite. Non è possibile generare metriche per un jobfinché non è in esecuzione almeno una delle VM del job.
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 di Ops Agent, un job deve soddisfare i requisiti di Ops Agent, installare Ops Agent e utilizzare un account di servizio che possa scrivere le 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 queste sono state eliminate. Inoltre, le metriche non vengono visualizzate se sono omesse dai filtri o dal periodo di tempo visualizzato. Inoltre, i grafici delle metriche presentano dati regolabili che possono causare una riduzione della quantità di dati troppo sottile per essere visualizzata.
Le metriche sono state eliminate. Non puoi visualizzare le metriche dopo che sono state eliminate, cosa che avviene automaticamente al termine dei periodi di conservazione del monitoraggio.

Soluzione

Se mancano solo le metriche di Ops Agent, prova innanzitutto a risolvere il problema eseguendo la seguenti:

Verifica la configurazione del job nel seguente modo:
1. Per vedere le informazioni di configurazione complete 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 abbia autorizzazioni di scrittura di metriche di Ops Agent.
3. Assicurati che il job soddisfi tutte le 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 è installarlo automaticamente impostando il campo installOpsAgent su true.
Se il problema persiste, consulta Risolvere i problemi relativi a 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:

Enable the API
Assicurati che le VM del job siano state avviate e che il tempo di esecuzione sia ancora all'interno Monitoraggio dei periodi di conservazione. Puoi visualizzare il tempo di esecuzione del job per la visualizzazione dei dettagli del job.
Verifica che non ci siano problemi con i metodi che utilizzi per visualizzare le metriche nel seguente modo:
1. A meno che tu non voglia visualizzare le metriche solo per le risorse in esecuzione, assicurati che stai visualizzando le metriche utilizzando Metrics Explorer o un dashboard creata dai grafici di Metrics Explorer. Altri metodi, ad esempio come dashboard di Compute Engine, non mostrano le metriche per le risorse eliminati.
2. Assicurati che il periodo di visualizzazione includa il tempo di esecuzione del job. Per i grafici, assicurati inoltre che la risoluzione del grafico sia appropriata per i tuoi dati.
3. Assicurati di non avere filtri che nascondono i dati.
Se il problema persiste, consulta le Risolvere i problemi di Cloud Monitoring pagine della documentazione su Google Cloud Observability.

Vincolo violato per gli indirizzi IP esterni della VM

Problema

Nella sezione Campo statusEvents 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 compute.vmExternalIpAccess vincolo dei criteri dell'organizzazione 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 le immagini attendibili

Problema

Il seguente problema viene visualizzato nel campo statusEvents 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 Vincolo del criterio per le immagini attendibili (compute.trustedImageProjects) in modo che le immagini da Batch, che sono Progetto di immagini batch-custom-image non consentito.

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

Ricrea il job per specificare un'immagine del sistema operativo della VM che è già consentita dal vincolo del criterio per le immagini attendibili.
Chiedi all'amministratore di consentire la modifica vincolo criteri per l'utilizzo di immagini attendibili per consentire le immagini del sistema operativo VM Progetto batch-custom-image immagine. Per istruzioni, vedi Controlla l'accesso alle immagini del sistema operativo VM per la modalità batch.

Il 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 non 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 vedere se si verificano errori con maggiori dettagli.
(Facoltativo) Per provare a trovare ulteriori informazioni, consulta la operazioni a lunga esecuzione che crea il gruppo di istanze gestite nella console Google Cloud.

Vai a Operazioni di Compute Engine

Codici di uscita relativi agli errori delle attività

Quando un'attività specifica in un job non va a buon fine, l'attività restituisce un codice di uscita diverso da zero. In base a come configuri Campo ignoreExitStatus, un'attività non riuscita può causare o meno la mancata riuscita di un job.

Oltre a eventuali codici di uscita definiti in un file eseguibile, un batch ha diversi codici di uscita riservati, tra cui i seguenti.

Prerilascio VM (50001)

Problema

Nel campo statusEvents di un job viene visualizzato il seguente problema:

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 l'esecuzione.

Soluzione

Per risolvere il problema, esegui una delle seguenti operazioni:

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

Timeout report VM (50002)

Problema

Nel campo statusEvents di un job viene visualizzato il seguente problema:

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 ha causato il mancato ricevimento di aggiornamenti da una VM per il job da parte di Batch. Purtroppo, molti guasti hardware o software possono causare l'interruzione della risposta di una VM. Ad esempio, una VM potrebbe arrestarsi in modo anomalo a causa di un evento temporaneo dell'host o di risorse insufficienti.

Soluzione

Per risolvere il problema:

Se il problema è temporaneo e si risolve da solo, riprova a eseguire l'attività utilizzando i riprova automatici delle attività o eseguendo di nuovo manualmente il job.
Se il problema persiste, identifica e risolvi la causa del problema. non risponde eseguendo una o più delle seguenti operazioni:
- Consigliato: richiedi assistenza tramite l'assistenza Google Cloud o l'Etichetta batch nei forum Cloud.
- Prova a identificare e risolvere autonomamente il problema. Ad esempio, se hai familiarità con Compute Engine, puoi provare a risolvere i problemi delle VM del job nel seguente modo:
  1. Per identificare i nomi delle VM del tuo job:
    1. Visualizza i log per il job.
    2. Filtra i log per voci contenenti la frase report agent state:.
    3. Esamina i log per determinare la VM per ogni tentativo di ogni attività. Ciascun log è simile al seguente, in cui una frase instance: e una o più frasi task_id:.
      report agent state: ... instance:"INSTANCE_NAME" ... task_id:"task/JOB_UID-group0-TASK_INDEX/TASK_RETRIES/0 ..."
      Questo log include i seguenti valori:
      - INSTANCE_NAME: il nome della VM.
      - JOB_UID: l'ID univoco (UID) del job.
      - TASK_INDEX: l'indice dell'attività.
      - TASK_RETRIES: il tentativo dell'attività eseguita su questa VM, che è formattato come numero di nuovi tentativi. Ad esempio, questo valore è 0 per il primo tentativo di un'attività. Ogni attività viene tentata una sola volta a meno che non abiliti nuovi tentativi automatici di attività.
  2. Risolvi i problemi delle VM del tuo job utilizzando Compute Engine documentazione. Ad esempio, consulta Risoluzione dei problemi di arresto e riavvio delle VM e Risoluzione dei problemi di avvio delle VM.

VM riavviata durante l'esecuzione (50003)

Problema

Nel campo statusEvents di un job viene visualizzato il seguente problema:

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 in modo imprevisto durante l'esecuzione.

Soluzione

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

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

Problema

Nella sezione Campo statusEvents per un lavoro:

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 eseguire di nuovo manualmente il job.

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

Problema

Nella sezione Campo statusEvents per un lavoro:

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 eseguibile supera il limite di tempo specificato nel campo timeout

Per identificare in modo specifico il limite di tempo superato, visualizza i log del job e individua 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 dell'attività o eseguibile che abbia superato il limite di tempo. Effettua poi una delle seguenti operazioni:

Se prevedi questo errore solo occasionalmente, ad esempio per un'attività o un programma executable con un tempo di esecuzione incoerente, puoi provare a ricreare il job e configurarlo per automatizzare i tentativi di esecuzione delle attività per provare ad aumentare il tasso di successo.
Altrimenti, se l'attività o l'esecuzione può essere eseguita in modo coerente e intenzionale di tempo per terminare l'esecuzione rispetto a quanto consentito dal timeout attuale, impostare un timeout più lungo.

VM ricreata durante l'esecuzione (50006)

Problema

Nel campo statusEvents di un job viene visualizzato il seguente problema:

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 eseguire di nuovo manualmente il job.

Passaggi successivi

Ricevi assistenza per Batch.