Qlik Gegevensgateway - Directe toegang configureren en problemen oplossen

In dit onderwerp worden de verschillende acties beschreven om Direct Access gateway te configureren en problemen op te lossen.

Direct Access gateway configureren vanuit uw Qlik Cloud-tenant

De standaardinstellingen van Direct Access gateway zijn geschikt voor de meeste omgevingen, maar u moet mogelijk de standaardopties overschrijven om de prestaties te verbeteren, een probleem op te lossen (via de instellingen van logboekregistratie) of verscheidene verbindingsproblemen te verhelpen.

Om de instellingen in Qlik Cloud te kunnen bewerken, is een van de volgende machtigingen vereist:

• Tenantbeheerder en eigenaar van gatewayruimte

• Tenantlid met Kan gegevens gebruiken in de gatewayruimte

Om de gateway-instellingen te openen:

1. Navigeer in uw Qlik Cloud-tenant naar Beheer > Gegevensgateways en zoek uw Direct Access gateway.

2. Klik op aan het einde van een rij en selecteer Gateway-instellingen.

   Het dialoogvenster Gateway-instellingen voor <name> wordt geopend.

   De instellingen zijn onderverdeeld in algemene instellingen (hieronder) en connectorinstellingen. Voor het wijzigen van de instellingen moet u mogelijk ook de Direct Access gateway-service opnieuw opstarten.

Algemene instellingen

Deze instellingen zijn relevant voor de algemene functionaliteit van Direct Access gateway, ongeacht welke connector u gebruikt.

Agent-id

De agent-id om te gebruiken met de Direct Access gateway openbare API.

Poort connectoragent

De poort om te gebruiken als u verbinding maakt met de connectoragent. Deze instelling kan niet worden gewijzigd.

Drempel mislukte status connectoragent

Periodieke statuscontroles worden uitgevoerd op Direct Access gateway-componenten. De statuscontroles mislukken soms bij de eerste poging en zijn daarna succesvol. Als de statuscontroles blijven mislukken na de opgegeven drempel, wordt de Direct Access gateway-service opnieuw gestart. U mag deze instelling alleen wijzigen op verzoek van Qlik Support.

Time-out laadaanvraag

Als de netwerkverbinding wordt onderbroken, kunnen ladingen mislukken met de volgende fouten:

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

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

Treden de bovenstaande fouten regelmatig op, verleng de time-out dan tot 5-10 minuten.

Registratieniveau connectoragent

Voor het oplossen van problemen moet u misschien het logboekregistratieniveau van de componenten van de connectoragent. U mag deze instelling alleen wijzigen op verzoek van Qlik Support.

Opties voor logboekregistratie connectoragent

Voor het oplossen van problemen met een specifieke component van de connectoragent, moet u mogelijk het bijbehorende logboekbestand selecteren. U mag deze instelling alleen wijzigen op verzoek van Qlik Support.

Geheugen voor gecashte datachunks

Voor elke laadoperatie kan Direct Access gateway data chunks in het geheugen cachen en ze naar de schijf overbrengen (wanneer de grootte die voor caching is toegewezen, overschreden wordt). Dit is met name handig als u geen automatisch herstel gebruikt en regelmatig last hebt van 4025-, 4020- en 4021-fouten. Nadat de opgegeven drempelwaarde is bereikt, offloadt de gateway de volgende versleutelde chunks naar de schijf van de Direct Access gateway-machine.

Drempel duur chunkherstel

Dit is de een drempel (in minuten) voor de herstelduur van de chunks. Als de lading niet is hervat tegen de tijd dat de drempel voor de herstelperiode is bereikt, zal de lading mislukken met een toepasselijk bericht.

Deze optie is handig voor ladingen die anders de limiet van drie uur zouden overschrijden, na een lang herstel. Stel bijvoorbeeld dat het 90 minuten duurt om de gegevens uit de database op te halen, maar zodra het opnieuw laden begint, raakt een van de chunks beschadigd. In dit geval worden alle chunks in de cache opgeslagen en vanuit de cache verzonden. In zo'n scenario kan het hele laadproces (opslaan in cache + daadwerkelijk opnieuw laden) drie uur in beslag nemen.

