Konfigurieren und Fehlerbehebung von Qlik Data Gateway – direkter Zugriff

In diesem Thema werden verschiedene Aktionen beschrieben, die Sie zur Konfiguration und Fehlerbehebung von Direct Access Gateway anwenden können.

Konfigurieren von Direct Access Gateway über den Qlik Cloud Mandanten

Die Standardeinstellungen von Direct Access Gateway eignen sich für die meisten Umgebungen. Gelegentlich kann es aber erforderlich sein, die Standardwerte zu überschreiben, um die Leistung zu verbessern, ein Problem (über die Protokolliereinstellungen) zu beheben oder diverse Verbindungsprobleme zu beheben.

Um die Einstellungen in Qlik Cloud bearbeiten zu können, benötigen Sie eine der folgenden Berechtigungen:

• Mandatenadministrator und Besitzer des Gateway-Bereichs

• Mandantenmitglied mit Kann Daten nutzen im Gateway-Bereich

So öffnen Sie die Gateway-Einstellungen:

1. Navigieren Sie in Ihrem Qlik Cloud Mandanten zu Administration > Daten-Gateways und suchen Sie das Direct Access Gateway.

2. Klicken Sie auf am Ende der Zeile und wählen Sie Gateway-Einstellungen aus.

   Das Dialogfeld Gateway-Einstellungen für <Name> wird geöffnet.

   Die Einstellungen sind in allgemeine Einstellungen (unten) und Konnektoreinstellungen unterteilt. Beachten Sie, dass Sie zum Ändern der Einstellungen möglicherweise auch den Direct Access Gateway-Dienst neu starten müssen.

Allgemeine Einstellungen

Diese Einstellungen sind für die allgemeine Funktionalität von Direct Access Gateway relevant, unabhängig davon, welchen Konnektor Sie verwenden.

Agenten-ID

Agent-ID für die Verwendung mit der öffentlichen Direct Access Gateway-API

Konnektor-Agent-Port

Der Port, der bei der Verbindung zum Konnektor-Agenten verwendet werden soll. Diese Einstellung kann nicht geändert werden.

Fehlerschwelle für Konnektor-Agent-Zustandsprüfung

Für Direct Access Gateway-Komponenten werden regelmäßigen Systemzustandsprüfungen durchgeführt. Die Systemzustandsprüfungen schlagen manchmal zuerst fehl und sind später erfolgreich. Wenn die Systemzustandsprüfungen nach dem angegebenen Schwellenwert weiterhin fehlschlagen, wird der Direct Access Gateway-Dienst neu gestartet. Sie sollten diese Einstellung nur auf Aufforderung durch den Qlik-Support ändern.

Timeout 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 die oben genannten Fehler häufig auftreten, versuchen Sie, das Timeout auf 5-10 Minuten zu verlängern.

Protokollierungsstufe des Konnektor-Agenten

Zur Fehlerbehebung müssen Sie möglicherweise die Protokollierungsstufe der Konnektor-Agent-Komponenten ändern. Sie sollten diese Einstellung nur auf Aufforderung durch den Qlik-Support ändern.

Konnektor-Agent-Protokollierungsoptionen

Um Probleme mit einer bestimmten Konnektor-Agent-Komponente zu beheben, müssen Sie möglicherweise die entsprechende Protokolldatei auswählen. Sie sollten diese Einstellung nur auf Aufforderung durch den Qlik-Support ändern.

Arbeitsspeicher für zwischengespeicherte Datenblöcke

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

Schwellenwert für Datenblock-Wiederherstellungsdauer

Dies ist der Schwellenwert (in Minuten) für die Wiederherstellungsdauer der Datenblöcke. Wenn der Ladevorgang bis zum Erreichen des Schwellenwerts für die Wiederherstellungsdauer nicht wieder aufgenommen wurde, schlägt er mit einer entsprechenden Meldung fehl.

