Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Fehlerbehebung Direct Access Gateway

In diesem Abschnitt werden verschiedene Aktionen beschrieben, die Sie zur Fehlerbehebung in Direct Access Gateway anwenden können.

Anzeigen und Herunterladen von Protokolldateien

Die Protokolldateien bieten Informationen über Vorgänge für Direct Access Gateway. Qlik Der Support bittet Sie möglicherweise darum, diese Protokolle zur Fehlerbehebung bereitzustellen. Sie können die Protokolldateien im Protokoll-Viewer anzeigen oder herunterladen. Unter normalen Umständen ist es nicht erforderlich, die Protokolldateien zu prüfen. Wenn aber häufig Ausfälle oder andere Probleme auftreten, können die Protokolldateien bei der Ursachenermittlung helfen.

InformationshinweisZum Anzeigen und Herunterladen der Protokolle ist die Rolle Kann Daten nutzen erforderlich.

So öffnen Sie den Protokoll-Viewer:

  1. Gehen Sie im Aktivitätscenter Verwaltung zu Daten-Gateways und suchen Sie nach Ihrem Direct Access Gateway.

  2. Klicken Sie auf die Schaltfläche Mehr am Ende der Zeile und wählen Sie Protokolle anzeigen aus.

    Das Fenster Protokoll-Viewer wird geöffnet.

  3. Wählen Sie aus der Dropdown-Liste oben links den Protokolltyp aus, den Ihnen der Qlik Support genannt hat, um ihn anzuzeigen oder herunterzuladen.

    Folgende Protokolle sind verfügbar:

    • Direct Access Gateway-Protokolle (DirectAccessAgent)
    • DCaaS-Protokolle (dcaas_logs)
    • ODBC-basierte Konnektorprotokolle (odbc-connector_logs)
    • SAP BW-Konnektorprotokolle (QvSAPBwConnector-<Datum + Zeitstempel>)
    • SAP ODP-Konnektorprotokolle (QvSapConnectorPackage-<prozess_id>)
    • SAP SQL-Konnektorprotokolle (QvSqlBwConnector-<Datum + Zeitstempel>)
    • Konnektor-Agent-Protokolle (connector-agent_logs_<Datum>)
  4. Wählen Sie aus der danebenliegenden Dropdown-Liste das Protokoll aus, das Sie anzeigen oder herunterladen möchten. Die Protokolldateien sind von der neuesten (der derzeit aktiven Protokolldatei) bis zur ältesten sortiert. Nachdem Sie eine Protokolldatei ausgewählt haben, können Sie die Schaltflächen Pfeil zum Scrollen nach oben und Pfeil zum Scrollen nach unten verwenden, um zum Anfang bzw. zum Ende der Protokolldatei zu springen.

    TipphinweisDie Ansicht der Protokolldatei wird nicht automatisch mit den neuesten Meldungen aktualisiert. Um die Ansicht zu aktualisieren, klicken Sie auf Pfeil zum Scrollen nach unten, um zum Ende der Protokolldatei zu springen, die mit den neuesten Meldungen aktualisiert wurde.
  5. Zum Herunterladen der Protokolldatei klicken Sie auf Herunterladen.

    Abhängig von Ihren Browsereinstellungen wird die Datei entweder auf Ihren Computer heruntergeladen, oder Sie werden aufgefordert, sie zu speichern.

Öffnen von Direct Access Gateway-Protokollen auf dem Direct Access Gateway-Computer

Sie können die Direct Access Gateway-Protokolle (DirectAccessAgent) nicht nur vom Aktivitätscenter Verwaltung herunterladen, sondern sie auch direkt auf dem Direct Access Gateway-Computer öffnen. In einer Standardinstallation befinden sich diese Protokolle in folgendem Verzeichnis:

C:\Programme\Qlik\ConnectorAgent\data\logs

Ändern der Protokollierungsstufe