DCaaS-poort

De poort om te gebruiken als u verbinding maakt met DCaaS. Deze instelling kan niet worden gewijzigd.

DCaaS-registratieniveau

Voor het oplossen van problemen moet u misschien het logboekregistratieniveau van de DCaaS-logboeken wijzigen. U mag deze instelling alleen wijzigen op verzoek van Qlik Support.

Connectorinstellingen

Om de connectorinstellingen te wijzigen, selecteert u links het type connector en wijzigt u de instellingen naar wens.

Poort

De poort om te gebruiken als u verbinding maakt met een gegevensbron. Deze instelling kan niet worden gewijzigd.

Registratieniveau

Voor het oplossen van problemen moet u misschien het logboekregistratieniveau van de logboeken van de connectorlogboeken wijzigen. U mag deze instelling alleen wijzigen op verzoek van Qlik Support.

Proces-isolatie

Procesisolatie stelt beheerders met toegang tot het besturingssysteem van de Direct Access gateway-server in staat om te beheren hoeveel processen beschikbaar zijn voor opdrachten van ladingen en/of metagegevens per connectortype voor ladingen. Het spreiden van opdrachten voor ladingen en/of metagegevens over meerdere connectorprocessen verhoogt het isolatieniveau doordat het aantal opdrachten voor ladingen en/of metagegevens wordt verminderd dat gelijktijdig in elk connectorproces wordt uitgevoerd. Dit kan op zijn beurt de algemene stabiliteit van Direct Access gateway verbeteren in gevallen waarbij connectoruitval heeft plaatsgevonden.

Bij een nieuwe installatie is procesisolatie standaard ingeschakeld. Het standaard aantal gelijktijdige opdrachten voor ladingen en/of metagegevens voor elk type connector is 9. U kunt de standaardwaarden overschrijven zoals beschreven in Aantal gelijktijdige laad-/opdrachtprocessen hieronder.

De volgende opties zijn beschikbaar:

• Uitgeschakeld: Qlik Support kan u vragen om procesisolatie uit te schakelen om problemen op te lossen.

• Metagegevens: Schakel procesisolatie in voor alleen metagegevens-opdrachten. Dit kan nuttig zijn, bijvoorbeeld voor klanten met ODBC-stuurprogramma's die geen multi-threading ondersteunen, maar die metagegevensopdrachten gelijktijdig willen uitvoeren (voornamelijk voor previewdoeleinden).

  InformatieOndersteund vanaf Direct Access gateway 1.7.9.

• Opnieuw laden (standaard): Schakel procesisolatie in voor alleen laadopdrachten.

• Alle: Schakel procesisolatie in voor laad- en metagegevens-opdrachten.

  InformatieOndersteund vanaf Direct Access gateway 1.7.9.

Aantal gelijktijdige laad-/opdrachtprocessen

Het aantal gelijktijdige laad-/opdrachtprocessen dat voor de connector is toegewezen, inclusief het opdrachtproces. Bijvoorbeeld: een waarde van 30 zou maximaal 29 gelijktijdige ladingen/opdrachten betekenen. Deze instelling is alleen relevant als procesisolatie is ingeschakeld.

Levensduur van de laadsessie

Als de verbinding tussen Direct Access gateway en Qlik Cloud 20 seconden of meer inactief is, mislukte de laadbewerking soms met de volgende fout:

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

De standaard levensduur van de sessie is 20 seconden, maar als deze fout regelmatig optreedt, kunt u de levensduur van de sessie indien nodig verlengen:

Maximumaantal tabellen om te verwijderen

Er worden standaard maximaal 10.000 tabellen opgehaald uit de database. U kunt de standaardinstelling overschrijven als uw database meer dan 10.000 tabellen bevat.

De URL's beperken die Direct Access gateway kan openen met de REST-connector

U kunt de toegang beperken tot specifieke URL's of URL-paden die toegankelijk zijn met de REST-connector.