Diese Option ist nützlich für Ladevorgänge, die andernfalls die Drei-Stunden-Grenze nach einer langen Wiederherstellungsphase überschreiten könnten. Nehmen wir zum Beispiel an, dass es 90 Minuten dauert, die Daten aus der Datenbank abzurufen, aber kurz nach Beginn des Ladevorgangs wird einer der Datenblöcke beschädigt. In diesem Fall werden alle Datenblöcke im Zwischenspeicher gespeichert und aus dem Zwischenspeicher gesendet. In einem solchen Szenario könnte der gesamte Ladevorgang (Speicherung im Zwischenspeicher + tatsächliches Laden) drei Stunden dauern.

DCaaS-Port

Der Port, der bei der Verbindung zu DCaaS verwendet werden soll. Diese Einstellung kann nicht geändert werden.

DCaaS-Protokollierungsstufe

Zur Fehlerbehebung müssen Sie möglicherweise die Protokollierungsstufe der DCaaS-Protokolle ändern. Sie sollten diese Einstellung nur auf Aufforderung durch den Qlik-Support ändern.

Konnektoreinstellungen

Um die Konnektoreinstellungen zu ändern, wählen Sie den Konnektortyp auf der linken Seite aus und ändern Sie dann die Einstellungen wie gewünscht.

Port

Der Port für die Verbindung mit der Datenquelle. Diese Einstellung kann nicht geändert werden.

Protokollierungsstufe

Zur Fehlerbehebung müssen Sie möglicherweise die Protokollierungsstufe der Konnektorprotokolle ändern. Sie sollten diese Einstellung nur auf Aufforderung durch den Qlik-Support ändern.

Prozessisolierung

Prozessisolierung ermöglicht Administratoren mit Zugriff auf das Betriebssystem des Direct Access Gateway-Servers die Anzahl der Prozesse zu steuern, die pro Konnektortyp für Ladevorgänge und/oder Metadatenbefehle verfügbar sind. Wenn Ladevorgänge/oder Metadatenbefehle auf mehrere Konnektorprozesse verteilt werden, erhöht dies die Isolationsstufe, indem die Anzahl der gleichzeitig ausgeführten Ladevorgänge/oder Metadatenbefehle 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.

Bei einer Neuinstallation ist die Prozessisolierung standardmäßig aktiviert. Die Standardanzahl der gleichzeitigen Ladevorgänge/oder Metadatenbefehle für jeden Konnektortyp beträgt 9. Sie können die Standardwerte wie unter Anzahl der gleichzeitigen Lade-/Befehlsprozesse unten beschrieben ändern.

Folgende Optionen sind verfügbar:

• Deaktiviert: Der Qlik-Support kann Sie auffordern, die Prozessisolierung zur Fehlerbehebung zu deaktivieren.

• Metadaten: Aktivieren Sie Prozessisolation ausschließlich für Metadatenbefehle. Dies kann beispielsweise für Kunden mit ODBC-Treibern nützlich sein, die kein Multi-Threading unterstützen, aber Metadatenbefehle gleichzeitig ausführen möchten (hauptsächlich zu Vorschauzwecken).

  InformationshinweisWird ab Direct Access Gateway 1.7.9 unterstützt.

• Neu laden (Standardwert): Aktivieren Sie Prozessisolation ausschließlich für Ladebefehle.

• Alle: Aktivieren Sie Prozessisolation für Lade- und Metadatenbefehle.

  InformationshinweisWird ab Direct Access Gateway 1.7.9 unterstützt.

Anzahl der gleichzeitgen Lade-/Befehlsprozesse

Die Anzahl der gleichzeitigen Lade-/Befehlsprozesse, die dem Konnektor zugewiesen sind, einschließlich des Befehlsprozesses. Beispielsweise bedeutet ein Wert von 30 maximal 29 gleichzeitige Ladevorgänge/Befehle. Beachten Sie, dass diese Einstellung nur relevant ist, wenn die Prozessisolierung aktiviert ist.

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 erforderlich verlängern.

Maximale Anzahl auszulagernder Tabellen

Standardmäßig werden maximal 10.000 Tabellen aus der Datenbank abgerufen. Sie können den Standardwert überschreiben, wenn Ihre Datenbank mehr als 10.000 Tabellen enthält.

Begrenzen der URLs, auf die Direct Access Gateway mithilfe des REST-Konnektors zugreifen kann