WarnhinweisÄndern Sie die Protokollierungsstufe nur, wenn Sie von einem Qlik Supportmitarbeiter dazu aufgefordert werden.

Sie können die Protokollierungsstufe der Direct Access Gateway-Protokolle wie unten beschrieben ändern.

Ändern der Protokollierungsstufe von Konnektorkomponenten

Zur Fehlerbehebung müssen Sie möglicherweise die Protokollierungsstufe der Protokolle der Konnektorkomponenten ändern.

Gehen Sie hierzu wie folgt vor:

  1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Anzeigen > Ausgeblendete Elemente aktiviert ist.
  2. Suchen Sie die Eigenschaft <COMPONENT>_LOG_LEVEL, wobei COMPONENT einer der folgenden Werte sein kann:

    • AGENT
    • DCAAS
    • ODBC
    • SAPBW
    • SAPSQL
    • SAPPACKAGE
    • FILE
  3. Legen Sie einen der folgenden Werte fest: ERROR, WARN, INFO oder DEBUG
  4. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

    InformationshinweisWenn Sie nur die Komponente AGENT geändert haben, müssen Sie ab Direct Access Gateway 1.7.1 den Dienst Qlik Data Gateway - Direct Access nicht mehr neu starten.

Ändern der Protokollierungsstufe für DirectAccessAgent

Zur Fehlerbehebung müssen Sie möglicherweise die Protokollierungsstufe der Protokolle von DirectAccessAgent ändern. DirectAccessAgent ist für die Verbindung zu Qlik Cloud Diensten zuständig. Um die Protokollierungsebene der DirectAccessAgent-Protokolle anzuzeigen und zu ändern, führen Sie die folgenden Befehle über den Unterordner ConnectorAgent (C:\Programme\Qlik\ConnectorAgent\ConnectorAgent für eine Standardinstallation) aus:

  • Um die aktuelle Protokollierungsstufe anzuzeigen, führen Sie folgenden Befehl aus:

    connectoragent configuration getloggers
  • Um die Protokollierungsstufe auf „Verfolgen“ festzulegen, führen Sie folgenden Befehl aus:

    connectoragent configuration setloggers -l Root -v DEBUG
  • Um die Protokollierungsstufe auf „Ausführlich“ festzulegen, führen Sie folgenden Befehl aus:

    connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Aktualisieren des Registrierungsschlüssels

Das Ändern des Registrierungsschlüssels kann in dem unwahrscheinlichen Fall erforderlich werden, dass der Schlüssel beschädigt wird, oder wenn Sie vermuten, dass von einem unbefugten Benutzer auf den Daten-Gateway-Server zugegriffen wurde.

So aktualisieren Sie den Registrierungsschlüssel:

  1. Öffnen Sie auf dem Server des Gateways für direkten Zugriff eine Eingabeaufforderung als Administrator und ändern Sie das Arbeitsverzeichnis in den Unterordner ConnectorAgent (C:\Programme\Qlik\ConnectorAgent\ConnectorAgent für eine Standardinstallation).
  2. Führen Sie die folgenden Befehle aus:

    • Generieren Sie den neuen Schlüssel:

      connectoragent qcs generate_keys

    • Zeigen Sie den Schlüssel an:

      connectoragent qcs get_registration

      Der Schlüssel wird angezeigt:

      Bild des Direct Access-Registrierungsschlüssels

  3. Kopieren Sie den vollständigen Schlüssel, wie im obigen Beispiel gezeigt.

  4. Öffnen Sie im Aktivitätscenter Verwaltung die Daten-Gateway-Einstellungen, indem Sie auf die Schaltfläche Mehr am Ende der betreffenden Zeile klicken und Bearbeiten auswählen.

  5. Fügen Sie den Schlüssel in das Feld Schlüssel ein (wodurch Sie den aktuellen Schlüssel ersetzen) und speichern Sie die Einstellungen.

  6. Kehren Sie zum Server des Gateways für direkten Zugriff zurück und starten Sie den Qlik Data Gateway - Direct Access-Dienst neu, wie in Verwalten des Qlik Data Gateway - Direct Access-Dienstes beschrieben.

