Konfigurering och felsökning Qlik Data Gateway – direktåtkomst

Det här ämnet beskriver olika åtgärder som du kan vidta för att konfigurera och felsöka Gateway med direktåtkomst.

Konfigurera Gateway med direktåtkomst från din Qlik Cloud-klientorganisation

Standardinställningarna för Gateway med direktåtkomst är lämpliga för de flesta miljöer, men du kan behöva åsidosätta standardinställningarna för att förbättra prestandan, felsöka problem (via inloggningsinställningarna) eller lösa olika anslutningsproblem.

För att kunna redigera inställningarna i Qlik Cloud krävs någon av följande behörigheter:

• Klientorganisationsadministratör och ägare av gatewayutrymme

• Medlem i klientorganisation med Kan använda data i gatewayutrymmet

För att öppna gateway-inställningarna:

1. I din Qlik Cloud-klientorganisation navigerar du till Administration > Data gateways och letar upp din Gateway med direktåtkomst.

2. Klicka på i slutet av raden och välj Gateway-inställningar.

   Dialogrutan Gateway-inställningar för <namn> öppnas.

   Inställningarna är indelade i allmänna inställningar (nedan) och inställningar för koppling. Observera att om du ändrar inställningarna kan det också krävas att du startar om Gateway med direktåtkomst-tjänsten.

Allmänna inställningar

Dessa inställningar är relevanta för den allmänna funktionaliteten på Gateway med direktåtkomst, oavsett vilken koppling du använder.

Agent-ID

Agent-ID för användning av offentligt API för Gateway med direktåtkomst.

Port för kopplingsagenter

Port som ska användas vid anslutning till kopplingsagenten. Denna inställning kan inte ändras.

Tröskelvärde för fel på kopplingsagenten

Periodiska hälsokontroller utförs på Gateway med direktåtkomst-komponenterna. Ibland misslyckas hälsokontrollerna i början men fungerar senare. Om hälsokontrollerna fortsatt misslyckas efter det angivna tröskelvärdet kommer Gateway med direktåtkomst-tjänsten att startas om. Du bör endast ändra denna inställning om Qlik Support begär det.

Tidsgräns för begäran om laddning

Vid nätverksstörningar kan omladdningar misslyckas med följande fel:

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

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

Om felen ovan inträffar ofta kan du prova att öka timeouten till 5–10 minuter.

Loggningsnivå för kopplingsagent.

I felsökningssyfte kan du behöva ändra loggningsnivån för kopplingens agentkomponenter. Du bör endast ändra denna inställning om Qlik Support begär det.

Loggningsalternativ för kopplingsagenter

Om du vill felsöka problem med en specifik komponent i en agent för koppling kan du behöva välja motsvarande loggfil. Du bör endast ändra denna inställning om Qlik Support begär det.

Minne för cachelagrade datasegment

För varje omladdning kan Gateway med direktåtkomst cachelagra databitar i minnet och ladda om dem till disk (när storleken som tilldelats för cachelagring överskrids). Detta är särskilt användbart om du inte använder automatisk återställning och ofta drabbas av 4025-, 4020- och 4021-fel. När det angivna tröskelvärdet uppnås kommer gatewayen att avlasta nästkommande krypterade paket till Gateway med direktåtkomst-maskinens disk.

Tröskelvärde för återställningstid av datasegment

Det är här tröskelvärdet (i minuter) för datasegmentets återställningstid. Om inläsningen inte har återupptagits när threshold för återhämtningstiden har nåtts, kommer den att misslyckas med ett lämpligt meddelande.

Detta alternativ är användbart för inläsningar som annars skulle kunna överskrida gränsen på tre timmar, efter en lång återhämtning. Det tar exempelvis 90 minuter att hämta data från databasen, men så snart inläsningen startar skadas ett av segmenten. I det här fallet lagras alla segment i cacheminnet och skickas från cacheminnet. I ett sådant scenario kan hela inläsningsprocessen (lagring i cache + faktisk inläsning) ta tre timmar att slutföra.

Port för DCaaS

Port som ska användas vid anslutning till DCaaS. Denna inställning kan inte ändras.

Loggningsnivå för DCaaS

I felsökningssyfte kan du behöva ändra loggningsnivån för DCaaS-loggar. Du bör endast ändra denna inställning om Qlik Support begär det.

Kopplingsinställningar

Om du vill ändra inställningarna för kopplingen väljer du typ av koppling till vänster och ändrar sedan inställningarna efter behov.