Om de toegang tot een specifieke URL te beperken, voert u de URL in het veld Toegestane URL's in en klikt u op Toevoegen. Doe hetzelfde om de toegang tot een URL-pad te beperken, maar voeg een asterisk (*) toe aan de URL. Herhaal indien nodig.

Voorbeeld

In het volgende voorbeeld bevat de lijst Toegestane URL's twee vermeldingen:

• De eerste vermelding geeft alleen toegang tot https://mypublicrestservice.com/restricted/source.

• De tweede vermelding geeft toegang tot https://mypublicrestservice.com/open en elk pad daaronder, zoals https://mypublicrestservice.com/open/shared

URL's bewerken of verwijderen

Om een URL te bewerken, klikt u op de knop aan het einde van de rij en bewerkt u de URL naar wens. Klik vervolgens op om uw wijzigingen op te slaan of op om te annuleren.

Klik op de knop aan het einde van de rij om een URL te selecteren.

Zie ook: Een REST-verbinding maken (alleen in het Engels).

De lijst met paden beperken die Direct Access gateway kan openen met de File- connector

U kunt de toegang beperken tot paden die toegankelijk zijn met de File-connector. U kunt ook een pad koppelen aan een of meer ruimten om de toegang tot het opgegeven pad verder te beperken.

Om de toegang tot een specifiek pad te beperken, voert u het pad in het veld Bestandspaden in en klikt u op Toevoegen. Herhaal indien nodig.

Om een ruimte aan een pad te koppelen, klikt u, nadat u het pad hebt toegevoegd, op de knop aan het einde van de rij en selecteert u een of meer ruimten uit de vervolgkeuzelijst in de kolom Gekoppelde ruimten. Als een pad is gekoppeld aan ruimten, kunnen alleen gebruikers die tot ten minste één van de ruimten behoren toegang krijgen tot het opgegeven pad. Leden van de opgegeven ruimten krijgen toegang tot het pad vanuit elke ruimte waartoe ze behoren (zelfs als dit niet expliciet is gedefinieerd), incl. hun persoonlijke ruimte.

Voorbeeld

In het volgende voorbeeld bevat de lijst Bestandspaden twee vermeldingen:

• De eerste vermelding staat toe dat elke gebruiker met de vereiste rol toegang krijgt tot C:\mypath\source.

• De tweede vermelding staat alleen toe dat leden van de ruimte mosheSharedSpace toegang krijgen tot C:\restricted.

Vermeldingen bewerken of verwijderen

Om een vermelding te bewerken, klikt u op de knop aan het einde van de rij en bewerkt u de vermelding naar wens. Klik vervolgens op om uw wijzigingen op te slaan of op om uw wijzigingen ongedaan te maken.

Klik op de knop aan het einde van de rij om een vermelding te verwijderen.

Zie ook: File (via Direct Access gateway) (alleen in het Engels).

Direct Access gateway opnieuw starten na het wijzigen van de instellingen

Sommige instellingen worden pas toegepast nadat de Direct Access gateway service opnieuw is gestart. In dat geval wordt u gevraagd om de service opnieuw te starten wanneer u uw instellingen opslaat. Als er actieve ladingen zijn, kunt u de service niet opnieuw starten totdat deze voltooid zijn. Als er geen actieve ladingen zijn, kunt u de service op elk moment als volgt opnieuw starten:

1. Navigeer in uw Qlik Cloud-tenant naar Beheer > Gegevensgateways en zoek uw Direct Access gateway.

2. Klik op aan het einde van een rij en selecteer Service opnieuw starten.

U kunt de service ook rechtstreeks op de Direct Access gateway-machine opnieuw starten, zoals beschreven in De service starten, stoppen of opnieuw opstarten

Direct Access gateway rechtstreeks op de Direct Access gateway-machine configureren

Hoewel de meeste instellingen van Direct Access gateway geconfigureerd kunnen worden in Qlik Cloud, kunnen sommige instellingen alleen gewijzigd worden door de configuratiebestanden rechtstreeks op de Direct Access gateway-machine te bewerken.

De standaard cachemap voor chunks overschrijven

