Narzędzie Sosreport

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Sosreport to narzędzie do diagnostyki i zbierania danych na poziomie systemu, które działa na zasadach open source oprogramowania SoS. Narzędzie Sosreport umożliwia zbieranie informacji ułatwiających rozwiązywanie problemów w węzłach, w których Apigee jest uruchomiony komponent. Narzędzie gromadzi i przechowuje informacje lokalnie w systemie plików węzła.

Narzędzie Sosreport zbiera szczegóły konfiguracji, informacje o systemie informacje diagnostyczne z systemu i przechowuje dane w archiwum. W przypadku komponentów Apigee Sosreport zbiera te dane:

  • Działająca wersja jądra systemu
  • Wczytane moduły
  • Pliki konfiguracji systemu i usługi

Sosreport uruchamia także zewnętrzne programy, aby zbierać więcej danych informacji, w tym:

  • Logi Apigee ze wszystkich komponentów.
  • Diagnostyka środowiska wykonawczego
  • Dane diagnostyczne Cassandra zebrane za pomocą poleceń nodetool.

Narzędzie Sosreport zawiera 2 główne polecenia:

  • sosreport: główne polecenie służące do zbierania danych i tworzenia raportów.
  • apigee-sosreport: narzędzie pomocnicze do instalacji sosreport i zarządzaj wtyczkami sosreport związanymi z komponentami Apigee.

Instalacja

Z tej sekcji dowiesz się, jak zainstalować sosreport.

Jeśli wersja SoS systemu sosreport jest już zainstalowana

Jeśli oryginał sosreport w wersji SoS jest już zainstalowany w systemie, nie konfiguruj wersji Apigee, ponieważ ścieżki instalacji mogą kolidować ze sobą. Zamiast tego skopiuj z katalogu wtyczki specyficzne dla Apigee /opt/apigee/apigee-sosreport/source/plugin do odpowiedniego Pythona site-packages przy użyciu polecenia takiego jak poniżej. Aby na przykład skopiować adres agigee-mgmt.py:

  • Jeśli używasz Pythona 2, wpisz: 
    sudo cp apigee-mgmt.py /usr/lib/python2.7/site-packages/sos/plugins/
  • Jeśli używasz Pythona 3, wpisz: 
    sudo cp apigee-mgmt.py /usr/local/lib/python3.6/site-packages/sos/plugins/

Aby sprawdzić, czy wtyczki zostały zainstalowane, wpisz

sudo sosreport --list-plugins

Jeśli masz pytania, skontaktuj się z zespołem pomocy Apigee.

Instaluję wersję sosreport Apigee

Jeśli wersja SoS sosreport nie jest jest już zainstalowany w Twoim systemie, możesz zainstalować wersję Apigee, wpisując następujące polecenia na wszystkich węzłach, w których zainstalowano Edge for Private Cloud: 

/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport install
/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport setup

Aby sprawdzić, czy przeglądarka sosreport została zainstalowana, sprawdź, czy wtyczki powiązane z Apigee znajduje się w tym katalogu:

/usr/lib/pythonx.x/site-packages/sos/plugins

gdzie pythonx.x to zainstalowana wersja Pythona.

Możesz też uruchomić jedno z tych poleceń:

  • Aby zweryfikować tylko wtyczki Apigee: 
    apigee-service apigee-sosreport diagnose -l

    Spowoduje to wyświetlenie listy wtyczek typowych dla Apigee.

    sosreport (version 3.9)

The following plugins are currently enabled:

apigee-mgmt          This is the apigee plugin for edge-management-server
apigee-mp            This is the apigee plugin for edge-message-processor
apigee-rrt           This is the apigee plugin for edge-router
apigee-sample        Main diagnostics gatehring class
  • Aby sprawdzić wszystkie wtyczki: 
    apigee-service apigee-sosreport diagnose -s -l

    Powoduje to wyświetlenie listy wtyczek dostępnych w połączeniu z funkcją sosreport:

    sosreport (version 3.9)