Port

Port som ska användas vid anslutning till datakällan. Denna inställning kan inte ändras.

Loggningsnivå

I felsökningssyfte kan du behöva ändra loggningsnivån för kopplingsloggarna. Du bör endast ändra denna inställning om Qlik Support begär det.

Processisolering

Med processisolering kan administratörer med åtkomst till Gateway med direktåtkomst-serverns operativsystem styra hur många processer som är tillgängliga för inläsning och/eller metadatakommandon per kopplingstyp. Att fördela inläsningar och/eller metadatakommandon på flera olika kopplingsprocesser ökar graden av isolering genom att minska antalet inläsningar/metadatakommandon som körs samtidigt på varje kopplingsprocess. Detta kan i sin tur förbättra den övergripande stabiliteten för Gateway med direktåtkomst i sådana fall där krascher har inträffat.

Med en ren installation är processisolering aktiverat som standard. Standardantalet samtidiga inläsningar/metadatakommandon för varje kopplingstyp är nio. Du kan åsidosätta standardvärdena enligt beskrivningen i Antal samtida inläsnings-/kommandoprocesser nedan.

Följande alternativ är tillgängliga:

• Inaktiverad: Qlik Support kan be dig att inaktivera processisolering i felsökningssyfte.

• Metadata: Aktivera processisolering endast för metadatakommandon. Detta kan vara användbart, till exempel för kunder med ODBC-drivrutiner som inte stöder flertrådning, men som vill köra metadatakommandon samtidigt (främst i förhandsgranskningssyfte).

  Anteckning om informationStöds från Gateway med direktåtkomst 1.7.9.

• Läs in (standard): Aktivera processisolering endast för inläsningskommandon.

• Alla: Aktivera processisolering för både inläsnings- och metadatakommandon.

  Anteckning om informationStöds från Gateway med direktåtkomst 1.7.9.

Antal samtidiga inläsnings-/kommandoprocesser

Antalet samtidiga inläsnings-/kommandoprocesser som tilldelats kopplingen, inklusive kommandoprocessen. Exempelvis innebär ett värde på 30 maximalt 29 samtidiga inläsningsar/kommandon. Observera att denna inställning endast är relevant när processisolering är aktiverad.

Inläsningssessionens livslängd

Om kopplingen mellan Gateway med direktåtkomst och Qlik Cloud är inaktiv i 20 sekunder eller mer kan det hända att laddningsåtgärden misslyckas med följande fel:

Invalid object name '#<TempTableName>' (indicating that the Gateway med direktåtkomst temp tables are unavailable).

Standardtiden för sessionen är 20 sekunder, men om du ofta upplever detta fel kan du förlänga sessionens livslängd efter behov.

Maximalt antal tabeller som ska laddas ur

Max 10 000 tabeller hämtas ur databasen som standard. Du kan åsidosätta standardinställningarna om din databas innehåller fler än 10 000 tabeller.

Begränsa URL:erna som Gateway med direktåtkomst kan komma åt med REST-kopplingen

Du kan begränsa åtkomsten till specifika URL:er eller URL-sökvägar som kan nås med REST-kopplingen.

För att begränsa åtkomsten till en specifik URL, ange URL:en i fältet Tillåtna URL:er och klicka på Lägg till. Gör detsamma för att begränsa åtkomsten till en URL-sökväg, men lägg till en asterisk (*) efter URL:en. Upprepa vid behov.

Exempel

I följande exempel innehåller listan Tillåtna URL:er två poster:

• Den första posten tillåter endast åtkomst till https://mypublicrestservice.com/restricted/source.

• Den andra posten tillåter åtkomst till https://mypublicrestservice.com/open och alla sökvägar under den, till exempel https://mypublicrestservice.com/open/shared

Redigera eller ta bort URL:er

För att redigera en URL, klicka på -knappen i slutet av raden och redigera URL:en som önskat. Klicka sedan på för att spara dina ändringar eller för att avbryta.

För att ta bort en URL, klicka på -knappen i slutet av raden.

Se även: Skapa en REST-anslutning (endast på engelska).

Begränsa listan över sökvägar som Gateway med direktåtkomst kan komma åt med hjälp av filkopplingen

Du kan begränsa åtkomsten till sökvägar som kan nås med filkopplingen. Du kan också para ihop en sökväg med ett eller flera utrymmen för att ytterligare begränsa åtkomsten till den angivna sökvägen.

