Configurazione e risoluzione dei problemi di Qlik Data Gateway - Direct Access

In questo argomento sono descritte le varie azioni che è possibile effettuare per configurare e risolvere i problemi di Gateway di Direct Access.

Configurazione di Gateway di Direct Access dal tenant Qlik Cloud

Mentre le impostazioni predefinite di Gateway di Direct Access sono appropriate per la maggior parte degli ambienti, potrebbe essere necessario sovrascrivere le impostazioni predefinite per migliorare le prestazioni, risolvere un problema (tramite le impostazioni di accesso) o superare diversi problemi di connettività.

Per poter modificare le impostazioni in Qlik Cloud, è necessario disporre di una delle seguenti autorizzazioni:

• Amministratore tenant e proprietario dello spazio del gateway

• Membro tenant con Può consumare dati nello spazio del gateway

Per aprire le impostazioni del gateway:

1. Nel tenant Qlik Cloud, andare a Amministrazione > Gateway dati e individuare Gateway di Direct Access.

2. Fare clic su alla fine della riga, quindi selezionare Impostazioni gateway,

   Si apre la finestra di dialogo Impostazioni gateway per <nome>.

   Le impostazioni sono suddivise nelle impostazioni generali (sotto) e impostazioni del connettore. Notare che la modifica delle impostazioni potrebbe anche richiedere il riavvio del servizio di Gateway di Direct Access.

Impostazioni generali

Queste impostazioni sono rilevanti per la funzionalità generale di Gateway di Direct Access, indipendentemente dal connettore che si utilizza.

ID agente

L'ID agente da usare con l'API pubblica di Gateway di Direct Access.

Porta agente connettore

La porta da utilizzare durante la connessione all'agente del connettore. Questa impostazione non può essere modificata.

Soglia di errore dell'integrità dell'agente del connettore

Vengono eseguiti controlli di integrità periodici nei componenti di Gateway di Direct Access. I controlli di integrità a volte non riescono all'inizio, e poi vengono completati correttamente. Se i controlli di integrità continuano a non riuscire dopo aver impostato la soglia specificata, il servizio di Gateway di Direct Access verrà riavviato. È necessario modificare questa impostazione solo su richiesta del Supporto Qlik.

Timeout richiesta 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 estendere il timeout a 5-10 minuti.

Livello di registro dell'agente del connettore

Per la risoluzione dei problemi, potrebbe essere necessario modificare il livello di accesso dei componenti dell'agente del connettore. È necessario modificare questa impostazione solo su richiesta del Supporto Qlik.

Opzioni di registro agente connettore

Per la risoluzione dei problemi con un componente specifico dell'agente del connettore, potrebbe essere necessario selezionare il file di registro corrispondente. È necessario modificare questa impostazione solo su richiesta del Supporto Qlik.

Memoria per i blocchi di dati nella 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). Questa operazione è utile soprattutto se non si utilizza il ripristino automatico e si riscontrano con frequenza gli errori 4025, 4020 e 4021. 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.

Soglia della durata per il recupero dei blocchi

È disponibile una soglia (in minuti) per la durata del recupero dei blocchi. Se il ricaricamento non è ripreso al raggiungimento della soglia per la durata del recupero, questo non verrà completato e verrà visualizzato un messaggio appropriato.

Questa opzione è utile per i ricaricamenti che altrimenti potrebbero superare il limite di tre ore, per il lungo recupero. Ad esempio, supponiamo che siano necessari 90 minuti per recuperare i dati dal database, ma non appena inizia il ricaricamento, uno dei blocchi diventa danneggiato. In questo caso, tutti i blocchi verranno memorizzati nella cache e inviati dalla cache. In uno scenario del genere, l'intero processo di ricaricamento (memorizzazione nella cache + ricaricamento effettivo) potrebbe richiedere tre ore per il completamento.

Porta DCaaS

La porta da utilizzare durante la connessione a DCaaS. Questa impostazione non può essere modificata.

Livello di registro DCaaS

Per la risoluzione dei problemi, potrebbe essere necessario modificare il livello di accesso dei registri DCaaS. È necessario modificare questa impostazione solo su richiesta del Supporto Qlik.

Impostazioni connettore

Per modificare le impostazioni del connettore, selezionare il tipo di connettore a sinistra, quindi modificare le impostazioni come necessario.

Porta

La porta da utilizzare quando si esegue la connessione alla sorgente dati. Questa impostazione non può essere modificata.

Livello di registro

Per la risoluzione dei problemi, potrebbe essere necessario modificare il livello di accesso dei registri del connettore. È necessario modificare questa impostazione solo su richiesta del Supporto Qlik.

Isolamento processo

L'isolamento del processo consente agli amministratori con accesso al sistema operativo del server di Gateway di Direct Access di controllare il numero di processi disponibili per i ricaricamenti in base al 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.