The following plugins are currently enabled:

 acpid                ACPI daemon information
 alternatives         System alternatives
 anacron              Anacron job scheduling service
 apigee-cassandra     This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mgmt          This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mp            Main diagnostics gathering class
 apigee-rrt           This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→

………………………………………………….
………………………………………………….
………………………………………………….
←truncated→

Tworzenie raportu

Aby utworzyć raport za pomocą narzędzia Sosreport, uruchom polecenie sosreport z odpowiednią opcją (patrz Wtyczki Apigee). domyślny katalog, w którym jest przechowywany raport, to tmp lub /var/tmp. Możesz zmienić katalog, w którym jest przechowywany raport, przekazując inny katalog na opcję tmp-dir. Aby na przykład utworzyć raport na temat serwer zarządzania i zapisz go w katalogu o nazwie my_report-dir, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf -o apigee-mgmt  --batch --tmp-dir=my_report-dir
  • Korzystanie z wersji SoS raportu sosreport: 
    sudo sosreport -o apigee-mgmt  --batch --tmp-dir=my_report-dir

Raport jest przechowywany w pliku .tar.xz w katalogu określonym za pomocą metody tmp-dir. Lokalizacja pliku .tar.xz jest wyświetlana na platformie STDOUT wraz z sumą kontrolną. Na przykład:

Your sosreport has been generated and saved in:
 /var/sosreport-prc-test-0-9613-2021-07-12-orwxufx.tar.xz
The checksum is: 5a8b97c6020346a688254c8b04ef86ec
For more available options for sosreport, read the man file:
sudo man sosreport

Raport jest przechowywany w pliku .tar.xz w katalogu określonym za pomocą metody tmp-dir. Lokalizacja miejsca .tar.xz file jest wyświetlana na stronie STDOUT, a także w sumy kontrolnej. Na przykład:

Więcej informacji o opcji sosreport znajdziesz w pliku man:

sudo man sosreport

Wtyczki Apigee

W poniższych sekcjach opisano wtyczki Apigee dla narzędzia Sosreport te komponenty:

Serwer zarządzania

Wtyczka apigee-mgmt zbiera następujące informacje z Serwer zarządzania:

  • nazwa hosta serwera (domyślna)
  • cpuinfo (domyślnie)
  • meminfo (domyślnie)
  • ustawień maszyny wirtualnej Java (JVM), takich jak pamięć Djdk.tls.allowUnsafeServerCertChange itd. (domyślnie)
  • Bieżące dzienniki zarządzania (domyślnie)
  • Dziesięć sekwencyjnych zdarzeń wyjściowych Top i jstacks (domyślnie)
  • Cały folder dziennika zarządzania (opcjonalnie)
  • config-files (opcjonalnie)

Przykłady:

Aby zebrać wszystkie elementy domyślne, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch my_report-dir
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-mgmt --batch my_report-dir

Aby zebrać wszystkie elementy domyślne, a także produkty opcjonalne określone w poleceniu, w przypadku polecenia plików konfiguracji i wszystkich dzienników, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

Aby zebrać wszystko, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

    Możesz też wpisać:

    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -a
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

    Możesz też wpisać:

    sudo sosreport -o apigee-mgmt --batch -a

procesor komunikatów

Wtyczka apigee-mp zbiera następujące informacje z Procesor zarządzania (MP):

  • Nazwa hosta serwera (domyślna)
  • cpuinfo (domyślnie)
  • meminfo (domyślnie)
  • informacje o kompilacji/wersji (domyślnie)
  • Stan apigee-all (domyślny)
  • szczegóły serwera (domyślnie)
  • ustawienia na poziomie JVM, na przykład pamięć, Djdk.tls.allowUnsafeServerCertChange, itp. (domyślnie)
  • Bieżące logi MP (domyślnie)
  • Dziesięć sekwencyjnych zdarzeń górnego, jstacks i danych NIO Metrics (domyślnie)
  • Cały folder MP (opcjonalnie)
  • Drzewo klasyfikacji (opcjonalnie)
  • Zrzut stosu (opcjonalnie)
  • config-files (opcjonalnie)
  • Śledzenie środowiska wykonawczego (opcjonalnie i tylko wtedy, gdy org:env:api:rev detail ). Uwaga: wtyczka czeka 25 sekund na zebranie żądań środowiska wykonawczego.

