Vai al contenuto principale Passa a contenuto complementare

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.

Nota informaticaPer visualizzare e scaricare i registri, è necessario disporre del ruolo È possibile consumare dati.

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 Altro 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 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 Freccia per scorrere verso l'alto e Freccia per scorrere fino in fondo 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 Freccia per scorrere fino in fondo 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

Nota di avvisoModificare il livello di accesso solo nel caso in cui venga richiesto da un rappresentante del Supporto Qlik.

È 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:

  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 > Voci nascoste sia selezionata.
  2. Individuare la proprietà <COMPONENT>_LOG_LEVEL, dove COMPONENT può esseree uno dei seguenti:

    • AGENT
    • DCAAS
    • ODBC
    • SAPBW
    • SAPSQL
    • SAPPACKAGE
    • FILE
  3. Impostarlo su uno dei seguenti valori: ERROR, WARN, INFO o DEBUG.
  4. 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:

  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:

      Immagine della chiave di registrazione di Direct Access

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

Nota informaticaL'unità di misura per il valore del parametero sono i 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.

Nota informatica

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.

Nota informaticaCon 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 modificare le impostazioni predefinite come descritto nella sezione Attivazione dell'isolamento dei processi o modifica del numero di ricaricamenti simultanei di seguito.

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

 

Nota informaticaA 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.

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.

Nota informaticaRichiede il Gateway di Direct Access 1.6.8 o versione successiva.

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 = 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.
  3. Salvare il file configurazione.properties e riavviare il servizio Qlik Data Gateway - Direct Access.
Nota informaticaPer evitare i problemi di degrado delle prestazioni dovuto all'accumulo di file non necessari, i blocchi di dati elaborati verranno eliminati dalla memoria del computer e dal disco.

Sostituzione della directory dei blocchi predefiniti della cache

Nota informaticaRichiede Gateway di Direct Access 1.7.1 o versione successiva

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.

Nota informaticaPer garantire la stabilità e ottimizzare le prestazioni, la prassi migliore è quella di utilizzare solo percorsi locali.

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.

Sostituzione del tipo di dati predefinito di Qlik Cloud quando si utilizza il connettore ODBC (tramite Gateway di Direct Access).

Nota informaticaRichiede Gateway di Direct Access 1.7.1 o versione successiva

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

Nota di avvisoSebbene molti problemi possano essere risolti semplicemente modificando QlikDataType in String, se non è possibile farlo, consigliamo di contattare il Supporto di Qlik per ottenere indicazioni sui tipi di dati Qlik Cloud su cui è possibile mappare il tipo di dati di origine.

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

    {

    "Identifier": "Amazon Athena ODBC (x64)",

    "NativeDataType": "timestamp with time zone",

    "QlikDataType": "DateTime",

    "Size": 27,

    "IsBit": false

    }

  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:

    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.

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.

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!