Verlängern der Ladesitzungsdauer

Wenn die Verbindung zwischen Direct Access Gateway und Qlik Cloud für 20 Sekunden oder länger inaktiv ist, kann der Ladevorgang manchmal mit folgendem Fehler fehlschlagen:

Invalid object name '#<TempTableName>' (indicating that the Direct Access Gateway temp tables are unavailable).

Die Standardsitzungsdauer beträgt 20 Sekunden, aber wenn dieser Fehler häufig auftritt, können Sie die Sitzungsdauer wie folgt verlängern:

  1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

  2. Suchen Sie nach dem Parameter ODBC_RELOAD_SESSION_LIFE und erhöhen Sie seinen Wert wie erforderlich.
  3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Verlängern der Zeitüberschreitung für Ladeanforderungen

Wenn Netzwerkunterbrechungen auftreten, können Ladevorgänge mit den folgenden Fehlern fehlschlagen:

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

Wenn Sie häufig die oben genannten Fehler sehen, versuchen Sie, den Parameter EXTEND_FIRST_REQUEST_TIMEOUT auf 5-10 Minuten zu setzen.

InformationshinweisDie Maßeinheit für den Parameterwert ist Minuten.

Gehen Sie wie folgt vor:

  1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

  2. Suchen Sie nach dem Parameter EXTEND_FIRST_REQUEST_TIMEOUT und erhöhen Sie seinen Wert auf 5-10 Minuten. Der Standardwert ist „0“.
  3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Abmildern der Auswirkung von Konnektorabstürzen bei Ladevorgängen

Prozessisolierung ermöglicht Administratoren mit direktem Zugriff auf das Betriebssystem des Gateway-Servers zu steuern, wie viele Prozesse pro Konnektortyp für Ladevorgänge verfügbar sind. Wenn Ladevorgänge auf mehrere Konnektorprozesse verteilt werden, erhöht dies die Isolationsstufe, indem die Anzahl der gleichzeitig laufenden Ladevorgänge für die einzelnen Konnektorprozesse reduziert wird. Dadurch kann sich die allgemeine Stabilität von Direct Access Gateway in Fällen verbessern, in denen Konnektorabstürze aufgetreten waren.

Informationshinweis

Erfordert Direct Access Gateway 1.6.1 oder höher.

Deaktivieren der Prozessisolierung

Der Qlik-Support kann Sie bitten, die Prozessisolierung zur Fehlerbehebung zu deaktivieren.

InformationshinweisBei einer Neuinstallation ist die Prozessisolierung standardmäßig aktiviert. Die Standardanzahl der gleichzeitigen Ladevorgänge für jeden Konnektortyp beträgt 9. Sie können die Standardwerte wie unter Aktivieren der Prozessisolierung oder Ändern der Anzahl gleichzeitiger Ladevorgänge beschrieben ändern.