Przykłady:

Aby zebrać wszystkie elementy domyślne, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-mp --batch

Możesz też określić dodatkowe przedmioty do zebrania jako uzupełnienie wszystkich przedmiotów domyślnych. Aby na przykład określić zrzut stosu, używając flagi -k apigee-mp.heap, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.heap
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-mp --batch -k apigee-mp.heap

W podobny sposób możesz określić te elementy opcjonalne:

-k apigee-mp.deployments
-k apigee-mp.heap
-k apigee-mp.all-logs
-k apigee-mp.config-files
-k apigee-mp.trace=gsc-cps:test:httpbin:3

W jednym poleceniu można określić wiele opcji. Na przykład:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs

Aby zbierać wszystko oprócz logu czasu, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -a
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-mp --batch -a

Router

Wtyczka apigee-rrt zbiera następujące informacje z Router:

  • Nazwa hosta serwera (domyślna)
  • cpuinfo (domyślnie)
  • meminfo (domyślnie)
  • informacje o kompilacji/wersji (domyślnie)
  • Stan apigee-all (domyślny)
  • szczegóły serwera (domyślnie)
  • ps. Dzięki temu ustawienia na poziomie JVM, na przykład pamięci, Djdk.tls.allowUnsafeServerCertChange itd. (domyślnie).
  • Logi bieżącego routera (domyślne)
  • Lista nazw plików vhost, w tym nieprawidłowych nazw plików (domyślnie)
  • Cały folder dziennika routera (opcjonalnie)
  • config-files (opcjonalnie)

Przykłady:

Aby zebrać wszystkie elementy domyślne, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-rrt --batch

Możesz też określić dodatkowe przedmioty do zebrania jako uzupełnienie wszystkich przedmiotów domyślnych. Aby na przykład określić cały folder dziennika, przy użyciu flagi -k apigee-rrt.all-logs, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -k apigee-rrt.all-logs
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-rrt --batch -k apigee-rrt.all-logs

W podobny sposób możesz określić te elementy opcjonalne:

-k apigee-rrt.all-logs
-k apigee-rrt.config-files

Aby zebrać wszystko:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -a
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-rrt --batch -a

Cassandra

Wtyczka apigee-cassandra zbiera następujące informacje z: Węzły Cassandra:

  • Statystyki dotyczące komputerów: 
    "hostname -i"
"cat /proc/cpuinfo"
"cat /proc/meminfo"
"ulimit -a"
"ps auxw"
"df -kh"
"du -sh"
"netstat -ntlpu"
"free -h"
"ifconfig -h"
"ps -ef"
  • Stan i wersja komponentu Apigee wersja apigee-all && Stan Apigee-all
  • Logi apigee-cassandra: Wszystkie pliki w domenie /opt/apigee/var/log/apigee-cassandra/
  • Liczba logów zatwierdzenia
  • Wynik polecenia Góra
  • Zrzut wątku
  • Pliki konfiguracji: cassandra-topology.properties, cassandra.yaml, cassandra-env.sh
  • Dane wyjściowe narzędzia Nodetool dla następujących parametrów: version, status, Ring, info, gossipinfo, Compactionstats -H, tpstats, netstats, cfstats, proxyhistograms

Przykład:

Aby zebrać wszystkie elementy domyślne, wpisz jedną z tych wartości:

  • Używam wersji sosreport Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-cassandra
  • Używam wersji SoS sosreport: 
    sudo sosreport -o apigee-cassandra