För att begränsa åtkomsten till en specifik sökväg, ange sökvägen i fältet Filsökvägar och klicka på Lägg till. Upprepa vid behov.

För att koppla ett utrymme till en sökväg, efter att ha lagt till sökvägen, klicka på knappen i slutet av raden och välj ett eller flera utrymmen från rullgardinslistan i kolumnen Kopplade utrymmen . Om en sökväg är kopplad till utrymmen kommer endast användare som tillhör minst ett av utrymmena att kunna komma åt den angivna sökvägen. Observera att medlemmar i de angivna utrymmena kommer att kunna komma åt sökvägen från valfritt utrymme de tillhör (även om det inte är uttryckligen definierat), inklusive deras personliga utrymme.

Exempel

I följande exempel innehåller listan Filvägar två poster:

• Den första posten tillåter alla användare med den nödvändiga rollen att komma åt C:\mypath\source.

• Den andra posten tillåter endast medlemmar i utrymmet mosheSharedSpace att komma åt C:\restricted.

Redigera eller ta bort poster

För att redigera en post, klicka på -knappen i slutet av raden och redigera posten efter önskemål. Klicka sedan på för att spara dina ändringar eller på för att återställa dina ändringar.

För att ta bort en post, klicka på -knappen i slutet av raden.

Se även: Fil (via Gateway med direktåtkomst) (endast på engelska).

Starta om Gateway med direktåtkomst efter att ha ändrat inställningarna

Vissa inställningar tillämpas först efter att tjänsten Gateway med direktåtkomst har startats om. I sådana fall kommer du att uppmanas att starta om tjänsten när du sparar dina inställningar. Om det finns aktiva inläsningar kommer du inte att kunna starta om tjänsten förrän de är slutförda. När det inte finns några aktiva omladdningar kan du starta om tjänsten när som helst enligt följande:

1. I din Qlik Cloud-klientorganisation navigerar du till Administration > Data gateways och letar upp din Gateway med direktåtkomst.

2. Klicka på i slutet av raden och välj Starta om tjänst.

Du kan också starta om tjänsten direkt på Gateway med direktåtkomst-datorn, enligt beskrivningen i Starta, stoppa eller starta om tjänsten

Konfigurera Gateway med direktåtkomst direkt på Gateway med direktåtkomst-datorn

De flesta inställningar för Gateway med direktåtkomst kan konfigureras i Qlik Cloud, men vissa inställningar kan bara ändras genom att redigera konfigurationsfilerna direkt på Gateway med direktåtkomst-datorn

Åsidosätta standardkatalogen för cachesegment

För varje omladdning kan Gateway med direktåtkomst cachelagra databitar i minnet och ladda om dem till disk (när storleken som tilldelats för cachelagring överskrids). Du kan åsidosätta standardkatalogen för cachesegment (C:\ProgramData\Qlik\Gateway\tmp) om du inte har tillräckligt med diskutrymme på systemenheten.

För att göra detta:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Hitta egenskapen för OVERRIDE_CHUNKS_CACHE_DIR och ställ in den på den katalog du vill ha.

   Exempel:

   OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

   Anteckning om informationAnge inte sökvägen inom citationstecken.
3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Se även: Minne för cachelagrade datasegment

Åsidosätt standarddatatypen Qlik Cloud när du arbetar med ODBC-koppling (via Gateway med direktåtkomst)

Ibland, på grund av ett problem med leverantörens ODBC-drivrutinshantering av källdatatyper, kommer antingen ett fel att inträffa under inläsningen eller felaktiga data att laddas till Qlik Cloud. I sådana fall kan du åsidosätta Qlik Cloud-datatypen eller dess specifikation (t.ex. skala eller precision).

För att göra detta:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\custom_type_mappings.json som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt. Den här filen innehåller ett exempel på en källa till Qlik Cloud-datatyper.

2. Lägg till ett delavsnitt som mappar den problematiska datatypen till den önskade Qlik Cloud-datatypen.

   I följande exempel (som ingår i filen custom_type_mappings.json) behöver kunden ändra storleken på Qlik Cloud DateTime-datatypen till 27.

    

   Exempel:

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

3. Spara filen custom_type_mappings.json och starta om tjänsten Qlik Data Gateway – direktåtkomst.
4. Ladda om data.

Tvingar Gateway med direktåtkomst att återansluta till Qlik Cloud