Sie können den Zugriff auf bestimmte URLs oder URL-Pfade beschränken, die mit dem REST-Konnektor aufgerufen werden können.

Um den Zugriff auf eine bestimmte URL zu beschränken, geben Sie die URL in das Feld Zulässige URLs ein und klicken Sie auf Hinzufügen. Verfahren Sie ebenso, um den Zugriff auf einen URL-Pfad zu beschränken, hängen Sie jedoch einen Askerisk (*) an die URL an. Wiederholen Sie dies bei Bedarf.

Beispiel

Im folgenden Beispiel enthält die Liste Zulässige URLs zwei Einträge:

• Der erste Eintrag ermöglicht nur den Zugriff auf https://mypublicrestservice.com/restricted/source.

• Der zweite Eintrag ermöglicht den Zugriff auf https://mypublicrestservice.com/open und jeden darunterliegenden Pfad, wie z. B. https://mypublicrestservice.com/open/shared.

Bearbeiten oder Löschen von URLs

Um eine URL zu bearbeiten, klicken Sie auf die Schaltfläche am Ende der Zeile und bearbeiten Sie die URL wie erforderlich. Klicken Sie dann auf , um Ihre Änderungen zu speichern, oder auf , um den Vorgang abzubrechen.

Zum Löschen einer URL klicken Sie auf die Schaltfläche am Ende der Zeile.

Siehe auch: Erstellen einer REST-Verbindung (nur auf Englisch).

Einschränken der Liste der Pfade, auf die Direct Access Gateway über den Dateikonnektor zugreifen kann

Sie können den Zugriff auf Pfade beschränken, die mit dem Dateikonnektor aufgerufen werden können. Sie können auch einen Pfad mit einem oder mehreren Bereichen koppeln, um den Zugriff auf den angegebenen Pfad weiter einzuschränken.

Um den Zugriff auf einen bestimmten Pfad zu beschränken, geben Sie den Pfad in das Feld Dateipfade ein und klicken Sie auf Hinzufügen. Wiederholen Sie dies bei Bedarf.

Um einen Bereich mit einem Pfad zu koppeln, klicken Sie nach dem Hinzufügen des Pfads auf die Schaltfläche am Ende der Zeile und wählen Sie einen oder mehrere Bereiche aus der Dropdown-Liste in der Spalte Gekoppelte Bereiche aus. Wenn ein Pfad mit Bereichen gekoppelt ist, können nur Benutzer, die zu mindestens einem der Bereiche gehören, auf den angegebenen Pfad zugreifen. Beachten Sie, dass Mitglieder der angegebenen Bereiche von einem beliebigen Bereich, zu dem sie gehören (auch ihrem persönlichen Bereich) auf den Pfad zugreifen können, auch wenn der Bereich nicht ausdrücklich angegeben ist.

Beispiel

Im folgenden Beispiel enthält die Liste Dateipfade zwei Einträge:

• Der erste Eintrag ermöglicht jedem Benutzer mit der erforderlichen Rolle den Zugriff auf C:\mypath\source..

• Der zweite Eintrag ermöglicht nur Mitgliedern des Bereichs mosheSharedSpace den Zugriff auf C:\restricted.

Bearbeiten oder Löschen von Einträgen

Um einen Eintrag zu bearbeiten, klicken Sie auf die Schaltfläche am Ende der Zeile und bearbeiten Sie den Eintrag wie erforderlich. Klicken Sie dann auf , um Ihre Änderungen zu speichern, oder auf , um sie rückgängig zu machen.

Zum Löschen eines Eintrags klicken Sie auf die Schaltfläche am Ende der Zeile.

Siehe auch: Datei (über Direct Access Gateway) (nur auf Englisch).

Neustart von Direct Access Gateway nach Änderung der Einstellungen

Einige Einstellungen werden erst nach einem Neustart des Direct Access Gateway-Dienstes übernommen. In diesem Fall werden Sie aufgefordert, den Dienst neu zu starten, wenn Sie Ihre Einstellungen speichern. Wenn aktive Ladevorgänge vorliegen, können Sie den Dienst erst neu starten, nachdem diese abgeschlossen sind. Wenn keine aktiven Ladevorgänge vorliegen, können Sie den Dienst jederzeit wie folgt neu starten:

