Risoluzione dei problemi dell'edizione SAP BTP dell'SDK ABAP per Google Cloud

Per risolvere i problemi relativi alla versione SAP BTP dell'SDK ABAP per Google Cloud, il primo passaggio consiste nell'individuare la possibile origine del problema. Il problema potrebbe essere correlato all'infrastruttura, all'ambiente SAP BTP e agli strumenti in uso o all'SDK ABAP per Google Cloud stesso.

Se l'analisi indica un problema con l'SDK ABAP per Google Cloud, risolvi i problemi utilizzando i log e i messaggi di errore dell'applicazione SAP.

Se ritieni che il problema riguardi il tuo ambiente o i tuoi strumenti SAP, contatta SAP per ricevere assistenza.

Controlla i prerequisiti

Assicurati che tutti i prerequisiti siano soddisfatti per l'installazione della versione SAP BTP di ABAP SDK for Google Cloud. Per informazioni sui prerequisiti per l'installazione dell'SDK, consulta Prima di iniziare.

Leggi la documentazione dell'assistenza SAP

Se hai un account utente SAP, puoi trovare la soluzione a molti problemi relativi al software SAP leggendo le note SAP e gli articoli della Knowledge Base SAP disponibili in SAP ONE Support Launchpad.

Visualizza i log

Quando la registrazione è configurata, la versione SAP BTP dell'SDK ABAP per Google Cloud registra i messaggi di errore nei log delle applicazioni SAP. Per ulteriori informazioni sul logging, consulta Configurare il logging.

Per visualizzare i messaggi di log, svolgi i seguenti passaggi:

  1. Accedi al launchpad SAP Fiori del sistema ABAP BTP in cui è installato l'SDK ABAP per Google Cloud.
  2. Apri l'app Google SDK: visualizzazione dei log delle applicazioni.

  3. Fornisci i filtri di log come appropriato:

    • Da: seleziona una data di inizio da cui filtrare i log.
    • A: seleziona una data di fine fino alla quale filtrare i log.
    • Oggetti log: seleziona un oggetto log per cui devono essere recuperati i log.
    • Oggetto secondario del log: seleziona un oggetto secondario del log per cui devono essere recuperati i log.
    • Nome servizio: seleziona i nomi dei servizi API in base ai quali devono essere recuperati i log.

  4. Fai clic su Vai. Viene visualizzato l'elenco delle intestazioni dei log delle applicazioni.

    Intestazioni dei log delle applicazioni

  5. Fai clic sull'intestazione di un log per accedere ai log dettagliati a livello di articolo. I messaggi di log vengono visualizzati con gravità e timestamp.

    Log dettagliati a livello di articolo

    Un messaggio di log è costituito in genere dalle seguenti due voci:

    • Inserimento: fornisce informazioni sulla posizione del codice in cui si è verificato esattamente l'errore. Per la risoluzione dei problemi, puoi utilizzare questa posizione del codice come punto di interruzione durante il debug.
    • Messaggio di errore: fornisce informazioni su un errore che si è verificato durante l'esecuzione di un'operazione.

Debug

Se disponi dell'autorizzazione richiesta, puoi eseguire il debug delle classi client API.

Per eseguire il debug delle classi client dell'API, utilizza una delle seguenti opzioni:

  • Aggiungi un punto di interruzione al costruttore della classe /GOOG/CL_HTTP_CLIENT, quindi esegui il programma.

  • Aggiungi un punto di interruzione al metodo che stai utilizzando, quindi esegui il programma.

Traccia HTTP

Durante la risoluzione dei problemi, puoi controllare la traccia della chiamata HTTP in Collegamenti in uscita del sistema di monitoraggio SAP. Per ulteriori informazioni, consulta la pagina SAP Monitoraggio della comunicazione in uscita del sistema in generale.

Problemi operativi comuni

Quando utilizzano le API Google Cloud tramite i metodi pubblici dello stub client, gli sviluppatori potrebbero riscontrare errori ed eccezioni. Questi errori ed eccezioni vengono classificati in due categorie generali:

Questa sezione illustra gli errori e le eccezioni attivati dall'SDK.

/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending

Problema: la richiesta HTTP a un metodo dell'API non è riuscita.

Causa: questo problema può essere causato da problemi di connettività.

