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:

1. Nel centro attività Amministrazione, andare a Gateway dati e individuare il Gateway di Direct Access.

2. Fare clic su alla fine della riga, quindi selezionare Visualizza registri,

   quindi viene visualizzata la finestra del visualizzatore log.

3. 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>)

4. 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 su per passare alla fine del file di registro, che verrà aggiornato con gli ultimi messaggi.

5. 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 dei dettagli di accesso

È possibile visualizzare e modificare il livello di dei dettagli di accesso dei registri Gateway di Direct Access (DirectAccessAgent), come necessario. Per farlo, eseguire i seguenti comandi dalla sottocartella di 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:

1. 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).

2. Eseguire i comandi seguenti:

   • Generare la nuova chiave:

     connectoragent qcs generate_keys

   • Mostrare la chiave:

     connectoragent qcs get_registration

     Chiave visualizzata:

     

3. Copiare l'intera chiave come mostrato nell'esempio precedente.

4. Nel centro attività Amministrazione, aprire le impostazioni del gateway dati facendo clic sul pulsante alla fine della riga corrispondente e selezionando Modifica.

5. Incollare la chiave nel campo Chiave (in sostituzione della chiave corrente) e salvare le impostazioni.

6. 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:

1. 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.

2. Individuare il parametro ODBC_RELOAD_SESSION_LIFE e aumentarne il valore in base alle necessità.
3. 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:

1. 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.

2. Individuare il parametro EXTEND_FIRST_REQUEST_TIMEOUT e aumentarne il valore a 5-10 minuti. Il valore predefinito è 0.
3. 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.

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:

1. 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.

2. Impostare [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Colora tutte le righe per condizione) su None (Righe specificate).

3. 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:

1. 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>.

2. 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.

3. 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

 

A partire dalla versione 1.6.7 del Gateway di Direct Access, il valore MAX_PROCESS_COUNT può superare il numero 10 senza dover modificare altre impostazioni. Per isolare completamente i ricaricamenti con un particolare tipo di connettore (cioè non più di un ricaricamento per processo di connettore), questo valore dovrebbe essere impostato su un minimo di 30, ma potrebbe essere necessario impostarlo fino a 60 a seconda del carico di lavoro.

Archiviazione di blocchi di dati danneggiati o mancanti per il ricaricamento futuro

Per ogni operazione di ricaricamento, il Gateway di Direct Access può archiviare i blocchi di dati danneggiati o mancanti in memoria ed eseguire l'offload sul disco. 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 o mancanti 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:

1. 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.

2. Impostare RELOAD_CACHE_MEMORY_MB su N (il valore predefinito è 0, ossia la funzionalità non è abilitata).

   Dove:

   N = le dimensioni che può raggiungere il blocco di dati prima che venga ricaricato.

   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.
3. Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.