1. Navigieren Sie in Ihrem Qlik Cloud Mandanten zu Administration > Daten-Gateways und suchen Sie das Direct Access Gateway.

2. Klicken Sie auf am Ende der Zeile und wählen Sie Dienst neu starten aus.

Sie können den Dienst auch direkt auf dem Direct Access Gateway-Rechner neu starten, wie in Starten, Anhalten oder Neustarten des Dienstes beschrieben.

Konfigurieren von Direct Access Gateway direkt auf dem Direct Access Gateway-Rechner

Während die meisten Einstellungen von Direct Access Gateway in Qlik Cloud konfiguriert werden können, lassen sich einige Einstellungen nur ändern, indem Sie die Konfigurationsdateien direkt auf dem Rechner des Direct Access Gateway bearbeiten.

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

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.

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 – direkter Zugriff neu.

Siehe auch: Arbeitsspeicher für zwischengespeicherte Datenblöcke

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

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.

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_mappings.json enthalten ist), muss der Kunde die Größe des Qlik Cloud Datentyps DateTime in 27 ändern.

    

   Beispiel:

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

3. Speichern Sie die Datei custom_type_mappings.json und starten Sie den Qlik Data Gateway – direkter Zugriff-Dienst 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 – direkter Zugriff neu.

Asynchrones Ausführen von Datenladeanforderungen

Die asynchrone Ausführung von Datenladeanforderungen auf dem Agenten verkürzt die Zeit, die der Cloud-Dienst auf Antworten vom Agenten warten muss, erheblich.

So aktivieren Sie asynchrone Datenladeanforderungen:

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. Fügen Sie die folgende Zeile in die Datei ein, wenn sie noch nicht vorhanden ist:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

   Wenn OPTIONAL_CAPABILITIES= bereits mit einem anderen Parameter vorhanden ist (z. B.AsyncLoadSlotRequest), hängen Sie sie einfach an den bestehenden Parameter an, getrennt durch ein Komma ohne Leerzeichen.

   Beispiel:

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest

3. Speichern Sie die Datei configuration.properties.

So deaktivieren Sie asynchrone Datenladeanforderungen:

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. Legen Sie OPTIONAL_CAPABILITIES=None fest oder löschen Sie einfach AsyncLoadDataRequest, wenn es weitere OPTIONAL_CAPABILITIES-Parameter gibt.

3. Speichern Sie die Datei configuration.properties.

Asynchrones Anfordern von Lade-Slots

Wenn Lade-Slots asynchron angefordert werden, wird die zeitweise Überlastung der Befehls-Pipe zu Direct Access Gateway während der Erstellung des Datenlade-WebSocket an Qlik Cloud abgemildert. Das kann nützlich sein, wenn sehr viele gleichzeitige Ladevorgänge ausgeführt werden.

So aktivieren Sie asynchrone Lade-Slot-Anforderungen:

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. Fügen Sie die folgende Zeile in die Datei ein, wenn sie noch nicht vorhanden ist:

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest

   Wenn OPTIONAL_CAPABILITIES= bereits mit einem anderen Parameter vorhanden ist (z. B.AsyncLoadDataRequest), hängen Sie sie einfach an den bestehenden Parameter an, getrennt durch ein Komma ohne Leerzeichen:

   Beispiel:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest

3. Speichern Sie die Datei configuration.properties.

So deaktivieren Sie asynchrone Lade-Slot-Anforderungen:

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. Legen Sie OPTIONAL_CAPABILITIES=None fest oder löschen Sie einfach AsyncLoadSlotRequest, wenn es weitere OPTIONAL_CAPABILITIES-Parameter gibt.

3. Speichern Sie die Datei configuration.properties.

Konfigurieren des Konnektorstarts

Sie können den Zeitüberschreitungswert und die Anzahl der Versuche für den Konnektorstart erhöhen. Das kann nützlich sein, wenn sehr viele gleichzeitige Ladevorgänge ausgeführt werden. Wenn Sie diese Parameterwerte erhöhen, hat Direct Access Gateway mehr Zeit und mehr Versuche, den Konnektor auszuführen, bevor der Vorgang mit einem Fehler beendet und ein Neustart erforderlich wird.