Risoluzione: nel progetto Google Cloud da cui stai tentando di accedere alle API Google Cloud, abilita le API di destinazione. Per informazioni su come attivare le API Google Cloud, consulta Abilitazione delle API.

/GOOG/MSG:400 - Error generating STS token:Bad Request-invalid_request-Invalid value for " audience". This value should be the full resource name of the Identity Provider. See https://cloud.google.com/iam/docs/reference/sts/rest/v1/TopLevel/token for the list of possible formats.

Problema: non riesci a generare il token del servizio token di sicurezza (STS).

Causa: quando esegui l'autenticazione in Google Cloud utilizzando i token tramite la federazione delle identità di carico di lavoro o la chiave API archiviata in Secret Manager, nella configurazione dell'autenticazione mancano le configurazioni necessarie.

Risoluzione: verifica e aggiorna i seguenti dettagli:

  • Nell'app Accordo di comunicazione, aggiorna l'ID pool Workload Identity Federation e l'ID provider Workload Identity Federation.

  • Nell'app Google SDK: configurazione principale, per la mappa di comunicazione, aggiornate l'ID progetto e il numero di progetto Google Cloud per la chiave client.

Per ulteriori informazioni, consulta Configurare ABAP SDK for Google Cloud per utilizzare la federazione delle identità di lavoro.

/GOOG/MSG:400 - Error generating STS token:Bad Request-invalid_scope-Invalid scope provided in the request

Problema: non riesci ad autenticarti su Google Cloud.

Causa: quando esegui l'autenticazione in Google Cloud utilizzando i token tramite la federazione delle identità di lavoro o la chiave API archiviata in Secret Manager, l'ambito Google Cloud non è valido.

Risoluzione: nell'app Google SDK: configurazione principale, per la mappa di comunicazione assicurati che l'ambito Google Cloud sia https://www.googleapis.com/auth/cloud-platform.

/GOOG/MSG:461 - API Key not valid. Please pass a valid API Key

Problema: non riesci ad autenticarti su Google Cloud utilizzando l'autenticazione basata su chiave API.

Causa: nell'accordo di comunicazione è stata fornita una chiave API non valida.

Risoluzione: per risolvere il problema, mantieni un nome e una versione della chiave segreta validi nel contratto di comunicazione associato. Inoltre, assicurati che nel segreto sia configurata una chiave API valida.

Per saperne di più, vedi Configurare ABAP SDK for Google Cloud per utilizzare la chiave API memorizzata in Secret Manager

/GOOG/MSG: 461 - Communication Map entry for authentication service not maintained

Problema: l'SDK non è in grado di determinare gli elementi di comunicazione per l'autenticazione.

Causa: non è presente una mappa di comunicazione per il servizio di autenticazione.

Risoluzione: nell'app Google SDK: configurazione principale, crea una mappa di comunicazione e mantieni il Tipo di autenticazione corretto per il metodo di autenticazione che stai utilizzando.

Per creare una mappa di comunicazione, consulta le istruzioni per i metodi di autenticazione in Configurare l'autenticazione per l'edizione SAP BTP di ABAP SDK for Google Cloud.

/GOOG/MSG: 461 - Communication Scenario not valid for default Google Authentication

Problema: l'SDK non è in grado di determinare la modalità di comunicazione per l'autenticazione.

Causa: la voce gestita per il servizio di autenticazione non è valida.

Risoluzione: nell'app Google SDK: configurazione principale, per la voce della mappa di comunicazione, assicurati che l'organizzazione della comunicazione sia configurata con lo scenario e il sistema di comunicazione corretti.

Per aggiornare un'organizzazione di comunicazione, consulta le istruzioni per i metodi di autenticazione in Configurare l'autenticazione per l'edizione SAP BTP dell'SDK ABAP per Google Cloud.

/GOOG/MSG:400 - Error generating IDP token: Not found

Problema: non riesci a generare il token del provider di identità dal servizio XSUAA.

Causa: quando esegui l'autenticazione in Google Cloud utilizzando i token tramite la federazione delle identità di carico di lavoro o la chiave API memorizzata in Secret Manager, l'URL del nome host per il servizio XSUAA o il valore del percorso non è valido nel sistema di comunicazione.