Voor elke laadoperatie kan Direct Access gateway data chunks in het geheugen cachen en ze naar de schijf overbrengen (wanneer de grootte die voor caching is toegewezen, overschreden wordt). U kunt de standaard cachemap voor chunks(C:ProgramData\Gateway\tmp) overschrijven als u niet genoeg schijfruimte op het systeemstation heeft.

Voor de volgende actie:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.

2. Zoek de eigenschap OVERRIDE_CHUNKS_CACHE_DIR en stel deze in op de map van uw keuze.

   Voorbeeld:

   OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

   InformatieZet het pad niet tussen aanhalingstekens.
3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Zie ook: Geheugen voor gecashte datachunks

Het standaard Qlik Cloud-gegevenstype overschrijven wanneer u met de ODBC (via Direct Access gateway) connector werkt.

Soms, als gevolg van een probleem met de verwerking van gegevensbrontypen door het ODBC-stuurprogramma van de leverancier, treedt er een fout op tijdens het opnieuw laden of worden er onjuiste gegevens geladen naar Qlik Cloud. In dergelijke gevallen kunt u het gegevenstype Qlik Cloud of de specificatie ervan (schaal of precisie, bijvoorbeeld) overschrijven.

Voor de volgende actie:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\custom_type_mappings.json als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd. Dit bestand bevat een voorbeeldbron voor Qlik Cloud-gegevenstypen.

2. Voeg een sectie toe die het problematische gegevenstype toewijst aan het gewenste Qlik Cloud-gegevenstype.

   In het volgende voorbeeld (dat is opgenomen in het bestand custom_type_mappings.json ) moet de klant de grootte van het Qlik Cloud DateTime gegevenstype wijzigen in 27.

    

   Voorbeeld:

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

3. Sla het custom_type_mappings.json bestand op en herstart de Qlik Gegevensgateway - Directe toegang-service.
4. Laad de gegevens opnieuw.

Direct Access gateway dwingen om opnieuw verbinding te maken met Qlik Cloud

Als de verbinding tussen Direct Access gateway en Qlik Cloud wordt verbroken, wordt de verbinding standaard na 45 seconden hersteld. Als u merkt dat het aanzienlijk langer duurt, kunt u de gateway dwingen om eerder opnieuw verbinding te maken.

Voor de volgende actie:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd. Dit bestand bevat een voorbeeldbron voor Qlik Cloud-gegevenstypen.

2. Voeg AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> toe aan de sectie # Connector Agent aan het begin van het bestand.

   Voorbeeld:

   AGENT_PONG_TIMEOUT_SECONDS=30

   InformatieDe minimale tijd is 30 seconden.
3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Load Data-aanvragen asynchroon uitvoeren

Het asynchroon uitvoeren van load data-aanvragen op de agent verkort de tijd dat de cloudservice moet wachten op reacties van de agent aanzienlijk.

Asynchrone load data-aanvragen inschakelen:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.

2. Voeg de volgende regel toe aan het bestand deze nog niet aanwezig is:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

   Als OPTIONAL_CAPABILITIES= al bestaat met een andere parameter (AsyncLoadSlotRequest, bijvoorbeeld), voegt u deze gewoon toe aan de bestaande parameter, gescheiden door een komma zonder spatie.

   Voorbeeld:

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest

3. Sla het bestand configuration.properties op.

Asynchrone load data-aanvragen uitschakelen:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.

2. Stel OPTIONAL_CAPABILITIES=None in, of verwijder AsyncLoadDataRequest als er andere OPTIONAL_CAPABILITIES parameters zijn.

3. Sla het bestand configuration.properties op.

Loadslots asynchroon aanvragen

Door loadslots asynchroon aan te vragen, wordt tijdelijke congestie van de opdrachtpijp naar Direct Access gateway verlicht tijdens het aanmaken van de WebSocket voor laadgegevens naar Qlik Cloud. Dit kan handig zijn bij het uitvoeren van een aanzienlijk aantal gelijktijdige ladingen.

Asynchrone loadslot-aanvragen inschakelen:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.