So passen Sie die Startparameter des Konnektors an:

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. Fügen Sie die folgenden Zeilen zur Datei hinzu:

   # CONNECTOR STARTUP TIMEOUT between 30 and 120 seconds

   CONNECTOR_STARTUP_TIMEOUT_SECONDS=your-value

   # CONNECTOR STARTUP MAX ATTEMPTS between 1 and 5

   CONNECTOR_STARTUP_MAX_ATTEMPTS=your-value

   Informationshinweis Um eine Überlastung der Befehls-Pipe zu verhindern, muss für die Anpassung dieser Werte AsyncLoadDataRequest aktiviert sein, wie unter Asynchrones Anfordern von Ladeslots oben beschrieben. Diese Einstellungen werden auf die festen Legacy-Werte von 30 bzw. 3 zurückgesetzt, wenn AsyncLoadSlotRequest deaktiviert ist.
3. Speichern Sie die Datei configuration.properties.

Überschreiben des standardmäßigen Startports, der durch Prozessisolierung festgelegt wird

Wenn Prozessisolierung aktiviert ist, können Sie jetzt den standardmäßigen Startport (49152) überschreiben, den Direct Access Gateway für die Kommunikation zwischen allen isolierten Konnektorprozessen verwendet. Dies kann nützlich sein, wenn der Standardport von einem anderen Prozess verwendet wird.

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. Fügen Sie im Abschnitt # Connector Agent die folgende Zeile zur Datei hinzu:

   DATA_PORT_RANGE_START=port-value

   wobei port-value der Standard-Startport ist.

3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway – direkter Zugriff 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.

Metrikkollektor

In einer typischen Kundenumgebung durchlaufen täglich zahlreiche Datenneuladungen Direct Access Gateway in Qlik Cloud Analytics. Die Möglichkeit, den Ressourcenverbrauch und die Ressourcennutzung, die von diesen Neuladungen betroffen sind, zu protokollieren und zu überwachen, wird Kunden dabei helfen, ihre Neuladungen entsprechend zu planen.

Der neue Metrikkollektor (der im Hintergrund auf der Direct Access Gateway-Maschine ausgeführt wird) stellt grundlegende Protokollierung und Überwachung der Ressourcennutzung durch Direct Access Gateway, Konnektoren und das Betriebssystem bereit. Der Metrikkollektor kann entweder lokal in einer JSON-Datei oder über die öffentliche API konfiguriert werden.

Konfigurieren des Metrikkollektors

Öffnen Sie auf der Direct Access Gateway-Maschine die folgende Datei und konfigurieren Sie sie nach Bedarf:

<INSTALL_DIR>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

Konfigurieren von Kollektoreinstellungen (MetricsCollectorSettings)

• Enabled: Legen Sie die Option auf true (Standardwert) fest, um die Metrikerfassung zu aktivieren, oder auf false, um sie zu deaktivieren.

• BaseScrapeIntervalSeconds: Häufigkeit der Abfrage von Konnektormetriken in Sekunden. Jeder Konnektor verfügt über ein eigenes Abfrageintervall.

• Port: Der Port, der vom API- oder Metrikkonnektor verwendet wird (REST über Direct Access Gateway).

• LocalDataRetentionDays: Daten, die älter als der angegebene Wert sind, werden aus der lokalen Datenbank gelöscht.

• DataRetentionCheckIntervalMinutes: Die Häufigkeit der Aufbewahrungsprüfung.

• LocalDatabaseFileLocation: Der Speicherort der lokalen Datenbank. Hierbei kann es sich auch um einen UNC-Pfad handeln. Der Standardspeicherort lautet auf C:\ProgramData\Qlik\Gateway\tmp.

Konfigurieren von Konnektoreinstellungen (ConnectorConfigurations)

Sie können für alle Direct Access Gateway-Konnektoren das Abfrageintervall für Metriken (ScrapeIntervalSeconds) festlegen und die Metrikerfassung aktivieren (true) oder deaktivieren (false).

