Rozwiązywanie problemów z Brama dostępu bezpośredniego
W tej sekcji opisano różne czynności, które można wykonać w celu rozwiązania problemów z Brama dostępu bezpośredniego.
Przeglądanie i pobieranie plików dziennika
Pliki dziennika dostarczają informacji o operacjach Brama dostępu bezpośredniego. Qlik Pomoc techniczna może Cię poprosić o dostarczenie plików dziennika w celu rozwiązania problemów. Pliki dziennika można przeglądać lub pobierać w Podglądzie dziennika. W normalnych okolicznościach nie ma powodu, aby sprawdzać pliki dziennika, ale jeśli wystąpią powtarzające się awarie lub inne problemy, pliki dziennika często pomogą określić ich przyczynę.
Aby otworzyć Podgląd dziennika:
-
W centrum aktywności Administrowanie przejdź do pozycji Bramy danych i znajdź Brama dostępu bezpośredniego.
-
Kliknij
na końcu wiersza i wybierz pozycję Zobacz dzienniki.
Zostanie otwarte okno Podgląd dziennika.
-
Z listy rozwijanej w lewym górnym rogu wybierz typ dziennika, o którego przejrzenie lub pobranie poprosił Cię zespół pomocy technicznej Qlik.
Dostępne są następujące dzienniki:
- Dzienniki Brama dostępu bezpośredniego (DirectAccessAgent)
- Dzienniki DCaaS (dcaas_logs)
- Dzienniki łącznika opartego na ODBC (odbc-connector_logs)
- Dzienniki łącznika SAP BW (QvSAPBwConnector-<data + znacznik czasu>)
- Dzienniki łącznika SAP ODP (QvSapConnectorPackage-<process_id>)
- Dzienniki łącznika SAP SQL (QvSqlBwConnector-<data + znacznik czasu>)
- Dzienniki agenta łącznika (connector-agent_logs_<data>)
-
Z sąsiedniej listy rozwijanej wybierz dziennik, który chcesz wyświetlić lub pobrać. Pliki dzienników są uporządkowane od najnowszego (aktualnie aktywnego pliku dziennika) do najstarszego. Po wybraniu pliku dziennika można użyć przycisków
i
, aby przejść odpowiednio na początek lub koniec pliku dziennika.
WskazówkaWidok pliku dziennika nie jest aktualizowany automatycznie o najnowsze komunikaty. Aby zaktualizować widok, kliknij ikonęw celu przejścia do końca pliku dziennika odświeżonego o najnowsze komunikaty.
-
Aby pobrać plik dziennika, kliknij Pobierz.
Plik zostanie pobrany na komputer lub pojawi się monit o jego zapisanie, w zależności od ustawień przeglądarki.
Otwieranie dzienników Brama dostępu bezpośredniego na komputerze z Brama dostępu bezpośredniego
Oprócz możliwości pobierania dzienników Brama dostępu bezpośredniego (DirectAccessAgent) z centrum aktywności Administrowanie można je także otwierać bezpośrednio z komputera z Brama dostępu bezpośredniego. W przypadku domyślnej instalacji dzienniki te znajdują się w następującym folderze:
C:\Program Files\Qlik\ConnectorAgent\data\logs
Zmiana poziomu rejestrowania
Poziom rejestrowania dzienników bramy Brama dostępu bezpośredniego można zmienić w sposób opisany poniżej.
Zmiana poziomu rejestrowania komponentów łącznika
Do celów rozwiązywania problemów może być konieczna zmiana poziomu rejestrowania dzienników komponentów łącznika.
W tym celu:
- Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy.
-
Zlokalizuj właściwość <KOMPONENT>_LOG_LEVEL, gdzie COMPONENT może być jedną z następujących wartości:
- AGENT
- DCAAS
- ODBC
- SAPBW
- SAPSQL
- SAPPACKAGE
- FILE
- Ustaw ją na jedną z następujących wartości: ERROR, WARN, INFO lub DEBUG
-
Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
InformacjaPocząwszy od wersji Brama dostępu bezpośredniego 1.7.1, jeśli zmieniono tylko komponent AGENT, nie trzeba ponownie uruchamiać usługi Brama danych Qlik — dostęp bezpośredni.
Zmiana poziomu rejestrowania DirectAccessAgent
Do celów rozwiązywania problemów może być konieczna zmiana poziomu rejestrowania dzienników DirectAccessAgent. DirectAccessAgent odpowiada za połączenie z usługami Qlik Cloud. Aby wyświetlić i zmienić poziom szczegółowości rejestrowania w dziennikach funkcji DirectAccessAgent, uruchom następujące polecenia z podfolderu ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent z domyślną instalacją):
-
Aby wyświetlić bieżący poziom rejestrowania, wykonaj:
connectoragent configuration getloggers -
Aby ustawić poziom rejestrowania na Trace, wykonaj:
connectoragent configuration setloggers -l Root -v DEBUG -
Aby ustawić poziom rejestrowania na Verbose, wykonaj:
connectoragent configuration setloggers -l Root –v DETAILED_DEBUG
Aktualizacja klucza rejestracyjnego
W mało prawdopodobnym przypadku uszkodzenia klucza lub jeśli pojawi się podejrzenie nieautoryzowanego dostępu do serwera bramy danych, może być konieczna zmiana klucza rejestracyjnego.
Aby zaktualizować klucz rejestracyjny:
- Na serwerze bramy Direct Access gateway otwórz wiersz poleceń i zmień katalog roboczy na podfolder ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent w przypadku domyślnej instalacji).
-
Wykonaj następujące polecenia:
-
Wygeneruj nowy klucz:
connectoragent qcs generate_keys
-
Wyświetl klucz:
connectoragent qcs get_registration
Klucz jest pokazany:
-
-
Skopiuj cały klucz, jak pokazano w powyższym przykładzie.
-
W centrum aktywności Administrowanie otwórz ustawienia bramy danych, klikając przycisk
na końcu odpowiedniego wiersza i wybierając pozycję Edytuj.
-
Wklej klucz w polu Klucz (zastępując obecny klucz) i zapisz ustawienia.
-
Wróć do serwera bramy Direct Access gateway i ponownie uruchom usługę Brama danych Qlik — dostęp bezpośredni zgodnie z opisem w temacie Zarządzanie usługą Brama danych Qlik — dostęp bezpośredni.
Wydłużenie czasu trwania sesji przeładowania
Jeśli połączenie pomiędzy Brama dostępu bezpośredniego a Qlik Cloud będzie bezczynne przez co najmniej 20 sekund, operacja przeładowania może czasami zakończyć się niepowodzeniem z następującym komunikatem o błędzie:
Invalid object name '#<TempTableName>' (indicating that the Brama dostępu bezpośredniego temp tables are unavailable).
Domyślny czas trwania sesji wynosi 20 sekund, ale jeśli ten błąd często się pojawia, możesz wydłużyć czas sesji następująco:
-
Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.
- Znajdź parametr ODBC_RELOAD_SESSION_LIFE i zwiększ jego wartość odpowiednio do potrzeb.
- Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
Wydłużenie limitu czasu żądań ładowania
Gdy wystąpią przerwy w działaniu sieci, przeładowanie może się zakończyć niepowodzeniem i mogą wystąpić następujące błędy:
Connector error: The session does not exist (DirectAccess-1509)
Connector error: The stream session expired for the load data request (DirectAccess-1012)
Jeżeli powyższe błędy występują często, spróbuj ustawić parametr EXTEND_FIRST_REQUEST_TIMEOUT na 5–10 minut.
Wykonaj następujące czynności:
-
Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.
- Znajdź parametr EXTEND_FIRST_REQUEST_TIMEOUT i zwiększ jego wartość do 5–10 minut. Wartość domyślna to 0.
- Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
Łagodzenie awarii łącznika podczas przeładowywania
Izolacja procesów umożliwia administratorom mającym bezpośredni dostęp do systemu operacyjnego serwera bramy kontrolowanie liczby procesów dostępnych do przeładowania w zależności od typu łącznika. Rozłożenie przeładowań na wiele procesów łącznika zwiększa poziom izolacji przez zmniejszenie liczby przeładowań działających jednocześnie w każdym procesie łącznika. To z kolei może poprawić ogólną stabilność Brama dostępu bezpośredniego w przypadku awarii łącznika.
Wymaga Brama dostępu bezpośredniego w wersji 1.6.1 lub nowszej.
Wyłączanie izolacji procesu
Pomoc techniczna Qlik może Cię poprosić o wyłączenie izolacji procesów w celu rozwiązywania problemów.
Aby wyłączyć izolację procesu:
- Otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.
-
Ustaw opcję [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Koloruj wszystkie wiersze wg warunku) na wartość None (Wskazane wiersze).
- Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
Włączanie izolacji procesów lub zmiana liczby jednoczesnych przeładowań
Aby włączyć izolację procesów lub zmienić liczbę jednoczesnych przeładowań:
-
Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.
Plik zawiera trzy prefiksy odpowiadające różnym typom łącznika:ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> i SAPPACKAGE_<property-name>
-
Ustaw [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE na Load i [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT na N.
Gdzie:
N= Jeden proces polecenia + Liczba jednoczesnych procesów przeładowania do przydzielenia. Na przykład wartość 10 oznaczałaby maksymalnie 9 równoczesnych przeładowań.
- Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
Przykłady izolacji procesu łącznika ODBC
Poniższy fragment pliku configuration.properties pokazuje, jak włączyć izolację procesu łącznika ODBC dla maksymalnie 12 przeładowań:
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=13
Buforowanie danych na potrzeby przeładowania w razie problemu
Dla każdej operacji przeładowania Brama dostępu bezpośredniego może buforować fragmenty danych w pamięci i przenosić je na dysk (gdy rozmiar przydzielony do buforowania zostanie przekroczony). Jest to szczególnie przydatne, jeśli nie korzystasz z automatycznego odzyskiwania i często napotykasz na błędy 4025, 4020 i 4021. Funkcję tę można włączyć, ustawiając próg rozmiaru pamięci podręcznej na potrzeby przenoszenia fragmentów danych na dysk (do każdego przeładowania). Po osiągnięciu określonego progu brama przekaże dalsze zaszyfrowane fragmenty na dysk komputera bramy Brama dostępu bezpośredniego.
Aby ustawić rozmiar pamięci podręcznej:
-
Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.
-
Ustaw RELOAD_CACHE_MEMORY_MB na N (wartość domyślna to 0, co oznacza, że funkcja nie jest włączona).
Gdzie:
N = ilość pamięci przydzielonej do buforowania fragmentów danych (na przeładowanie)
InformacjaWłączenie tej funkcji zwiększy zużycie pamięci na komputerze z Brama dostępu bezpośredniego, dlatego zalecamy monitorowanie wpływu na pamięć, gdy jest ona włączona. W większości sytuacji ustawienie wartości RELOAD_CACHE_MEMORY_MB na 100 powinno wystarczyć. - Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
Zastępowanie domyślnego katalogu pamięci podręcznej fragmentów danych
Dla każdej operacji przeładowania Brama dostępu bezpośredniego może buforować fragmenty danych w pamięci i przenosić je na dysk (gdy rozmiar przydzielony do buforowania zostanie przekroczony). Można zastąpić domyślny katalog pamięci podręcznej fragmentów danych ((C:\ProgramData\Qlik\Gateway\tmp), jeśli nie ma wystarczającej ilości miejsca na dysku systemowym.
Wykonaj następujące czynności:
- W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy.
-
Zlokalizuj właściwość OVERRIDE_CHUNKS_CACHE_DIR i ustaw ją na wybrany katalog.
Przykład:
OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp
InformacjaNie umieszczaj ścieżki w cudzysłowie. - Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
Zastąpienie domyślnego typu danych Qlik Cloud podczas pracy z łącznikiem ODBC (za pośrednictwem Brama dostępu bezpośredniego)
Czasami, ze względu na problem z obsługą typów danych źródłowych przez sterownik ODBC dostawcy, podczas przeładowywania występował błąd lub nieprawidłowe dane były ładowane do Qlik Cloud. W takich przypadkach można zastąpić typ danych Qlik Cloud lub jego specyfikację (na przykład skalę lub precyzję).
Wykonaj następujące czynności:
- W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\custom_type_mapping.json jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy. Ten plik zawiera przykładowe źródło typów danych Qlik Cloud.
-
Dodaj sekcję, która mapuje problematyczny typ danych na pożądany typ danych Qlik Cloud.
W poniższym przykładzie (który jest zawarty w pliku custom_type_mapping.json) klient musi zmienić rozmiar typu danych Qlik Cloud DateTime na 27.
{
"Identifier": "Amazon Athena ODBC (x64)",
"NativeDataType": "timestamp with time zone",
"QlikDataType": "DateTime",
"Size": 27,
"IsBit": false
}
- Zapisz plik custom_type_mapping.json i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
- Przeładuj dane.
Wymuszanie ponownego połączenia Brama dostępu bezpośredniego z Qlik Cloud
Jeżeli brama Brama dostępu bezpośredniego zostanie rozłączona z Qlik Cloud, powinna domyślnie połączyć się ponownie po 45 sekundach. Jeśli zauważysz, że trwa to znacznie dłużej, możesz wymusić na bramie szybsze ponowne połączenie.
Wykonaj następujące czynności:
- W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy. Ten plik zawiera przykładowe źródło typów danych Qlik Cloud.
-
Dodaj AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> do sekcji # Connector Agent na początku pliku.
Przykład:
AGENT_PONG_TIMEOUT_SECONDS=30
InformacjaMinimalny czas to 30 sekund. - Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
Zwiększenie szczegółowości komunikatów o błędach podczas połączenia ze źródłami danych ODBC
Ze względów bezpieczeństwa domyślny komunikat o błędzie zwracany przez sterownik ODBC zawiera minimalną ilość informacji. Jednak w niektórych sytuacjach do rozwiązania problemu może być potrzebne więcej informacji. Aby uzyskać bardziej szczegółowy komunikat o błędzie, dodaj właściwość ShowErrorDetailMessage do sekcji Zaawansowanew oknie dialogowym łącznika i ustaw ją na True. Po rozwiązaniu problemu, w celu zapewnienia optymalnego bezpieczeństwa, zdecydowanie zaleca się usunięcie tej właściwości lub ustawienie jej na False.