2. Voeg de volgende regel toe aan het bestand deze nog niet aanwezig is:

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest

   Als OPTIONAL_CAPABILITIES= al bestaat met een andere parameter (AsyncLoadDataRequest, bijvoorbeeld), voegt u deze gewoon toe aan de bestaande parameter, gescheiden door een komma zonder spatie:

   Voorbeeld:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest

3. Sla het bestand configuration.properties op.

Asynchrone loadslot-aanvragen uitschakelen:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.

2. Stel OPTIONAL_CAPABILITIES=None in, of verwijder AsyncLoadSlotRequest als er andere OPTIONAL_CAPABILITIES parameters zijn.

3. Sla het bestand configuration.properties op.

Opstarten van connectoren configureren

U kunt de time-outwaarde en het aantal pogingen voor het opstarten van de connector verhogen. Dit kan handig zijn bij het uitvoeren van een aanzienlijk aantal gelijktijdige ladingen. Als u deze parameters verhoogt, krijgt Direct Access gateway meer tijd en pogingen om de connector uit te voeren voordat deze mislukt en opnieuw moet worden opgestart.

Om de opstartparameters van de connector aan te passen, gaat u als volgt te werk:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.

2. Voeg de volgende regels toe aan het bestand:

   # 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

   Informatie Om congestie van de opdrachtpijp te voorkomen, vereist het aanpassen van deze waarden dat AsyncLoadDataRequest is ingeschakeld, zoals hierboven beschreven in Loadslots asynchroon aanvragen. Deze instellingen worden teruggezet naar de vaste oude waarden van respectievelijk 30 en 3 wanneer AsyncLoadSlotRequest is uitgeschakeld.
3. Sla het bestand configuration.properties op.

De standaard startpoort overschrijven die is ingesteld door procesisolatie

Wanneer procesisolatie is ingeschakeld, kunt u nu de standaard startpoort (49152) overschrijven die Direct Access gateway gebruikt voor interprocescommunicatie met alle geïsoleerde connectorprocessen. Dit kan nuttig zijn wanneer de standaardpoort in gebruik is door een ander proces.

Voor de volgende actie:

1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.

2. Voeg onder de # Connector Agent sectie de volgende regel toe aan het bestand:

   DATA_PORT_RANGE_START=port-value

   waarbij port-value de standaard startpoort is.

3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Foutberichtdetail vergroten bij verbinding met ODBC-gegevensbronnen

Uit veiligheidsoverwegingen bevat het standaardfoutbericht van de ODBC-driver minimale informatie. In bepaalde scenario's hebt u echter meer informatie nodig om een specifiek probleem op te lossen. Voor een meer gedetailleerde foutmelding voegt u de eigenschap ShowErrorDetailMessage toe aan de sectie Geavanceerd in het dialoogvenster van de connector en stelt u deze in op True. Zodra u uw probleem hebt opgelost, is het voor een optimale beveiliging sterk aanbevolen om de eigenschap te verwijderen of in te stellen op False.

Statistiekenverzamelaar

In een typische klantenomgeving vinden dagelijks talloze gegevensladingen plaats via Direct Access gateway naar Qlik Cloud Analyse. De mogelijkheid om het resourceverbruik en -gebruik dat door deze ladingen wordt beïnvloed te registreren en te monitoren, helpt klanten hun ladingen dienovereenkomstig te plannen.

De nieuwe statistiekenverzamelaar (die op de achtergrond draait op de Direct Access gateway-machine) biedt basislogboekregistratie en monitoring van resourcegebruik door Direct Access gateway, connectoren en het besturingssysteem. De statistiekenverzamelaar kan lokaal worden geconfigureerd in een JSON-bestand of via de openbare API.

De statistiekenverzamelaar configureren

Open op de Direct Access gateway-machine het volgende bestand en configureer het zoals vereist:

<INSTALL_DIR>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

Collectorinstellingen configureren (MetricsCollectorSettings)

• Enabled: stel in op true (standaard) om statistieken verzamelen in te schakelen of false om dit uit te schakelen.

• BaseScrapeIntervalSeconds: hoe vaak (in seconden) een polling uitgevoerd moet worden voor connectorstatistieken. Elke connector heeft zijn eigen pollinginterval.