Con una nuova installazione, l'isolamento dei processi viene attivato per impostazione predefinita. Il numero predefinito di ricaricamenti simultanei per ogni tipo di connettore è 9. È possibile sovrascrivere le impostazioni predefinite come descritto nella sezione Numero di ricaricamenti simultanei.

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, selezionare Disattivato.

Numero processi di ricaricamento simultanei

Il numero di processi di ricaricamento simultanei allocati per il connettore, incluso il processo di comando. Quindi, per esempio, un valore pari a 30 significa un numero massimo di 29 ricaricamenti simultanei. Notare che questa impostazione è rilevante solo quando l'isolamento dei processi è abilitato.

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 in base alle necessità.

Numero massimo di tabelle da scaricare

Per impostazione predefinita, un massimo di 10.000 tabelle viene recuperato dal database. È possibile sovrascrivere i valori predefiniti quando il database ha più di 10.000 tabelle.

Riavviare Gateway di Direct Access dopo aver modificato le impostazioni

Alcune impostazioni saranno applicate solo dopo il riavvio del servizio di Gateway di Direct Access. In tal caso, all'utente verrà chiesto di riavviare il servizio quando si salvano le impostazioni. Se ci sono ricaricamenti attivi, non sarà possibile riavviare il servizio fino al loro completamento. Quando non vi sono ricaricamenti attivi, è possibile riavviare il servizio in qualsiasi momento come descritto di seguito:

1. Nel tenant Qlik Cloud, andare a Amministrazione > Gateway dati e individuare Gateway di Direct Access.

2. Fare clic su alla fine della riga, quindi selezionare Riavvia servizio.

È possibile anche riavviare il servizio direttamente sul computer di Gateway di Direct Access, come descritto in Avvio, arresto o riavvio del servizio.

Configurazione di Gateway di Direct Access direttamente sul computer di Gateway di Direct Access

Mentre la maggior parte delle impostazioni di Gateway di Direct Access può essere configurata in Qlik Cloud, alcune impostazioni possono essere modificate solo modificando i file di configurazione direttamente sul computer di Gateway di 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:

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

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

Vedere anche: Memoria per i blocchi di dati nella cache

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:

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

2. 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 di Qlik Cloud in 27.

    

3. Salvare il file custom_type_mapping.json e riavviare il servizio Qlik Data Gateway - Direct Access.
4. 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:

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

2. Aggiungere AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> alla sezione # Connector Agent all'inizio del file.

    

   Esempio:

   {
   "Identifier": "Amazon Athena ODBC (x64)",
   "NativeDataType": "timestamp with time zone",
   "QlikDataType": "DateTime",
   "Size": 27,
   "IsBit": false
   }

   AGENT_PONG_TIMEOUT_SECONDS=30

   Nota informaticaIl tempo minimo è di 30 secondi.
3. Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.

Esecuzione delle richieste di caricamento dati in modo asincrono

L'esecuzione delle richieste di caricamento dati in modo asincrono sull'agente riduce significativamente il tempo di attesa necessario del servizio cloud per le risposte dell'agente.

Per abilitare le richieste asincrone di Carica dati:

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

2. Aggiungere la seguente riga al file:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

3. Salvare il file configuration.properties.

Per disabilitare le richieste asincrone di Carica dati:

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

2. Sostituire AsyncLoadDataRequest con None come segue:

   OPTIONAL_CAPABILITIES=None

3. Salvare il file configuration.properties.

Consentire le connessioni a un host locale utilizzando il connettore REST (tramite Gateway di Direct Access)

È possibile consentire al connettore REST (tramite Gateway di Direct Access) di connettersi a un host locale. Ciò facilita l'uso di endpoint locali (al server del gateway), come l'uso dell'endpoint connector-agent/ status per determinare il numero attivo di caricamenti su un agente.

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

2. Impostare REST_ALLOW_LOCALHOST_CONNECTION=true (impostare su falso per disabilitare questa funzionalità)

3. Salvare il file configuration.properties.

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.

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,

   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 di 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 SQL (QvSAPBwConnector-<date + timestamp>)

   • Registri del connettore (connector-agent_logs_<date>)

   • Registri del connettore SAP ODP (QvSapConnectorPackage-<process_id>)

   • Registri del connettore REST (rest-connector_logs_<timestamp>)

   • Registri del connettore File (rest-connector_logs_<timestamp>)

   Nota informaticaA partire dalla versione 1.7.1 di Gateway di Direct Access, gli eventi di avvio, uscita e riavvio del connettore verranno scritti nel file di registro Gateway di Direct Access(DirectAccessAgent). Nelle versioni precedenti, questi venivano scritti nel file di registro Registri agente 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 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

Per ulteriori opzioni di registro, vedere la sezione Configurazione di Gateway di Direct Access in Qlik Cloud di seguito.

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.