Rozwiązywanie problemów z modułem Data Gateway
Aby wyświetlić strony "Status", "Dzienniki" i "Zapytanie" w celu monitorowania ruchu połączeń zdalnych oraz rozwiązania typowych problemów z połączeniem i wydajnością, należy na stronie agenta Data Gateway użyć odpowiednich opcji z Nawigatora.
Diagnozowanie za pomocą strony "Status" problemów z połączeniem
Za pomocą tej strony można sprawdzać żądania, które agent Data Gateway kieruje do odległej bazy danych.
Aby sprawdzić żądania do bazy danych, należy na stronie agenta Data Gateway kliknąć kolejno Nawigator i Status.
- Aby wyszukać wg daty, wprowadzić w polu Wyszukiwanie zlecenia całą lub częściową datę i godzinę w formacie "YYYY-MM-DD HH-MM-SS". Na przykład, aby wyszukać wpisy z 28 marca 2022 roku, wpisać "2022-03-28".
- Aby wyszukać zlecenia zakończone niepowodzeniem, wprowadzić w polu Wyszukiwanie zlecenia tekst "REQUEST FINISHED WITH ERRORS".
Aby sprawdzić wszystkie zlecenia, wyczyścić pole Wyszukiwanie zlecenia.
.png"
Aby wyświetlić szczegółowe informacje o statusie, kliknąć zlecenie.
.png"
Diagnozowanie za pomocą strony "Dzienniki" problemów z połączeniem
Strona ta umożliwia przejrzenie wpisów dziennika agenta Data Gateway, dzięki czemu można analizować ruch przez połączenia.
Aby przejrzeć wpisy dziennika, należy na stronie agenta Data Gateway kliknąć kolejno Nawigator i Dzienniki. Włączyć opcję Włącz odpytywanie dzienników, po czym wybrać odpowiedni poziom rejestrowania w dzienniku. Na przykład, aby zdiagnozować problemy z połączeniem, można ustawić Typ dziennika na Wykrywanie błędów.
.png"
Gdy rozwiązywanie problemów zostanie ukończone, Oracle zaleca albo wyłączenie opcji Włącz odpytywanie dzienników, albo dostosowanie typu dziennika tak, aby rejestrować mniej informacji.
Diagnozowanie za pomocą strony "Zapytanie" problemów z połączeniem
Za pomocą tej strony można kierować z agenta Data Gateway zapytania do odległej bazy danych w celu przetestowania połączenia i dostępu.
Aby uruchomić zapytanie z użyciem kodu SQL bezpośrednio z agenta Data Gateway do lokalnej bazy danych, należy na stronie agenta Data Gateway kliknąć kolejno Nawigator i Zapytanie. Na przykład można skopiować tekst zapytania, opis połączenia i klasę sterownika z wyświetlanego na stronie "Status" zlecenia zakończonego niepowodzeniem. Następnie, aby sprawdzić wynik i statystyki wykonywania (poświęcony czas), należy podać uwierzytelnienia do bazy danych i uruchomić zapytanie. Uwaga: Odległa baza danych musi obsługiwać połączenie, w którym jest używany opis połączenia JDBC.
.png"
Problemy z połączeniami zdalnymi i wskazówki
Przedstawiono tu niektóre możliwe problemy z połączeniami zdalnymi oraz zamieszczono wskazówki, jak te problemy rozwiązać.
Problemy z pulpitami informacyjnymi i analizami
| Zgłaszany problem | Postępowanie |
|---|---|
| Kod błędu 603 - nie jest podłączony żaden agent |
Sprawdzić, czy agent Data Gateway działa i został włączony na stronie konfiguracji modułu Data Gateway. Dla modułu Data Gateway w systemie Linux: Uruchomić skrypt $ <katalog instalacji modułu Data Gateway>/domain/bin/status.sh i zobaczyć, czy "Data Gateway Status" ma wartość UP czy DOWN. Dla modułu Data Gateway w systemie Windows: Sprawdzić kartę Menedżer zadań > Szczegóły pod kątem procesów "datagateway.exe". |
| [nQSError: 77031] Występuje błąd podczas wywoływania odległej usługi DatasourceService. Szczegóły: [JDSError: 78] Błąd - niepoprawna postać adresu URL | Sprawdzić pulę połączeń w modelu semantycznym i zweryfikować ustawienia na kartach "Ogólne" i "Różne". |
Problemy z połączeniami lub zbiorami danych
| Zgłaszany problem | Postępowanie |
|---|---|
| Kod błędu 603 - nie jest podłączony żaden agent | Sprawdzić, czy agent Data Gateway działa. Dla modułu Data Gateway w systemie Linux: Uruchomić skrypt $ <katalog instalacji modułu Data Gateway>/domain/bin/status.sh i zobaczyć, czy "Data Gateway Status" ma wartość UP czy DOWN. Dla agentów Data Gateway w systemie Windows: Sprawdzić w Menedżerze zadań kartę "Szczegóły" pod kątem procesów "datagateway.exe". |
| Nie udało się zapisać połączenia. Podano niepoprawne szczegóły połączenia. Proszę podać poprawne szczegóły, po czym ponowić próbę. | Ten komunikat o błędzie pojawia się w oknie dialogowym "Połączenie", gdy jest tworzone połączenie z serwerem DB2 lub SQL.
Na stronie "Status" jest także wyświetlany komunikat Obejście:
|
| JDSError : 110 - Niepoprawny opis/URL połączenia z zewnętrznym źródłem | Sprawdzić, czy agent Data Gateway może się połączyć ze źródłem danych. Na przykład, łącząc się z bazą danych Oracle Database, uruchomić na komputerze, na którym jest zainstalowany moduł Data Gateway, polecenie testujące "telnet <nazwa_hosta> <port>". |
| Nie są wyświetlane żadne kolumny | Uaktualnić oprogramowanie agenta Data Gateway. Ten problem zazwyczaj występuje, jeśli jest używana wcześniejsza aktualizacja agenta Data Gateway, niezgodna z aktualizacją Oracle Analytics Cloud. |
| Brak opcji "Użyj połączenia z odległymi danymi" |
Sprawdzić w konsoli, czy na stronie "Połączenia z odległymi danymi" jest włączona opcja Włącz Data Gateway. |
Problemy ogólne
| Zgłaszany problem | Postępowanie |
|---|---|
| Zmiana stanu agenta zakończyła się niepowodzeniem. Został wyświetlony komunikat "Agent name or Oracle Analytics Cloud URL not specified" (Nie określono nazwy agenta lub adresu URL usługi Oracle Analytics Cloud) lub "Key pair not generated" (Nie wygenerowano pary kluczy). | Kliknąć Zapisz, a następnie Włącz. Jeśli problem będzie nadal występował, zrestartować aplikację. W razie potrzeby sprawdzić sieć. |
| Przy teście jest zwracany komunikat "Niepowodzenie identyfikacji; błąd: 401". Możliwe przyczyny:
- Klucz agenta Data Gateway nie został skopiowany na stronę "Połączenia z odległymi danymi" w konsoli Oracle Analytics Cloud. Użytkownik mógł kliknąć przycisk "Test" przed wklejeniem klucza na stronie OAC > Konsola > Połączenia z odległymi danymi. - Klucz agenta Data Gateway został ponownie wygenerowany, lecz nie został skopiowany na stronę "Połączenia z odległymi danymi" w konsoli Oracle Analytics Cloud. Na przykład agent Data Gateway mógł zostać zarejestrowany na stronie "Połączenia z odległymi danymi", lecz jego ID różni się od "id" klucza na stronie startowej agenta Data Gateway. |
Jeśli klucz agenta Data Gateway nie został skopiowany na stronę, to aby go zarejestrować, należy wkleić klucz w konsoli. Jeśli klucz agenta Data Gateway został ponownie wygenerowany, należy usunąć agent Data Gateway w konsoli, po czym - aby ponownie zarejestrować klucz - wkleić nowy klucz w konsoli. |
| Przy zapisywaniu jest zwracany komunikat "Niepowodzenie identyfikacji; błąd: 404".
Zazwyczaj błąd ten się pojawia, gdy instancja Oracle Analytics została zaktualizowana. |
Zob. - Guidance For Using Remote Data Gateway on Environments Upgraded From Oracle Analytics Cloud 105.2 and Lower (Doc ID 2574387.1) - Oracle Analytics Cloud - Classic : How to Enable Remote Data Gateway in Customer Managed Oracle Analytics Cloud-Classic Instance Upgraded from 105.2 or Lower Release (Doc ID 2632064.1). |
| Przy teście jest zwracany komunikat "Niepoprawny URL usługi OAC"/"Nieznany wyjątek dot. hosta" lub nie jest zwracany żaden błąd ani komunikat.
Możliwe przyczyny: - Na stronie startowej agenta Data Gateway określono niepoprawny URL. Na przykład mógł zostać podany URL podobny do https://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/ui lub https://oacinst-tenancy.analytics.ocp.oraclecloud.com/analytics - Nie ma odpowiedniej trasy sieciowej od agenta Data Gateway do instancji Oracle Analytics Cloud. Na przykład w celu zapewnienia dostępu do Internetu może być używany serwer proxy, a zapora sieciowa blokuje dostęp z agenta Data Gateway do Oracle Analytics Cloud. Jeśli serwer proxy nie jest wymagany, potwierdzić możliwość uzyskania połączenia z komputera, na którym działa Data Gateway, do Oracle Analytics Cloud. |
Jeśli na stronie startowej agenta Data Gateway określono niepoprawny URL, to zaktualizować go w polu URL. Jeśli na przykład adresem URL dla Oracle Analytics Cloud jest Nie ma odpowiedniej trasy sieciowej od agenta Data Gateway do instancji Oracle Analytics Cloud: - W systemie Linux uruchomić polecenie: $ sudo traceroute -T -p 443 https://<szczegóły instancji>.oraclecloud.com - W systemie Windows uruchomić polecenie: C:\> telnet https://<szczegóły instancji>.oraclecloud.com 443. Jeśli serwer proxy jest wymagany, sprawdzić jego szczegóły dla Data Gateway. Zob. Niepoprawny URL usługi Oracle Analytics Cloud (Data Gateway nie może się skomunikować z Oracle Analytics Cloud). |
|
Niepoprawny URL usługi Oracle Analytics Cloud (Data Gateway nie może się skomunikować z Oracle Analytics Cloud) |
|
| Pogorszenie wydajności | Na stronie "Dzienniki" wyszukać:
Po znalezieniu wpisów dziennika kliknąć zlecenie, po czym w oknie dialogowym "Status żądania" sprawdzić czas (w milisekundach) w polu "Upłynęło". Aby uzyskać wskazówki dotyczące określania rozmiaru modułu Data Gateway, należy skontaktować się z zespołem obsługującym konto klienta. |
| Test na stronie "Połączenia z odległymi danymi" konsoli kończy się niepowodzeniem |
Jeśli test kończy się niepowodzeniem, znaczy to, że agent Data Gateway nie może zostać zidentyfikowany z różnych powodów, w tym następujących:
|