Om Gateway med direktåtkomst kopplas bort från Qlik Cloud ska den som standard återanslutas efter 45 sekunder. Om du märker att det tar betydligt längre tid kan du tvinga gatewayen att återansluta tidigare.

För att göra detta:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt. Den här filen innehåller ett exempel på en källa till Qlik Cloud-datatyper.

2. Lägg till AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> i delavsnittet # Connector Agent i början av filen.

   Exempel:

   AGENT_PONG_TIMEOUT_SECONDS=30

   Anteckning om informationMinsta tid är 30 sekunder.
3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Utföra begäran om inläsningsdata asynkront

Att utföra begäran om inläsningsdata asynkront i agenten förkortar den tid molntjänsten behöver vänta på svar från agenten signifikant.

För att aktivera asynkrona begäranden om inläsningsdata:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Lägg till följande rad i filen om den inte redan finns:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

   Om OPTIONAL_CAPABILITIES= redan finns med en annan parameter ( t.ex.AsyncLoadSlotRequest), lägger du bara till den till den befintliga parametern, åtskilda med ett kommatecken utan blanksteg.

   Exempel:

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest

3. Spara filen configuration.properties.

För att inaktivera asynkrona begäranden om inläsningsdata:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Ställ in OPTIONAL_CAPABILITIES=None, eller ta helt enkelt bort AsyncLoadDataRequest om det finns andra OPTIONAL_CAPABILITIES-parametrar.

3. Spara filen configuration.properties.

Begära laddningsplatser asynkront

Att begära laddningsplatser asynkront lindrar tillfällig överbelastning av kommandoröret till Gateway med direktåtkomst under skapandet av WebSocket för omlastningsdata till Qlik Cloud. Detta kan vara användbart när man utför ett stort antal samtidiga omladdningar.

För att aktivera asynkrona begäranden om laddningsplatser:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Lägg till följande rad i filen om den inte redan finns:

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest

   Om OPTIONAL_CAPABILITIES= redan finns med en annan parameter (t.ex.AsyncLoadDataRequest), lägger du bara till den till den befintliga parametern, åtskilda med ett kommatecken utan blanksteg.

   Exempel:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest

3. Spara filen configuration.properties.

För att inaktivera asynkrona begäranden om laddningsplatser:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Ställ in OPTIONAL_CAPABILITIES=None, eller ta helt enkelt bort AsyncLoadSlotRequest om det finns andra OPTIONAL_CAPABILITIES-parametrar.

3. Spara filen configuration.properties.

Konfigurera kopplingsstart

Du kan öka timeout-värdet och antalet försök för start av koppling. Detta kan vara användbart när man utför ett stort antal samtidiga omladdningar. Om du ökar dessa parametrar får Gateway med direktåtkomst mer tid och fler försök att köra kopplingen innan den avslutas med fel och kräver en omstart.

För att justera startparametrar för koppling:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Lägg till följande rad i filen:

   # 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

   Anteckning om information För att förhindra överbelastning av kommandoröret måste AsyncLoadDataRequest vara aktiverat för att dessa värden ska kunna justeras, enligt beskrivningen i avsnittet Begära laddningsplatser asynkront ovan. Dessa inställningar kommer att återgå till de fasta äldre värdena 30 respektive 3 när AsyncLoadSlotRequest inaktiveras.
3. Spara filen configuration.properties.

Åsidosättande av standardstartporten som ställts in av processisolering

När processisolering är aktiverat kan du nu åsidosätta standardstartporten (49152) som Gateway med direktåtkomst använder för interprocesskommunikation med alla isolerade kopplingsprocesser. Detta kan vara användbart när standardporten används av en annan process.

För att göra detta:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Under # Connector Agent delavsnittet, lägg till följande rad i filen:

   DATA_PORT_RANGE_START=port-value

   där port-value är standardstartporten.

3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Mer detaljer i felmeddelanden vid koppling till ODBC-datakällor

På grund av säkerhetsskäl innehåller standardfelmeddelandet som returneras av ODBC-drivrutinen minimal information. I vissa scenarier kan du dock behöva mer information för att felsöka ett specifikt problem. Om du vill få ett mer detaljerat felmeddelande lägger du till egenskapen ShowErrorDetailMessage i delavsnittet Avancerat i dialogrutan för kopplingen och ställer in den på True. När du har löst ditt problem rekommenderas det starkt att du antingen tar bort egenskapen eller ställer in den på False för optimal säkerhet.

Mätvärdesinsamlare