Beispiel für die Datei „metricscollectorsettings.json“

{
  "MetricsCollectorSettings": {
    "Enabled": true,
    "BaseScrapeIntervalSeconds": 1,
    "Port": 5052,
    "LocalDataRetentionDays": 30,
    "DataRetentionCheckIntervalMinutes": 60,
    "LocalDatabaseFileLocation": ""
  },
  "ConnectorConfigurations": {
    "OdbcConnector": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "SystemMetrics": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "ConnectorAgent": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "RestConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapSqlConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapBwConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapPackageConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "FileConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    }
  }
}

Laden von Metriken

Verwenden Sie den REST-Konnektor (über Direct Access Gateway), um die Metriken der Direct Access Gateway-Maschine zu erfassen.

Gehen Sie wie folgt vor:

1. Aktivieren Sie in den REST-Verbindungseinstellungen (über Direct Access Gateway) die Option Arbeiten mit Localhost-Verbindung zulassen.

   Weitere Informationen finden Sie unter Erstellen einer REST-Verbindung (nur auf Englisch).

2. Fügen Sie http://localhost:5052/api/metrics zur Liste der zulässigen URLs hinzu.

   Weitere Informationen finden Sie oben unter Begrenzen der URLs, auf die Direct Access Gateway mithilfe des REST-Konnektors zugreifen kann.

3. Starten Sie den Direct Access Gateway-Dienst neu.

4. Erstellen Sie eine App und laden Sie die Metriken unter http://localhost:5052/api/metrics über die REST-Verbindung (über Direct Access Gateway).

Unterstützte Metriken

• Systemmetriken:

  • network_bytes_sent_total: Die Gesamtzahl der über Direct Access Gateway übertragenen Byte seit dem Systemstart

  • network_bytes_received_total: Die Gesamtzahl der über Direct Access Gateway empfangenen Byte seit dem Systemstart

• Konnektormetriken:

  • process_start_time_seconds: Verstrichene Zeit seit dem Start des Prozesses in Sekunden.

  • process_cpu_seconds_total: Die kumulative Anzahl an Sekunden, die eine CPU in einem bestimmten Zustand verbracht hat

  • process_virtual_memory_bytes: Die aktuelle Größe des vom Prozess belegten virtuellen Speichers in Byte.

  • process_working_set_bytes: Die aktuelle Größe des Arbeitssatzes des Prozesses in Byte.

  • process_private_memory_bytes: Die aktuelle Größe des vom Prozess belegten privaten Speichers in Byte.

  • process_num_threads: Die Anzahl der vom Prozess verwendeten Threads.

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.

So öffnen Sie den Protokoll-Viewer:

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

2. Klicken Sie auf die Schaltfläche 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 SQL-Konnektorprotokolle (QvSqlBwConnector-<Datum + Zeitstempel>)

   • Konnektor-Agent-Protokolle (connector-agent_logs_<Datum>)

   • SAP ODP- und SAP Report-Konnektorprotokolle (QvSapConnectorPackage-<process_id>)

   • REST-Konnektorprotokolle (rest-connector_logs_<Zeitstempel>)

   • File-Konnektorprotokolle (file-connector_logs_<Zeitstempel>)

   InformationshinweisAb Direct Access Gateway 1.7.1 werden Ereignisse zum Starten, Beenden und Neustarten des Konnektors in die Protokolldatei Direct Access Gateway(DirectAccessAgent) geschrieben. In früheren Versionen wurden sie in die Protokolldatei Konnektor-Agent-Protokolle (connector-agent_logs_<Datum>) geschrieben.

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 und 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 , 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 Administration 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 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

Weitere Protokollierungsoptionen finden Sie unter „Konfigurieren von Direct Access Gateway“ in Qlik Cloud unten.

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:

     

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

4. Öffnen Sie im Aktivitätscenter Administration die Daten-Gateway-Einstellungen, indem Sie auf die Schaltfläche 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 – direkter Zugriff-Dienst neu, wie in Verwalten des Qlik Data Gateway – direkter Zugriff-Dienstes beschrieben.