So deaktivieren Sie die Prozessisolierung:

  1. Öffnen Sie die Datei C:\ProgramData\Qlik\Gateway\configuration.properties. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.
  2. Legen Sie [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE auf None fest.

  3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Aktivieren der Prozessisolierung oder Ändern der Anzahl gleichzeitiger Ladevorgänge

So aktivieren Sie die Prozessisolierung oder ändern die Anzahl gleichzeitiger Ladevorgänge:

  1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

    Die Datei enthält drei Präfixe, die den verschiedenen Konnektortypen entsprechen: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> und SAPPACKAGE_<property-name>.

  2. Legen Sie [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE auf Load und [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT auf N fest.

    Hierbei gilt:

    N = Ein Befehlsprozess + die Anzahl der gleichzeitigen Ladevorgänge, die zugewiesen werden müssen. Beispielsweise bedeutet ein Wert von 10 maximal 9 gleichzeitige Ladevorgänge.

  3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Beispiele für die ODBC-Konnektor-Prozessisolierung

Der folgende Auszug aus der Datei configuration.properties zeigt, wie die ODBC-Konnektor-Prozessisolierung für bis zu 12 Ladevorgänge aktiviert wird:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

InformationshinweisAb Direct Access Gateway Version 1.6.7 kann der Wert MAX_PROCESS_COUNT 10 überschreiten, ohne dass andere Einstellungen geändert werden müssen. Um Ladevorgänge mit einem bestimmten Konnektortyp vollständig zu isolieren (d. h. nicht mehr als ein Ladevorgang pro Konnektorprozess), sollte dieser Wert auf ein Minimum von 30 gesetzt werden, aber je nach Arbeitslast kann es auch erforderlich sein, ihn auf einen höheren Wert von bis zu 60 zu setzen.

Zwischenspeichern von Daten zum Neuladen im Fall eines Problems

Bei jedem Ladevorgang kann Direct Access Gateway Datenblöcke im Arbeitsspeicher zwischenspeichern und auf die Festplatte auslagern (wenn die für das Zwischenspeichern zugewiesene Größe überschritten wird). Das ist besonders hilfreich, wenn Sie keine automatische Wiederherstellung nutzen und häufig die Fehler 4025, 4020 und 4021 auftreten. Sie aktivieren diese Funktion, indem Sie den Schwellenwert der Cache-Größe für das Auslagern von Datenblöcken auf die Festplatte (pro Ladevorgang) festlegen. Wenn der angegebene Schwellenwert erreicht ist, lagert das Gateway die nächsten verschlüsselten Blöcke auf die Festplatte des Direct Access Gateway-Computers aus.

InformationshinweisErfordert Direct Access Gateway 1.6.8 oder höher.

So legen Sie die Zwischenspeichergröße fest:

  1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

  2. Legen Sie RELOAD_CACHE_MEMORY_MB auf N fest (der Standardwert ist 0, was bedeutet, dass die Funktion nicht aktiviert ist).

    Hierbei gilt:

    N = Die Menge an Arbeitsspeicher, die für das Zwischenspeichern von Datenblöcken zugewiesen wird (pro Ladevorgang)

    InformationshinweisWenn Sie diese Funktion aktivieren, erhöht sich die Arbeitsspeichernutzung auf dem Direct Access Gateway-Computer. Daher wird empfohlen, die Auswirkung auf den Arbeitsspeicher zu überwachen, während die Funktion aktiviert ist. Die Einstellung des Werts RELOAD_CACHE_MEMORY_MB auf 100 sollte für die meisten Situationen genügen.
  3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.
InformationshinweisUm einen Leistungsabfall aufgrund der Anhäufung nicht benötigter Dateien zu verhindern, werden verarbeitete Datenblöcke aus dem Arbeitsspeicher und der Festplatte des Computers gelöscht.

Überschreiben des standardmäßigen Zwischenspeicherverzeichnisses für Datenblöcke

InformationshinweisErfordert Direct Access Gateway 1.7.1 oder höher.

Bei jedem Ladevorgang kann Direct Access Gateway Datenblöcke im Arbeitsspeicher zwischenspeichern und auf die Festplatte auslagern (wenn die für das Zwischenspeichern zugewiesene Größe überschritten wird). Sie können das standardmäßige Zwischenspeicherverzeichnis für Datenblöcke (C:\ProgramData\Qlik\Gateway\tmp) überschreiben, wenn Sie nicht genügend Speicherplatz auf dem Systemlaufwerk haben.

InformationshinweisUm die Stabilität zu gewährleisten und die Leistung zu optimieren, empfiehlt es sich, nur lokale Pfade zu verwenden.

Gehen Sie wie folgt vor:

  1. Öffnen Sie in einem Texteditor C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Anzeigen > Ausgeblendete Elemente aktiviert ist.
  2. Suchen Sie die Eigenschaft OVERRIDE_CHUNKS_CACHE_DIR und legen Sie sie auf das gewünschte Verzeichnis fest.

    Beispiel:

    OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

    InformationshinweisSchließen Sie den Pfad nicht in Anführungszeichen ein.
  3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Überschreiben des Qlik Cloud-Standarddatentyps bei der Arbeit mit dem Konnektor ODBC (über Direct Access Gateway).

InformationshinweisErfordert Direct Access Gateway 1.7.1 oder höher.

Manchmal kommt es aufgrund eines Problems bei der Handhabung von Quelldatentypen durch den ODBC-Treiber des Anbieters zu einem Fehler während des Ladevorgangs oder es werden falsche Daten in Qlik Cloud geladen. In solchen Fällen können Sie den Qlik Cloud Datentyp oder seine Spezifikation (z. B. Dezimalstellen oder Genauigkeit) überschreiben.

WarnhinweisViele Probleme können gelöst werden, indem Sie QlikDataType einfach in String ändern. Wenn dies nicht möglich ist, empfehlen wir Ihnen, sich an den Qlik Support zu wenden, um zu erfahren, welchen Qlik Cloud Datentypen der Quelldatentyp zugeordnet werden kann.

Gehen Sie wie folgt vor:

  1. Öffnen Sie in einem Texteditor C:\ProgramData\Qlik\Gateway\custom_type_mapping.json als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Anzeigen > Ausgeblendete Elemente aktiviert ist. Diese Datei enthält eine Beispielquelle für Qlik Cloud Datentypen.
  2. Fügen Sie einen Abschnitt hinzu, der den problematischen Datentyp dem gewünschten Qlik Cloud Datentyp zuordnet.

    Im folgenden Beispiel (das in der Datei custom_type_mapping.json enthalten ist), muss der Kunde die Größe des Datentyps Qlik Cloud DateTime in 27 ändern.

    {

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

    "NativeDataType": "timestamp with time zone",

    "QlikDataType": "DateTime",

    "Size": 27,

    "IsBit": false

    }

  3. Speichern Sie die Datei custom_type_mapping.json und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.
  4. Laden Sie die Daten neu.

Erzwingen einer neuen Verbindung von Direct Access Gateway mit Qlik Cloud

Wenn die Verbindung zwischen Direct Access Gateway und Qlik Cloud unterbrochen wird, sollte sie standardmäßig nach 45 Sekunden wiederhergestellt werden. Wenn Sie feststellen, dass es deutlich länger dauert, können Sie erzwingen, dass das Gateway die Verbindung schneller wiederherstellt.

Gehen Sie wie folgt vor:

  1. Öffnen Sie in einem Texteditor C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Anzeigen > Ausgeblendete Elemente aktiviert ist. Diese Datei enthält eine Beispielquelle für Qlik Cloud Datentypen.
  2. Fügen Sie AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> in den Abschnitt # Connector Agent am Anfang der Datei ein.

    Beispiel:

    AGENT_PONG_TIMEOUT_SECONDS=30

    InformationshinweisDie Mindestzeit beträgt 30 Sekunden.
  3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Erhöhung der Detailgenauigkeit von Fehlermeldungen bei der Verbindung zu ODBC-Datenquellen

Aufgrund von Sicherheitsbedenken enthält die vom ODBC-Treiber zurückgegebene Standardfehlermeldung nur minimale Informationen. In bestimmten Szenarien benötigen Sie jedoch möglicherweise mehr Informationen, um ein bestimmtes Problem zu beheben. Um eine detailliertere Fehlermeldung zu erhalten, fügen Sie die Eigenschaft ShowErrorDetailMessage zum Abschnitt Erweitert im Dialogfeld „Konnektor“ hinzu und setzen Sie sie auf True. Sobald Sie das Problem gelöst haben, sollten Sie die Eigenschaft zur optimalen Sicherheit entweder löschen oder auf False setzen.

Hat diese Seite Ihnen geholfen?

Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!