I en typisk kundmiljö passerar många datainläsningar genom Gateway med direktåtkomst in i Qlik Cloud Analytics dagligen. Möjligheten att logga och övervaka resursförbrukning och -utnyttjande som påverkas av dessa ominläsningar kommer att hjälpa kunder att planera sina ominläsningar som följd.

Den nya mätvärdesinsamlaren (som körs i bakgrunden på Gateway med direktåtkomst-datorn) erbjuder grundläggande loggning och övervakning av resursutnyttjande av Gateway med direktåtkomst, kopplingar och operativsystemet. Mätvärdesinsamlaren kan antingen konfigureras lokalt i en JSON-fil eller via det offentliga API:et.

Konfigurera mätvärdesinsamlaren

Öppna följande fil på Gateway med direktåtkomst-datorn och konfigurera den efter behov:

<INSTALL_DIR>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

Konfigurera insamlarinställningar (MetricsCollectorSettings)

• Enabled: Ange till true (standard) för att aktivera insamling av mätvärden eller false för att inaktivera den.

• BaseScrapeIntervalSeconds: Hur ofta avsökning ska ske för kopplingens mätvärden i sekunder. Varje koppling har sitt eget avsökningsintervall.

• Port: Porten som används av API eller mätvärdeskopplingen (REST via Gateway med direktåtkomst).

• LocalDataRetentionDays: Data som är äldre än det angivna värdet kommer att tas bort från den lokala databasen.

• DataRetentionCheckIntervalMinutes: Frekvensen för kvarhållningskontrollen.

• LocalDatabaseFileLocation: Platsen för den lokala databasen. Detta kan också vara en UNC-sökväg. Standardsökvägen är C:\ProgramData\Qlik\Gateway\tmp.

Konfigurera kopplingsinställningar (ConnectorConfigurations)

För alla Gateway med direktåtkomst kopplingar kan du ställa in intervall för mätvärdesavsökning (ScrapeIntervalSeconds) och aktivera (true) eller inaktivera (false) insamling av mätvärden.

Exempelfil 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
    }
  }
}

Läser in mätvärden

Använd REST-kopplingen (via Gateway med direktåtkomst) för att samla in mätvärdena från Gateway med direktåtkomst -datorn.

För att göra detta:

1. I inställningarna för REST (via Gateway med direktåtkomst)-koppling, aktivera Tillåt arbete med localhost-koppling.

   Se Skapa en REST-koppling (endast på engelska) för information.

2. Lägg till http://localhost:5052/api/metrics i listan över tillåtna URL:er.

   Se Begränsa URL:erna som Gateway med direktåtkomst kan komma åt med REST-kopplingen ovan.

3. Starta om Gateway med direktåtkomst-tjänsten.

4. Skapa en app och läs in måtten från http://localhost:5052/api/metrics via REST-kopplingen (via Gateway med direktåtkomst).

Mått som stöds

• Systemmått:

  • network_bytes_sent_total: Det totala antalet byte som överförts via Gateway med direktåtkomst sedan systemet startades

  • network_bytes_received_total: Det totala antalet byte som tagits emot via Gateway med direktåtkomst sedan systemet startades

• Kopplingsmått:

  • process_start_time_seconds: Tid som förflutit sedan processen startade i sekunder.

  • process_cpu_seconds_total: Det kumulativa antalet sekunder som en CPU har varit i ett specifikt tillstånd

  • process_virtual_memory_bytes: Den aktuella storleken, i byte, av det virtuella minne som förbrukas av processen.

  • process_working_set_bytes: Den aktuella storleken, i byte, för processens arbetsuppsättning.

  • process_private_memory_bytes: Den aktuella storleken, i byte, av det privata minne som förbrukas av processen.

  • process_num_threads: Antalet trådar som används av processen.

Visa och ladda ner loggfiler

Loggfilerna innehåller information om åtgärder i Gateway med direktåtkomst. Qlik Supporten kan be dig att tillhandahålla loggfiler för att felsöka. Du kan visa eller ladda ner loggfiler i loggvisaren. Normalt finns det ingen anledning att gå igenom loggfiler men om det upptår återkommande fel eller andra problem kan loggfilerna ofta hjälpa till att identifiera orsaken.

Öppna loggvisaren:

1. Gå till Datagateways i aktivitetscentret för Administration och leta upp Gateway med direktåtkomst.

2. Klicka på i slutet av raden och välj Visa loggar.

   Fönstret med loggvisaren öppnas.

