Risolvere i problemi di Data Gateway
In un agente Data Gateway utilizzare le opzioni del Navigator per visualizzare le pagine Stato, Log e Query per monitorare il traffico delle connessioni remote e risolvere i problemi comuni relativi alla connettività e alle prestazioni.
Diagnosi dei problemi di connessione utilizzando la pagina Stato
Utilizzare questa pagina per rivedere le richieste al database effettuate da un agente Data Gateway con il database remoto.
In un agente Data Gateway, fare clic su Navigator, quindi su Stato per rivedere le richieste del database.
- Per eseguire una ricerca in base alla data, nel campo Cerca richiesta immettere la data e l'ora in modo completo o parziale nel formato "GG-MM-AAAA HH-MM-SS". Ad esempio, immettere "28-03-2022" per cercare le voci relative al 28 marzo 2022.
- Per cercare i job non riusciti, nel campo Cerca richiesta immettere "RICHIESTA TERMINATA CON ERRORI".
Deselezionare il campo Cerca richiesta per esaminare tutti i job.
.png
Fare clic su un job per visualizzare le informazioni dettagliate sullo stato.
.png
Diagnosi dei problemi di connessione utilizzando la pagina Log
Utilizzare questa pagina per esaminare le voci del log di un agente Data Gateway in modo da poter analizzare il traffico della connessione.
In un agente Data Gateway, fare clic su Navigator, quindi su Log per rivedere le voci dei log. Abilitare l'opzione Abilita polling log e selezionare un livello di log appropriato. Ad esempio, per diagnosticare i problemi di connessione, è possibile impostare Tipo di log su Debug.
.png
Una volta completata la risoluzione dei problemi, Oracle consiglia di disabilitare l'opzione Abilita polling log o di modificare il Tipo di log in modo da acquisire una minore quantità di informazioni.
Diagnosi dei problemi di connessione utilizzando la pagina Query
Utilizzare questa pagina per eseguire una query su un database remoto da un agente Data Gateway per verificare la connessione e valutare le prestazioni.
In un agente Data Gateway fare clic su Navigator quindi su Query per eseguire un'istruzione SQL direttamente dall'agente Data Gateway al database (in locale). Ad esempio, è possibile copiare la Stringa di query, la Stringa di connessione e la Classe del driver da un job non riuscito indicato nella pagina Stato. Fornire le credenziali del database ed eseguire la query per esaminare il risultato e le statistiche relative alle prestazioni (il tempo impiegato). Nota: il database remoto deve supportare la connessione utilizzando una stringa di connessione JDBC.
.png
Problemi relativi alla connettività remota e suggerimenti
Di seguito sono riportati alcuni problemi di connettività che si potrebbero verificare e suggerimenti su come risolverli.
Problemi relativi alle analisi e ai dashboard
| Problema segnalato | Operazioni da eseguire |
|---|---|
| Codice di errore 603: nessun agente connesso |
Verificare che l'agente Data Gateway sia in esecuzione e sia abilitato nella pagina di configurazione di Data Gateway. Se Data Gateway è installato su Linux: eseguire $ <directory di installazione di Data Gateway>/domain/bin/status.sh e verificare se lo stato di Data Gateway è UP o DOWN. Se Data Gateway è installato su Windows: verificare i processi "datagateway.exe" nella scheda Gestione attività > Dettagli. |
| [nQSError: 77031] Si è verificato un errore durante la chiamata al server remoto DatasourceService. Dettagli: [JDSError: 78] URL con formato non valido | Rivedere il connection pool nel modello semantico e verificare le impostazioni nella scheda Generale e nelle schede Varie. |
Problemi relativi alle connessioni e ai data set
| Problema segnalato | Operazioni da eseguire |
|---|---|
| Codice di errore 603: nessun agente connesso | Verificare che l'agente Data Gateway sia in esecuzione. Se Data Gateway è installato su Linux: eseguire $ <directory di installazione di Data Gateway>/domain/bin/status.sh e verificare se lo stato di Data Gateway è UP o DOWN. Per gli agenti Data Gateway installati su Windows, verificare i processi "datagateway.exe" nella scheda Dettagli di Gestione attività. |
| Salvataggio della connessione non riuscito. Sono stati forniti dettagli di connessione non validi. Immettere i dettagli corretti e riprovare. | Questo errore viene visualizzato nella finestra di dialogo Connessione quando si crea una connessione a DB2 o a SQL Server.
Nella pagina Stato di un agente, appare anche Soluzione alternativa:
|
| JDSError: 110 - Stringa di connessione/URL all'origine esterna non valida/o | Verificare che l'agente Data Gateway possa connettersi all'origine dati. Ad esempio, se si esegue la connessione a un database Oracle, eseguire il test utilizzando "telnet <hostname> <port>" sul computer in cui è installato Data Gateway. |
| Nessuna colonna visualizzata | Eseguire l'upgrade dell'agente Data Gateway. In genere, questo problema si verifica se si utilizza un aggiornamento precedente dell'agente Data Gateway che non corrisponde all'aggiornamento di Oracle Analytics Cloud. |
| Opzione Usa connettività dati remota mancante |
Verificare che l'opzione Abilita gateway dati sia abilitata nella pagina Connettività dati remota della console. |
Problemi generali
| Problema segnalato | Operazioni da eseguire |
|---|---|
| Modifica dello stato dell'agente non riuscito con errore: nome agente o URL Oracle Analytics Cloud non specificato oppure coppia di chiavi non generata | Fare clic su Salva, quindi su Abilita. Se il problema persiste, riavviare l'applicazione. Se necessario, controllare la rete. |
| L'operazione di test ha restituito il messaggio di autenticazione non riuscita con errore: 401. Di seguito vengono indicate le cause possibili.
- La chiave dell'agente Data Gateway è stata copiata nella pagina Connettività dati remota nella console di Oracle Analytics Cloud. Ad esempio, è possibile che sia stato fatto clic sul pulsante Test prima di incollare la chiave nella pagina OAC > Console > Connettività dati remota. - La chiave dell'agente Data Gateway è stata rigenerata, ma la nuova chiave non è stata copiata nella pagina Connettività dati remota della console di Oracle Analytics Cloud. Ad esempio, è possibile che sia già stato registrato un agente Data Gateway nella pagina Connettività dati remota nella console, ma il relativo ID non corrisponde all'"ID" della chiave nella home page dell'agente Data Gateway. |
Se la chiave dell'agente Data Gateway non è stata copiata, incollarla nella console per registrare l'agente. Se la chiave dell'agente Data Gateway è stata rigenerata, eliminare l'agente nella console, quindi incollare la chiave nella console per registrare di nuovo l'agente. |
| L'operazione di salvataggio ha restituito il messaggio di autenticazione non riuscita con errore: 404.
Questo problema in genere si verifica quando l'istanza di Oracle Analytics è stata aggiornata. |
Vedere: - Guida all'utilizzo di Remote Data Gateway negli ambienti di cui è stato eseguito l'upgrade da Oracle Analytics Cloud 105.2 e versioni successive (ID doc 2574387.1) - Oracle Analytics Cloud - Classic: come abilitare Remote Data Gateway in un'istanza di Oracle Analytics Cloud-Classic gestita dal cliente di cui è stato eseguito l'upgrade dalla release 105.2 o precedente (ID doc 2632064.1). |
| Durante il test vengono restituiti: URL OAC non valido/Eccezione host sconosciuta o nessun errore/messaggio.
Di seguito vengono indicate le cause possibili. - È stato specificato un URL errato nella home page dell'agente Data Gateway. Ad esempio, è possibile che sia stato fornito un URL https://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/ui o https://oacinst-tenancy.analytics.ocp.oraclecloud.com/analytics. - Non è disponibile un instradamento di rete appropriato dall'agente Data Gateway all'istanza di Oracle Analytics Cloud. Ad esempio, è possibile che esista un server proxy per l'accesso a Internet e che un firewall stia bloccando l'accesso dall'agente Data Gateway a Oracle Analytics Cloud. Se non è richiesto un server proxy, verificare la connettività dal computer in cui Data Gateway è in esecuzione a Oracle Analytics Cloud. |
Se è stato specificato un URL errato nella home page dell'agente Data Gateway, aggiornare l'URL nel campo URL. Ad esempio, se l'URL di Oracle Analytics Cloud è Non è disponibile un instradamento di rete appropriato dall'agente Data Gateway all'istanza di Oracle Analytics Cloud: - Su Linux, eseguire il comando $ sudo traceroute -T -p 443 https://<instance details>.oraclecloud.com - Su Windows, eseguire il comando C:\> telnet https://<instance details>.oraclecloud.com 443. Se è richiesto un server proxy, verificare i dettagli proxy per Data Gateway. Vedere URL Oracle Analytics Cloud non valido (Data Gateway non è in grado di comunicare con Oracle Analytics Cloud). |
|
URL Oracle Analytics Cloud non valido (Data Gateway non è in grado di comunicare con Oracle Analytics Cloud) |
|
| Le prestazioni sono lente | Rivedere la pagina Log ed eseguire una ricerca in base ai seguenti elementi:
Una volta individuate le voci del log, fare clic su un job ed esaminare la finestra di dialogo Stato richiesta per visualizzare il tempo impiegato in millisecondi. Rivolgersi al team account vendita per conoscere le linee guida sul dimensionamento di Data Gateway. |
| Verifica non riuscita nella pagina della Console Connettività dati remota |
Se il test non riesce, l'agente Data Gateway non può eseguire l'autenticazione per vari motivi, inclusi quelli riportati di seguito.
|