Risoluzione: verifica e aggiorna i seguenti dettagli:

  • Nel sistema di comunicazione per il servizio XSUAA o nella destinazione BTP utilizzata nel sistema di comunicazione, mantieni l'URL del nome host corretto.
  • Nell'organizzazione della comunicazione, mantieni un percorso valido.

/GOOG/MSG:400 - Error generating STS token: Not found

Problema: non riesci a generare il token del servizio token di sicurezza richiesto per l'autenticazione.

Causa: quando esegui l'autenticazione in Google Cloud utilizzando i token tramite la federazione delle identità di lavoro o la chiave API archiviata in Secret Manager e utilizzi un'organizzazione di comunicazione per il servizio STS, il sistema di comunicazione associato al servizio STS non è valido.

Risoluzione: verifica e aggiorna i seguenti dettagli:

  • Nel sistema di comunicazione per il servizio STS o nella destinazione BTP utilizzata nel sistema di comunicazione, mantieni l'URL del nome host corretto.
  • Nell'organizzazione della comunicazione, mantieni un percorso valido.

/GOOG/MSG:400 - Error generating IAM token: Not found

Problema: non riesci a generare il token IAM richiesto per l'autenticazione.

Causa: quando esegui l'autenticazione in Google Cloud utilizzando i token tramite la federazione delle identità di carico di lavoro o la chiave API archiviata in Secret Manager e utilizzi un'organizzazione di comunicazione per il servizio IAM, la mappa di comunicazione e il sistema di comunicazione associati al servizio IAM non sono validi.

Risoluzione: verifica e aggiorna i seguenti dettagli:

  • Nel sistema di comunicazione per il servizio IAM o nella destinazione BTP utilizzata nel sistema di comunicazione, mantieni l'URL del nome host corretto.
  • Nell'organizzazione della comunicazione, mantieni un percorso valido.

Errori di convalida della configurazione

G001 | Check communication scenario

Causa: lo scenario di comunicazione configurato nella mappa di comunicazione non è supportato con la classe di autorizzazione predefinita /GOOG/CL_AUTH_GOOGLE.

Risoluzione: se utilizzi /GOOG/CL_AUTH_GOOGLE come classe di autorizzazione, assicurati che nella mappa di comunicazione sia specificato uno dei seguenti scenari di comunicazione, a seconda del metodo di autenticazione:

Scenario di comunicazione Autenticazione
/GOOG/COM_SDK_WIF Federazione delle identità per i workload
/GOOG/COM_SDK_APIKSM Chiave API che utilizza Secret Manager

Per aggiornare una mappa di comunicazione, consulta le istruzioni per i metodi di autenticazione in Configurare l'autenticazione per la versione SAP BTP di ABAP SDK for Google Cloud.

W001 | Check Comm. arrangement for WIF

Causa: non è possibile identificare l'organizzazione della comunicazione utilizzando lo scenario di comunicazione e il sistema di comunicazione specificati nell'app Google SDK: configurazione principale.

Risoluzione: assicurati che l'organizzazione delle comunicazioni per il servizio di autenticazione utilizzi uno scenario di comunicazione e un sistema di comunicazione validi.

Per ulteriori informazioni, consulta Configurare ABAP SDK for Google Cloud per utilizzare la federazione delle identità di lavoro.

W002 | Fetch XSUAA token

Causa: il recupero del token XSUAA non è riuscito.

Risoluzione: assicurati che l'istanza di servizio XSUAA sia configurata correttamente.

Per ulteriori informazioni, vedi Creare un'istanza di servizio di attendibilità e autorizzazione (XSUAA).

W003 | Fetch WIF Pool ID

Causa: l'ID pool di Workload Identity Federation non esiste nel'organizzazione della comunicazione.

Risoluzione: nell'organizzazione della comunicazione utilizzata per il servizio di autenticazione, assicurati che venga utilizzato lo scenario di comunicazione /GOOG/COM_SDK_WIF e che sia specificato un ID pool di federazione delle identità per i carichi di lavoro valido.

Per ulteriori informazioni, consulta Configurare ABAP SDK for Google Cloud per utilizzare la federazione delle identità di lavoro.

W004 | Fetch WIF Provider ID

Causa: l'ID provider della federazione delle identità per i carichi di lavoro non esiste nel contratto di comunicazione.