• Port: de poort die wordt gebruikt door de API- of statistiekenconnector (REST via Direct Access gateway).

• LocalDataRetentionDays: gegevens ouder dan de opgegeven waarde worden verwijderd uit de lokale database.

• DataRetentionCheckIntervalMinutes: de frequentie van de retentiecontrole.

• LocalDatabaseFileLocation: de locatie van de lokale database. Dit kan ook een UNC-pad zijn. De standaardlocatie is C:\ProgramData\Qlik\Gateway\tmp.

Connectorinstellingen configureren (ConnectorConfigurations)

Voor alle Direct Access gateway-connectoren kunt u het pollinginterval voor statistieken (ScrapeIntervalSeconds) instellen en het verzamelen van statistieken inschakelen (true) of uitschakelen (false).

Voorbeeld van het bestand 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
    }
  }
}

Statistieken laden

Gebruik de REST-connector (via Direct Access gateway) om de statistieken van de Direct Access gateway-machine te verzamelen.

Voor de volgende actie:

1. Schakel in de REST (via Direct Access gateway) verbindingsinstellingen Werken met lokale hostverbinding toestaan in.

   Ga voor meer informatie naar Een REST-verbinding maken (alleen in het Engels).

2. Voeg http://localhost:5052/api/metrics toe aan de lijst met toegestane URL's.

   Zie De URL's beperken die Direct Access gateway kan openen met de REST-connector hierboven.

3. Start de Direct Access gateway-service opnieuw.

4. Maak een app en laad de statistieken van http://localhost:5052/api/metrics via de REST (via Direct Access gateway) verbinding.

Ondersteunde statistieken

• Systeemstatistieken:

  • network_bytes_sent_total: Het totale aantal verzonden bytes via Direct Access gateway sinds de systeemstart

  • network_bytes_received_total: Het totale aantal ontvangen bytes via Direct Access gateway sinds de systeemstart

• Connectorstatistieken:

  • process_start_time_seconds: verstreken tijd sinds het proces is gestart, in seconden.

  • process_cpu_seconds_total: het cumulatieve aantal seconden dat een CPU in een specifieke status is geweest

  • process_virtual_memory_bytes: de huidige grootte, in bytes, van het virtuele geheugen dat door het proces wordt verbruikt.

  • process_working_set_bytes: De huidige grootte, in bytes, van de werkset van het proces.

  • process_private_memory_bytes: de huidige grootte, in bytes, van het virtuele geheugen dat door het proces wordt verbruikt.

  • process_num_threads: Het aantal threads dat door het proces wordt gebruikt.

Logbestanden weergeven en downloaden

De logbestanden geven informatie over Direct Access gateway-bewerkingen. Qlik Support kan u vragen om deze logbestanden te verstrekken voor probleemoplossing. U kunt de logbestanden weergeven of downloaden in de logboekweergave. Onder normale omstandigheden is er geen reden om de logbestanden te bekijken, maar als u herhaaldelijk fouten of andere problemen hebt, kunnen de logbestanden vaak aangeven wat de oorzaak is.

De logboekweergave openen:

1. Ga in het Beheer-activiteitencentrum naar Gegevensgateways en zoek uw Direct Access gateway.

2. Klik op de knop aan het einde van een rij en selecteer logboeken weergeven.

   Het venster logboekweergave wordt geopend.

3. Kies bovenaan links in de vervolgkeuzelijst het type logboek waar Qlik-support u om heeft gevraagd. U kunt het weergeven of downloaden.

   De volgende logboeken zijn beschikbaar:

   • Direct Access gateway-logboeken (DirectAccessAgent)
   • DCaaS logs (dcaas_logs)
   • Logboeken ODBC-gebaseerde connector (odbc-connector_logs)
   • Logboeken SAP BW-connector (QvSAPBwConnector-<datum + tijdstempel>)
   • Logboeken SAP SQL-connector (QvSqlBwConnector-<datum + tijdstempel>)

   • Logboeken connector-agent (connector-agent_logs_<datum>)

   • Logboeken SAP ODP en SAP Report-connectoren (QvSapConnectorPackage-<process_id>)

   • Logboeken REST-connector (rest-connector_logs_<timestamp>)

   • Logboeken File-connector (file-connector_logs_<timestamp>)

   InformatieVanaf Direct Access gateway 1.7.1 worden gebeurtenissen met betrekking tot het starten, afsluiten en opnieuw opstarten van connectoren naar het logbestand Direct Access gateway(DirectAccessAgent) geschreven. In eerdere versies werden ze naar het logbestand Connector agent logs (connector-agent_logs_<date>) geschreven.