3. I listrutan uppe till vänster väljer du typ av logg som Qlik-supporten har bett dig visa eller ladda ner.

   Följande loggar är tillgängliga:

   • Gateway med direktåtkomst-loggar (DirectAccessAgent)
   • DCaaS-loggar (dcaas_logs)
   • ODBC-baserade kopplingsloggar (odbc-connector_logs)
   • SAP BW-kopplingsloggar (QvSAPBwConnector-<date + timestamp>)
   • SAP SQL-kopplingsloggar (QvSqlBwConnector-<date + timestamp>)

   • Loggar för kopplingsagenter (connector-agent_logs_<date>)

   • Loggar för SAP ODP och SAP Report-kopplingar (QvSapConnectorPackage-<process_id>)

   • Loggar för REST-koppling (rest-connector_logs_<timestamp>)

   • Loggar för filkoppling (file-connector_logs_<timestamp>)

   Anteckning om informationFrån och med Gateway med direktåtkomst 1.7.1 skrivs start-, avslutnings- och omstartshändelser för kopplingar till loggfilen Gateway med direktåtkomst(DirectAccessAgent). I tidigare versioner skrevs de till loggfilen Loggar för kopplingsagenter (connector-agent_logs_<date>).

4. I listrutan bredvid kan du välja loggen som du vill visa eller ladda ner. Loggfilerna är ordnade från nyaste (den vid tillfället aktiva loggfilen) till den äldsta. När du väljer loggfil kan du använda knapparna och för att hoppa till början eller slutet av loggfilen.

   Anteckning om tipsVyn för loggfilen uppdateras inte automatiskt med de senaste meddelandena. För att uppdatera klickar du på för att rulla till slutet av loggfilen som uppdaterats med de senaste meddelandena.

5. Klicka på Ladda ner för att ladda ner loggfilen.

   Filen kommer antingen att laddas ner till din dator eller så kommer du att bli ombedd att spara den, beroende på din webbläsarinställningar.

Öppna Gateway med direktåtkomst-loggar på Gateway med direktåtkomst-maskinen

Förutom att kunna hämta Gateway med direktåtkomst-loggarna (DirectAccessAgent) från aktivitetscentret för Administration kan du även öppna dem direkt frånGateway med direktåtkomst-maskinen. Med en standardinstallation finns dessa loggar på följande platser:

C:\Programfiler\Qlik\ConnectorAgent\data\logs

Ändra loggningsnivån för DirectAccessAgent

I felsökningssyfte kan du behöva ändra loggningsnivån för DirectAccessAgent-loggar. DirectAccessAgent ansvarar för kopplingen till Qlik Cloud-tjänster. För att visa och ändra loggningsdetaljnivån för DirectAccessAgent-loggarna kör du följande kommando från undermappen i ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent med en standardinstallation):

• För att visa den aktuella loggningsnivån kör du:

  connectoragent configuration getloggers

• För att ställa in loggningsnivån till Trace kör du:

  connectoragent configuration setloggers -l Root -v DEBUG

• För att ställa in loggningsnivån till Verbose kör du:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Ytterligare loggningsalternativ finns i Konfigurera Gateway med direktåtkomst i Qlik Cloud nedan.

Uppdatera registreringsnyckeln

Trots att det är osannolikt så kan det hända att nyckeln blir skadad eller så kan det finnas misstanke om obehörig åtkomst av datagatewayservern och det är då nödvändigt att ändra registreringsnyckeln.

För att uppdatera registreringsnyckeln:

1. På gatewayservern för direktåtkomst ska du öppna ett kommandofönster och ändra arbetskatalogen till ConnectorAgent-undermappen (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent med en standardinstallation).

2. Kör sedan följande kommando:

   • Generera den nya nyckeln:

     connectoragent qcs generate_keys

   • Visa nyckeln:

     connectoragent qcs get_registration

     Nyckeln visas:

     

3. Kopiera hela nyckeln så som visas i exemplet ovan.

4. I aktivitetscentret för Administration öppnar du inställningarna för datagateway genom att klicka på -knappen i slutet av relevant rad och välja Redigera.

5. Klistra in nyckeln i Nyckel-fältet (och byt ut aktuell nyckel) och spara inställningarna.

6. Gå tillbaka till gatewayservern för direktåtkomst och starta om Qlik Data Gateway – direktåtkomst-tjänsten så som beskrivs i Hantera Qlik Data Gateway – direktåtkomst-tjänsten.