Risoluzione dei problemi Gateway di Direct Access
In questa sezione sono descritte le varie azioni che è possibile effettuare per risolvere i problemi in Gateway di Direct Access.
Visualizzazione e download dei file di registro
I file di registro forniscono informazioni sulle operazioni di Gateway di Direct Access. Qlik Per la risoluzione dei problemi, il team di supporto può chiedere di fornire questi file di registro. È possibile visualizzare o scaricare i file di registro nel visualizzatore log. In circostanze normali, non vi è alcuna ragione per esaminare i file di registro, ma se si verificano errori ripetuti o altri problemi, i file di registro spesso aiutano a individuare la causa.
Per aprire il visualizzatore log:
-
Nel centro attività Amministrazione, andare a Gateway dati e individuare il Gateway di Direct Access.
-
Fare clic su
alla fine della riga, quindi selezionare Visualizza registri,
Viene visualizzata la finestra del Visualizzatore log.
-
Dall'elenco a discesa in alto a sinistra, scegliere il tipo di registro che il team di supporto di Qlik ha chiesto di visualizzare o scaricare.
Sono disponibili i seguenti registri:
- Registri Gateway di Direct Access (DirectAccessAgent)
- Registri DCaaS (dcaas_logs)
- Registri del connettore basato su ODBC (odbc-connector_logs)
- Registri del connettore SAP BW (QvSAPBwConnector-<date + timestamp>)
- Registri del connettore SAP ODP (QvSapConnectorPackage-<process_id>)
- Registri del connettore SAP SQL (QvSAPBwConnector-<date + timestamp>)
- Registri del connettore (connector-agent_logs_<date>)
-
Dall'elenco a discesa adiacente, selezionare il registro che si desidera visualizzare o scaricare. I file di registro sono ordinati dal più recente (il file di registro attualmente attivo) al più vecchio. Una volta selezionato il file di registro, è possibile utilizzare i pulsanti
e
per andare all'inizio o alla fine, rispettivamente.
Nota di suggerimentoLa visualizzazione del file di registro non viene aggiornata automaticamente con gli ultimi messaggi. Per aggiornare la vista, fare clic super passare alla fine del file di registro, che verrà aggiornato con gli ultimi messaggi.
-
Per scaricare il file di registro, fare clic su Scarica.
Il file verrà scaricato sul computer o verrà visualizzato un messaggio che richiede all'utente di salvarlo, a seconda delle impostazioni del browser utilizzato.
Apertura dei registri Gateway di Direct Access sul computer Gateway di Direct Access
Oltre a poter scaricare i registri del Gateway di Direct Access (DirectAccessAgent) dal centro attività Amministrazione, è possibile anche aprirli direttamente dal computer del Gateway di Direct Access. Con un'installazione predefinita, questi registri si trovano in:
C:\Program Files\Qlik\ConnectorAgent\data\logs
Modifica del livello di accesso
È possibile modificare il livello di accesso dei registri del Gateway di Direct Access come descritto di seguito.
Modifica del livello di accesso dei componenti del connettore
Per la risoluzione dei problemi, potrebbe essere necessario modificare il livello di accesso dei registri per i componenti del connettore.
Per farlo:
- Aprire il file C:\ProgramData\Qlik\Gateway\configuration.properties con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra > Voci nascoste sia selezionata.
-
Individuare la proprietà <COMPONENT>_LOG_LEVEL, dove COMPONENT può esseree uno dei seguenti:
- AGENT
- DCAAS
- ODBC
- SAPBW
- SAPSQL
- SAPPACKAGE
- FILE
- Impostarlo su uno dei seguenti valori: ERROR, WARN, INFO o DEBUG.
-
Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Nota informaticaA partire da Gateway di Direct Access 1.7.1, se si è modificato solo il componente AGENT, non è necessario riavviare il servizio Qlik Data Gateway - Direct Access.
Modifica del livello di accesso DirectAccessAgent
Per la risoluzione dei problemi, potrebbe essere necessario modificare il livello di accesso dei registri DirectAccessAgent. DirectAccessAgent è responsabile della connessione ai servizi Qlik Cloud. Per visualizzare e modificare il livello dei dettagli dei registri DirectAccessAgent, eseguire i seguenti comandi dalla sottocartella ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita).
-
Per visualizzare il livello di registrazione corrente, eseguire:
connectoragent configuration getloggers -
Per impostare il livello di registrazione in Traccia, eseguire:
connectoragent configuration setloggers -l Root -v DEBUG -
Per impostare il livello di registrazione in Dettagliata, eseguire:
connectoragent configuration setloggers -l Root –v DETAILED_DEBUG
Aggiornamento della chiave di registrazione
La modifica della chiave di registrazione potrebbe essere necessaria nell'improbabile caso in cui la chiave sia danneggiata o se si sospetta che il server del gateway dati sia stato visitato da un utente non autorizzato.
Per aggiornare la chiave di registrazione:
- Sul server del gateway Accesso diretto, aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita).
-
Eseguire i comandi seguenti:
-
Generare la nuova chiave:
connectoragent qcs generate_keys
-
Mostrare la chiave:
connectoragent qcs get_registration
Chiave visualizzata:
-
-
Copiare l'intera chiave come mostrato nell'esempio precedente.
-
Nel centro attività Amministrazione, aprire le impostazioni del gateway dati facendo clic sul pulsante
alla fine della riga corrispondente e selezionando Modifica.
-
Incollare la chiave nel campo Chiave (in sostituzione della chiave corrente) e salvare le impostazioni.
-
Tornare al server del gateway Accesso diretto e riavviare il servizio Qlik Data Gateway - Direct Access, come descritto in Gestione del servizio Qlik Data Gateway - Direct Access.
Estensione della durata delle sessioni di ricaricamento
Se la connessione tra Gateway di Direct Access e Qlik Cloud è inattiva per 20 secondi o più, l'operazione di ricaricamento a volte non veniva completata con il seguente errore:
Invalid object name '#<TempTableName>' (indicating that the Gateway di Direct Access temp tables are unavailable).
La durata predefinita della sessione è di 20 secondi, ma qualora questo errore si verificasse di frequente, è possibile estendere la sessione come descritto di seguito:
-
Aprire il file C:\ProgramData\Qlik\Gateway\configuration.properties con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra file, cartelle e driver nascosti sia selezionata.
- Individuare il parametro ODBC_RELOAD_SESSION_LIFE e aumentarne il valore in base alle necessità.
- Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Estensione del timeout per le richieste di caricamento
Quando si verificano delle interruzioni di rete, i ricaricamenti potrebbero non riuscire generando i seguenti errori:
Connector error: The session does not exist (DirectAccess-1509)
Connector error: The stream session expired for the load data request (DirectAccess-1012)
Se si rilevano di frequente gli errori riportati sopra, provare a impostare il parametro EXTEND_FIRST_REQUEST_TIMEOUT su 5-10 minuti.
Operazione da eseguire:
-
Aprire il file C:\ProgramData\Qlik\Gateway\configuration.properties con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra file, cartelle e driver nascosti sia selezionata.
- Individuare il parametro EXTEND_FIRST_REQUEST_TIMEOUT e aumentarne il valore a 5-10 minuti. Il valore predefinito è 0.
- Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Attenuare gli arresti del connettore durante il caricamento
L'isolamento del processo consente agli amministratori con accesso diretto al sistema operativo del server del gateway di controllare il numero di processi disponibili per i ricaricamenti per tipo di connettore. I ricaricamenti della distribuzione di processi multipli del connettore aumenta il livello di isolamento riducendo il numero di ricaricamenti in esecuzione attualmente su ogni processo del connettore. Questo, a sua volta, può migliorare la stabilità generale di Gateway di Direct Access nei casi in cui il connettore generava errori.
Richiede Gateway di Direct Access 1.6.1 o versione successiva.
Disattivazione dell'isolamento dei processi
Il Supporto Qlik potrebbe chiedere di disattivare l'isolamento dei processi allo scopo di risolvere i problemi.
Per disattivare l'isolamento dei processi:
- Aprire il file C:\ProgramData\Qlik\Gateway\configurazione.properties. Se per farlo dsi utilizza Windows Explorer, assicurarsi che l'opzione Mostra file, cartelle e driver nascosti sia selezionata.
-
Impostare [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Colora tutte le righe per condizione) su None (Righe specificate).
- Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Attivazione dell'isolamento dei processi o modifica del numero di ricaricamenti simultanei
Per attivare l'isolamento dei processi o modificare il numero di ricaricamenti simultanei, fare quanto segue:
-
Aprire il file C:\ProgramData\Qlik\Gateway\configuration.properties con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra file, cartelle e driver nascosti sia selezionata.
Il file contiene tre prefissi, che corrispondono ai differenti tipi di connettori: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> e SAPPACKAGE_<property-name>.
-
Impostare [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE su Load e [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT su N.
Dove:
N = un processo di comando + il numero di processi di ricaricamento simultanei da assegnare. Quindi, per esempio, un valore pari a 10 significa un numero massimo di 9 ricaricamenti simultanei.
- Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Esempi di isolamento dei processi per il connettore ODBC
L'estratto seguente del file configuration.properties mostra come abilitare l'isolamento dei processi per il connettore ODBC per un massimo di 12 ricaricamenti:
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=13
Memorizzazione nella cache dei dati per ricaricarli in caso di problemi
Per ogni operazione di ricarica, il Gateway di Direct Access può memorizzare nella cache i dati in memoria e scaricarli su disco (quando le dimensioni allocate per la cache vengono superate). Questa operazione è utile soprattutto se non si utilizza il ripristino automatico e si riscontrano con frequenza gli errori 4025, 4020 e 4021. È possibile attivare questa funzionalità impostando la soglia per le dimensioni della cache per l'offload dei blocchi di dati danneggiati su disco (per ogni ricaricamento). Quando viene raggiunta la soglia specificata, il gateway eseguirà l'offload del blocco di dati crittografato successivo sul disco del computer del Gateway di Direct Access.
Per impostare le dimensioni della cache:
-
Aprire il file C:\ProgramData\Qlik\Gateway\configuration.properties con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra file, cartelle e driver nascosti sia selezionata.
-
Impostare RELOAD_CACHE_MEMORY_MB su N (il valore predefinito è 0, ossia la funzionalità non è abilitata).
Dove:
N = La quantità di memoria allocata per la memorizzazione nella cache di blocchi di dati (per ogni ricarica)
Nota informaticaSe si abilita questa funzionalità, l'utilizzo della memoria sul computer del Gateway di Direct Access aumenterà, quindi si consiglia di monitorare l'impatto sulla memoria mentre l'opzione è abilitata. L'impostazione del valore RELOAD_CACHE_MEMORY_MB su 100 dovrebbe essere sufficiente per la maggior parte delle situazioni. - Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Sostituzione della directory dei blocchi predefiniti della cache
Per ogni operazione di ricarica, il Gateway di Direct Access può memorizzare nella cache i dati in memoria e scaricarli su disco (quando le dimensioni allocate per la cache vengono superate). È possibile ignorare la directory predefinita della cache dei blocchi (C:\ProgramData\Qlik\Gateway\tmp) se non si dispone di spazio sufficiente sul disco di sistema.
Per farlo:
- Utilizzando un editor di testo, aprire il file C:\ProgramData\Qlik\Gateway\configuration.properties con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra > Voci nascoste sia selezionata.
-
Individuare la proprietà OVERRIDE_CHUNKS_CACHE_DIR e impostarla sulla directory desiderata.
Esempio:
OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp
Nota informaticaNon racchiudere il percorso tra virgolette. - Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Sostituzione del tipo di dati predefinito di Qlik Cloud quando si utilizza il connettore ODBC (tramite Gateway di Direct Access).
A volte, a causa di un problema con la gestione dei tipi di dati di origine da parte del driver ODBC del fornitore, si può verificare un errore durante il ricaricamento o i dati errati possono essere caricati su Qlik Cloud. In questi casi, è possibile sovrascrivere il tipo di dati Qlik Cloud o le sue specifiche (scala o precisione, ad esempio).
Per farlo:
- Utilizzando un editor di testo, aprire il file C:\ProgramData\Qlik\Gateway\custom_type_mapping.json con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra > Voci nascoste sia selezionata. Questo file contiene un esempio di sorgente per i tipi di dati Qlik Cloud.
-
Aggiungere una sezione che mappi il tipo di dati problematico al tipo di dati desiderato di Qlik Cloud.
Nell'esempio seguente (che è incluso nel file custom_type_mapping.json ), il cliente deve modificare la dimensione del tipo di dati DateTime Qlik Cloud in 27.
{
"Identifier": "Amazon Athena ODBC (x64)",
"NativeDataType": "timestamp with time zone",
"QlikDataType": "DateTime",
"Size": 27,
"IsBit": false
}
- Salvare il file custom_type_mapping.json e riavviare il servizio Qlik Data Gateway - Direct Access.
- Ricaricare i dati.
Forzare la riconnessione di Gateway di Direct Access a Qlik Cloud
Per impostazione predefinita, se Gateway di Direct Access si disconnette da Qlik Cloud, questo dovrebbe riconnettersi dopo 45 secondi. Se si nota che impiega molto più tempo, è possibile forzare il gateway a riconnettersi prima.
Per farlo:
- Utilizzando un editor di testo, aprire il file C:\ProgramData\Qlik\Gateway\configuration.properties con il ruolo di amministratore. Se per farlo si utilizza Windows Explorer, assicurarsi che l'opzione Mostra > Voci nascoste sia selezionata. Questo file contiene un esempio di sorgente per i tipi di dati Qlik Cloud.
-
Aggiungere AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> alla sezione # Connector Agent all'inizio del file.
Esempio:
AGENT_PONG_TIMEOUT_SECONDS=30
Nota informaticaIl tempo minimo è di 30 secondi. - Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Aumentare i dettagli dei messaggi di errore quando ci si connette alle sorgenti dati ODBC.
Per motivi di sicurezza, il messaggio di errore predefinito restituito dal driver ODBC contiene informazioni minime. Tuttavia, in alcuni scenari, potrebbero essere necessarie maggiori informazioni per risolvere un problema specifico. Per visualizzare un messaggio di errore più dettagliato, aggiungere la proprietà ShowErrorDetailMessage alla sezione Avanzate della finestra di dialogo del connettore e impostarla su True. Una volta risolto il problema, per una sicurezza ottimale, si consiglia vivamente di eliminare la proprietà o di impostarla su False.