4. Selecteer het logboek dat u wilt weergeven of downloaden in de bijbehorende vervolgkeuzelijst. De logbestanden worden op volgorde van nieuwste (het actuele, actieve logbestand) naar oudste gerangschikt. Nadat u een logbestand hebt geselecteerd, kunt u de knoppen en gebruiken om naar het begin of het eind van het logbestand te springen.

   TipDe weergave van het logboekbestand wordt niet automatisch met de laatste berichten bijgewerkt. Als u de weergave wilt bijwerken, klikt u op om naar het einde van het logboekbestand te springen dat wordt bijgewerkt met de nieuwste berichten.

5. Om het logbestand te downloaden, klikt u op Downloaden.

   Het bestand wordt gedownload naar uw computer of u wordt gevraagd het op te slaan, afhankelijk van uw browserinstellingen.

Direct Access gateway-logboeken openen op de Direct Access gateway-machine

Naast dat u de Direct Access gateway-logboeken (DirectAccessAgent) vanuit het Beheer-activiteitencentrum kunt downloaden, kunt u ze ook rechtstreeks vanaf de Direct Access gateway-machine openen. In het geval van een standaardinstallatie bevinden deze zich in de volgende map:

C:\Program Files\Qlik\ConnectorAgent\data\logs

Het logboekregistratieniveau van DirectAccessAgent wijzigen

Voor het oplossen van problemen moet u misschien het logboekregistratieniveau van de DirectAccessAgent-logboeken wijzigen. DirectAccessAgent is verantwoordelijk voor de verbinding met Qlik Cloud-services. Om het detailniveau van logboekregistratie te tonen en wijzigen, voert u de volgende opdrachten uit vanuit de submap ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent in het geval van een standaardinstallatie).

• Als u het huidige niveau van logboekregistratie wilt bekijken, voert u het volgende uit:

  connectoragent configuration getloggers

• Als u het niveau van logboekregistratie wilt instellen in Trace, voert u het volgende uit:

  connectoragent configuration setloggers -l Root -v DEBUG

• Als u het niveau van logboekregistratie wilt instellen in Verbose, voert u het volgende uit:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Voor extra opties voor logboekregistratie, zie Direct Access gateway configureren in Qlik Cloud hieronder.

De registratiesleutel bijwerken

Het is mogelijk vereist om de registratiesleutel te wijzigen in het onwaarschijnlijke geval dat de sleutel corrupt raakt of u vermoedt dat een onbevoegde gebruiker toegang tot de server van de gegevensgateway heeft verkregen.

Ga als volgt te werk om de registratiesleutel bij te werken:

1. Op de server met de gateway voor directe toegang, opent u een opdrachtprompt als een beheerder en wijzigt u de werkmap in de submap ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent met een standaardinstallatie).

2. Voer de volgende opdrachten uit:

   • De nieuwe sleutel genereren:

     connectoragent qcs generate_keys

   • De sleutel weergeven:

     connectoragent qcs get_registration

     De sleutel wordt getoond:

     

3. Kopieer de volledige sleutel zoals in het bovenstaande voorbeeld wordt getoond.

4. In het Beheer-activiteitencentrum opent u de instellingen van de gegevensgateway door op de knop te klikken aan het einde van de relevante rij en Bewerken te selecteren.

5. Plak de sleutel in het veld Sleutel (hiermee wordt de huidige sleutel vervangen) en sla de instellingen op.

6. Ga terug naar de server van de gateway voor directe toegang en start de Qlik Gegevensgateway - Directe toegang-service opnieuw, zoals beschreven in De Qlik Gegevensgateway - Directe toegang-service beheren.