Risoluzione: nell'organizzazione della comunicazione utilizzata per il servizio di autenticazione, assicurati che venga utilizzato lo scenario di comunicazione /GOOG/COM_SDK_WIF e che sia specificato un ID provider di federazione delle identità per i carichi di lavoro valido.

Per ulteriori informazioni, consulta Configurare ABAP SDK for Google Cloud per utilizzare la federazione delle identità di lavoro.

W005 | Fetch STS token

Causa: il recupero del token STS non è riuscito.

Soluzione: per risolvere il problema, procedi nel seguente modo:

W006 | Fetch IAM credential token

Causa: il recupero del token IAM non è riuscito dall'API IAM Credentials.

Soluzione: per risolvere il problema, procedi nel seguente modo:

  • Nella mappa di comunicazione, controlla se il numero del progetto Google Cloud è gestito correttamente. Per ulteriori informazioni, consulta Configurare ABAP SDK for Google Cloud per utilizzare la federazione delle identità di lavoro.
  • Nella mappa di comunicazione, se è presente una voce per il servizio iamcredentials:v1, assicurati che l'organizzazione della comunicazione sia valida, disponibile nel sistema e utilizzi lo stesso scenario di comunicazione e lo stesso sistema di comunicazione specificato nell'app di configurazione dell'SDK.

V001 | Check Comm. Arr. for API Key(SM)

Causa: non è possibile identificare l'organizzazione della comunicazione utilizzando lo scenario di comunicazione e il sistema di comunicazione specificati nell'app Google SDK: configurazione principale.

Risoluzione: assicurati che l'organizzazione della comunicazione gestita per il servizio di autenticazione sia valida, disponibile nel sistema e utilizzi lo stesso scenario di comunicazione e lo stesso sistema di comunicazione gestiti nell'app di configurazione dell'SDK.

Per saperne di più, vedi Configurare ABAP SDK for Google Cloud per utilizzare la chiave API da Secret Manager.

V002 | Fetch Secret Name

Causa: il nome del secret non esiste nell'organizzazione della comunicazione.

Risoluzione: nell'organizzazione delle comunicazioni utilizzata per il servizio di autenticazione, assicurati che venga utilizzato lo scenario di comunicazione /GOOG/COM_SDK_APIKSM e che sia specificato un secret valido.

Per saperne di più, vedi Configurare ABAP SDK for Google Cloud per utilizzare la chiave API da Secret Manager.

V003 | Fetch Secret Version

Causa: la proprietà Versione del secret non contiene un valore valido nell'organizzazione della comunicazione.

Risoluzione: nell'organizzazione delle comunicazioni utilizzata per il servizio di autenticazione, assicurati che venga utilizzato lo scenario di comunicazione /GOOG/COM_SDK_APIKSM e che sia specificata una versione del secret valida.

Per saperne di più, vedi Configurare ABAP SDK for Google Cloud per utilizzare la chiave API da Secret Manager.

V004 | Fetch Token from Secret Manager

Causa: l'API Secret Manager non è riuscita a recuperare il secret contenente la chiave API.

Soluzione: per risolvere il problema, procedi nel seguente modo:

Messaggi di errore restituiti dalle API Google Cloud

Ogni stub del client API ha i parametri di esportazione che forniscono il codice di ritorno dell'API e i messaggi di errore.

  • ev_ret_code contiene i codici di stato HTTP. In caso di errore restituito da un'API, questo parametro contiene un valore 4XX.

  • ev_err_resp contiene la categoria di errore e il messaggio di errore restituito da un'API.

L'esempio seguente mostra un errore restituito dall'API quando crei un nuovo argomento Pub/Sub con un nome argomento esistente.

  • ERROR_TEXT: conflitto
  • ERROR_DESCRIPTION: la risorsa esiste già nel progetto (resource=SAMPLE_TOPIC_01)

Per gli errori restituiti dalle API, ti consigliamo di consultare la documentazione pubblica delle API corrispondenti.

Ricevere assistenza dalla community

Poni le tue domande e discuti dell'ABAP SDK per Google Cloud con la community nei forum di Cloud.

Assistenza

Se hai bisogno di aiuto per risolvere i problemi relativi all'edizione SAP BTP dell'SDK ABAP per Google Cloud, raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud.

Per informazioni su come contattare l'assistenza clienti Google Cloud, consulta Ricevere assistenza per SAP su Google Cloud.