Edge for Private Cloud w wersji 4.19.01
Apigee Edge dla Private Cloud zawiera apigee-monit
– narzędzie oparte na narzędziu Monit typu open source. apigee-monit
okresowo sonduje usługi Edge. Jeśli usługa jest niedostępna, apigee-monit
próbuje ją ponownie uruchomić.
Aby korzystać z aplikacji apigee-monit
, musisz ją zainstalować ręcznie. Nie jest to część
standardowej instalacji.
Domyślnie apigee-monit
sprawdza stan usług Edge co 60 sekund.
Krótkie wprowadzenie
Poniższa tabela pokazuje, jak od razu zacząć korzystać z usługi apigee-monit
:
Zainstaluj: apigee-monit |
|
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install Spowoduje to zainstalowanie komponentu |
|
Zatrzymywanie komponentów monitorowania | |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name /opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all |
|
Rozpoczęcie monitorowania komponentów | |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all |
|
Uzyskiwanie informacji o stanie podsumowania | |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report /opt/apigee/apigee-service/bin/apigee-service apigee-monit summary |
|
Przejrzyj pliki dziennika usługi apigee-monit |
|
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log |
Każdy z tych i innych zagadnień został szczegółowo opisany w poniższych sekcjach.
Informacje o apigee-monit
apigee-monit
pomaga zapewnić nieprzerwaną pracę wszystkich komponentów w węźle. W tym celu oferuje szereg usług, w tym:
- Ponownie uruchamiam usługi, w przypadku których wystąpił błąd
- Wyświetlanie podsumowania informacji
- Stan monitorowania usługi Logging
- Wysyłanie powiadomień
- Monitorowanie usług innych niż Edge
Apigee zaleca monitorowanie apigee-monit
, aby mieć pewność, że działa. Więcej informacji znajdziesz w artykule o monitorowaniu apigee-monit.
architektura apigee-monit
Podczas instalacji i konfiguracji Apigee Edge dla Private Cloud możesz opcjonalnie zainstalować oddzielną instancję apigee-monit
w każdym węźle w klastrze. Te oddzielne instancje apigee-monit
działają niezależnie od siebie – nie przekazują informacji o stanie swoich komponentów do innych węzłów ani nie informują o awariach narzędzia do monitorowania żadnej centralnej usłudze.
Ten obraz przedstawia architekturę apigee-monit
w klastrze z 5 węzłami:
Obsługiwane platformy
apigee-monit
obsługuje poniższe platformy klastra Private Cloud. (Obsługiwany system operacyjny dla apigee-monit
zależy od wersji Private Cloud.)
System operacyjny | Wersja chmury prywatnej | ||
---|---|---|---|
v4.50.00 | v4.51.00 | v4.52.00 | |
CentOS | 7,5; 7,6; 7,7; 7,8 | 7,5; 7,6; 7,7; 7,8 | 7,5; 7,6; 7,7; 7,8 |
RedHat Enterprise Linux (RHEL) | 7,5; 7,6; 7,7; 7,8 | 7,5; 7,6; 7,7; 7,8; 7,9; 8,0 | 7,5; 7,6; 7,7; 7,8; 7,9; 8,0 |
Oracle Linux | 7,5; 7,6; 7,7; 7,8 | 7,5; 7,6; 7,7; 7,8 | 7,5; 7,6; 7,7; 7,8 |
* Chociaż nie jest to obsługiwane technicznie, możesz zainstalować i używać apigee-monit w CentOS/RHEL/Oracle w wersji 6.9 dla Apigee Edge for Private Cloud w wersji 4.19.01. |
Konfiguracje komponentów
apigee-monit
używa konfiguracji komponentów, aby określić, które komponenty należy monitorować, które aspekty komponentu sprawdzić i jakie podjąć działania w przypadku awarii.
Domyślnie apigee-monit
monitoruje wszystkie komponenty Edge w węźle, używając ich wstępnie zdefiniowanych konfiguracji. Aby wyświetlić ustawienia domyślne, możesz zajrzeć do plików konfiguracji komponentu apigee-monit
. Nie możesz zmienić domyślnych konfiguracji komponentów.
apigee-monit
sprawdza różne aspekty komponentu, w zależności od tego, który komponent sprawdza. W tabeli poniżej znajdziesz informacje o tym, co sprawdza apigee-monit
w przypadku każdego komponentu, oraz informacje o tym, gdzie znajduje się konfiguracja każdego komponentu. Pamiętaj, że niektóre komponenty są zdefiniowane w jednym pliku konfiguracji, a inne mają własne konfiguracje.
Komponent | Lokalizacja konfiguracji | Co jest monitorowane |
---|---|---|
Serwer zarządzania | /opt/apigee/edge-management-server/monit/default.conf |
apigee-monit kontroli:
Dodatkowo w przypadku tych komponentów
|
Procesor wiadomości | /opt/apigee/edge-message-processor/monit/default.conf |
|
Serwer Postgres | /opt/apigee/edge-postgres-server/monit/default.conf |
|
Serwer Qpid | /opt/apigee/edge-qpid-server/monit/default.conf |
|
Router | /opt/apigee/edge-router/monit/default.conf |
|
Cassandra Interfejs Edge OpenLDAP Postgres Qpid Zookeeper |
/opt/apigee/data/apigee-monit/monit.conf |
apigee-monit kontroli:
|
Poniższy przykład przedstawia domyślną konfigurację komponentu edge-router
:
check host edge-router with address localhost restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart" if failed host 10.1.1.0 port 8081 and protocol http and request "/v1/servers/self/uuid" with timeout 15 seconds for 2 times within 3 cycles then restart if failed port 15999 and protocol http and request "/v1/servers/self" and status < 600 with timeout 15 seconds for 2 times within 3 cycles then restart
Ten przykład przedstawia domyślną konfigurację komponentu edge-ui
:
check process edge-ui with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"
Nie możesz zmienić domyślnych konfiguracji komponentów Apigee Edge dla chmury prywatnej. Możesz jednak dodać własne konfiguracje komponentów dla usług zewnętrznych, takich jak docelowy punkt końcowy czy usługa httpd
. Więcej informacji znajdziesz w artykule o konfiguracjach komponentów innych niż Apigee.
Domyślnie apigee-monit
monitoruje wszystkie komponenty w węźle, w którym jest uruchomiona. Możesz ją włączyć lub wyłączyć w przypadku wszystkich komponentów lub poszczególnych komponentów. Aby dowiedzieć się więcej, zobacz:
- Zatrzymywanie i rozpoczynanie monitorowania komponentu
- Zatrzymywanie, uruchamianie i wyłączanie usługi
apigee-monit
Zainstaluj apigee-monit
Aplikacja apigee-monit
nie jest domyślnie zainstalowana. Możesz ją zainstalować ręcznie po uaktualnieniu lub zainstalowaniu Apigee Edge for Private Cloud w wersji 4.19.01 lub nowszej.
W tej sekcji opisaliśmy, jak zainstalować apigee-monit
na obsługiwanych platformach oraz w wersji 6.9 CentOS, RHEL lub Oracle Linux, które nie są obsługiwane.
Informacje na temat uninstalling apigee-monit
znajdziesz w artykule Odinstalowywanie aplikacji apigee-monit
.
Instalowanie apigee-monit na obsługiwanej platformie
Z tej sekcji dowiesz się, jak zainstalować apigee-monit
na obsługiwanej platformie.
Aby zainstalować aplikację apigee-monit
na obsługiwanej platformie:
- Zainstaluj
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
- Skonfiguruj
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- Uruchom
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
- Powtórz tę procedurę w każdym węźle w klastrze.
Instalowanie apigee-monit na nieobsługiwanej platformie
Aplikacja apigee-monit
nie jest obsługiwana w systemie CentOS, RHEL lub Oracle w wersji 6.9, ale w tej sekcji opisano, jak ją zainstalować.
Aby zainstalować apigee-monit
w wersji 6.9 systemu CentOS/RHEL/Oracle Linux:
- Zainstaluj repozytorium Dodatkowe pakiety dla systemu Linux (lub w skrócie EPEL):
sudo yum install epel-release
- Wyłącz EPEL:
yum-config-manager --disable epel
- Tymczasowo włącz EPEL i zainstaluj
monit
:yum --enablerepo=epel install monit
Pamiętaj, że po zainstalowaniu repozytorium
monit
musisz wyłączyć repozytorium EPEL. Opcjaenablerepo
włącza repozytorium tylko w przypadku bieżącego polecenia. - Zainstaluj
apigee-monit
:apigee-service apigee-monit install
apigee-service apigee-monit configure
apigee-service apigee-monit start
- Sprawdź, czy po zainstalowaniu pakietu
apigee-monit
wyłączono EPEL:yum repolist all | grep epel/x86_64 !epel/x86_64 Extra Packages for Enterprise Linu disabled
Ten przykład pokazuje, że repozytorium EPEL jest wyłączone. Jeśli jednak nie jest wyłączona, musisz ją wyłączyć:
sudo yum-config-manager --disable epel
Zatrzymywanie i rozpoczynanie monitorowania komponentów
Gdy usługa zatrzyma się z jakiegokolwiek powodu, apigee-monit
spróbuje ponownie ją uruchomić.
Może to powodować problem, jeśli chcesz celowo zatrzymać komponent. Możesz na przykład zatrzymać komponent, aby utworzyć jego kopię zapasową lub uaktualnić go.
Jeśli apigee-monit
ponownie uruchomi usługę podczas tworzenia kopii zapasowej lub uaktualniania, procedura konserwacji może zostać zakłócona, co może doprowadzić do awarii.
W sekcjach poniżej znajdziesz opcje zatrzymania monitorowania komponentów.
Zatrzymywanie komponentu i wyłączanie jego monitorowania
Aby zatrzymać komponent i wyłączyć jego monitorowanie, wykonaj to polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_namecomponent_name może mieć jedną z tych wartości:
apigee-cassandra
(Cassandra)apigee-openldap
(OpenLDAP)apigee-postgresql
(baza danych PostgreSQL)apigee-qpidd
(kwartał)apigee-sso
(SSO – logowanie jednokrotne)apigee-zookeeper
(ZooKeeper)edge-management-server
(serwer zarządzania)edge-management-ui
(nowy interfejs Edge)edge-message-processor
(procesor wiadomości)edge-postgres-server
(serwer Postgres)edge-qpid-server
(serwer Qpid)edge-router
(router brzegowy)edge-ui
(klasyczny interfejs)
Pamiętaj, że „wszystko” nie jest prawidłową opcją dla opcji stop-component
. Za pomocą stop-component
możesz zatrzymywać i wyłączać monitorowanie tylko 1 komponentu naraz.
Aby ponownie uruchomić komponent i wznowić monitorowanie, wykonaj to polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name
Pamiętaj, że „wszystko” nie jest prawidłową opcją dla opcji start-component
.
Instrukcje dotyczące zatrzymywania i wyłączania monitorowania wszystkich komponentów znajdziesz w artykule Zatrzymywanie wszystkich komponentów i rezygnowanie z ich monitorowania.
Wyłączanie monitorowania komponentu (ale go nie zatrzymuj)
Aby wyłączyć monitorowanie komponentu (ale go nie zatrzymywać), wykonaj to polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_namecomponent_name może mieć jedną z tych wartości:
apigee-cassandra
(Cassandra)apigee-openldap
(OpenLDAP)apigee-postgresql
(baza danych PostgreSQL)apigee-qpidd
(kwartał)apigee-sso
(SSO – logowanie jednokrotne)apigee-zookeeper
(ZooKeeper)edge-management-server
(serwer zarządzania)edge-management-ui
(nowy interfejs Edge)edge-message-processor
(procesor wiadomości)edge-postgres-server
(serwer Postgres)edge-qpid-server
(serwer Qpid)edge-router
(router brzegowy)edge-ui
(klasyczny interfejs)
Aby wznowić monitorowanie komponentu, wykonaj to polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
Wyłącz monitorowanie wszystkich komponentów (ale ich nie zatrzymuj)
Aby wyłączyć monitorowanie wszystkich komponentów (ale ich nie zatrzymywać), wykonaj to polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
Aby wznowić monitorowanie wszystkich komponentów, wykonaj to polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
Zatrzymaj wszystkie komponenty i wyłącz ich monitorowanie
Aby zatrzymać wszystkie komponenty i anulować ich monitorowanie, wykonaj te polecenia:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop
Aby ponownie uruchomić wszystkie komponenty i wznowić monitorowanie, wykonaj te polecenia:
/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
Aby zatrzymać monitorowanie wszystkich komponentów, możesz też wyłączyć apigee-monit
zgodnie z opisem w sekcji Zatrzymywanie, uruchamianie i wyłączanie apigee-monit.
Zatrzymywanie, uruchamianie i wyłączanie Apigee-monit
Jak w przypadku każdej usługi, możesz zatrzymać i uruchomić apigee-monit
za pomocą polecenia apigee-service
. Oprócz tego apigee-monit
obsługuje polecenie unmonitor
, które umożliwia tymczasowe zatrzymanie monitorowania komponentów.
Zatrzymaj apigee-monit
Aby zatrzymać apigee-monit
, użyj tego polecenia:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
Uruchom apigee-monit
Aby uruchomić apigee-monit
, użyj tego polecenia:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
Wyłącz apigee-monit
Możesz zawiesić monitorowanie wszystkich komponentów w węźle, używając tego polecenia:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
Możesz też trwale wyłączyć apigee-monit
, odinstalowując ją z węzła zgodnie z opisem w sekcji Odinstalowywanie usługi apigee-monit
.
Odinstaluj Apigee-monit
Aby odinstalować aplikację apigee-monit
:
- Jeśli skonfigurowano zadanie
cron
do monitorowaniaapigee-monit
, usuń to zadaniecron
przed odinstalowaniemapigee-monit
:sudo rm /etc/cron.d/apigee-monit.cron
- Zatrzymaj
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
- Odinstaluj
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
- Powtórz tę procedurę w każdym węźle w klastrze.
Monitorowanie nowo zainstalowanego komponentu
Jeśli zainstalujesz nowy komponent w węźle, na którym działa apigee-monit
, możesz rozpocząć jego monitorowanie, wykonując polecenie restart
komponentu apigee-monit
. Spowoduje to wygenerowanie nowego pliku monet.conf, który uwzględni go w konfiguracjach komponentów.
Ten przykład uruchamia ponownie instancję apigee-monit
:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart
Dostosuj apigee-monit
Możesz dostosować różne ustawienia apigee-monit
, takie jak:
- Domyślne ustawienia sterowania
apigee-monit
- Globalne ustawienia konfiguracji
- Konfiguracje komponentów innych niż Apigee
Domyślne ustawienia kontroli Apigee-monit
Możesz dostosować domyślne ustawienia sterowania apigee-monit
, takie jak częstotliwość sprawdzania stanu i lokalizacja plików apigee-monit
. Aby to zrobić, edytuj plik właściwości za pomocą metody code with config. Pliki właściwości zostaną zachowane nawet po uaktualnieniu Apigee Edge dla Private Cloud.
W tabeli poniżej opisujemy domyślne ustawienia sterowania apigee-monit
, które możesz dostosować:
Właściwość | Opis |
---|---|
conf_monit_httpd_port |
Port demona httpd . Organizacja apigee-monit używa usługi httpd w swojej aplikacji z panelem oraz włączania raportów/podsumowań. Wartością domyślną jest 2812.
|
conf_monit_httpd_allow |
Ograniczenia dotyczące żądań wysyłanych do demona httpd . apigee-monit używa httpd do uruchamiania swojej aplikacji z panelem i włączania raportów/podsumowań. Ta wartość musi wskazywać hosta lokalnego (hosta, na którym działa httpd .
Aby wymagać podawania nazwy użytkownika i hasła, użyj tej składni: conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1 Podczas dodawania nazwy użytkownika i hasła wstaw znak „\n” między każde ograniczenie. Nie wstawiaj w wartości rzeczywistych znaków nowego wiersza ani znaków powrotu karetki. |
conf_monit_monit_datadir |
Katalog, w którym są przechowywane szczegóły zdarzenia. |
conf_monit_monit_delay_time |
Czas, przez jaki apigee-monit oczekuje od pierwszego załadowania do pamięci, zanim uruchomi się. Ma to wpływ na apigee-monit tylko podczas pierwszego sprawdzania procesu. |
conf_monit_monit_logdir |
Lokalizacja pliku dziennika apigee-monit . |
conf_monit_monit_retry_time |
Częstotliwość, z jaką apigee-monit próbuje sprawdzać każdy proces. Wartość domyślna to 60 sekund. |
conf_monit_monit_rundir |
Lokalizacja plików PID i stanu, których apigee-monit używa do sprawdzania procesów. |
Aby dostosować domyślne ustawienia sterowania apigee-monit
:
- Edytuj ten plik:
/opt/apigee/customer/application/monit.properties
Jeśli plik nie istnieje, utwórz go i jako jego właściciela ustaw użytkownika „apigee”:
chown apigee:apigee /opt/apigee/customer/application/monit.properties
Pamiętaj, że jeśli plik już istnieje, mogą być w nim zdefiniowane dodatkowe właściwości konfiguracji poza tymi podanymi w tabeli powyżej. Nie modyfikuj właściwości innych niż wymienione powyżej.
Ustaw lub zastąp wartości właściwości nowymi wartościami.
Aby na przykład zmienić lokalizację pliku dziennika na
/tmp
, dodaj lub edytuj tę właściwość:conf_monit_monit_logdir=/tmp/apigee-monit.log
- Zapisz zmiany w pliku
monit.properties
. - Skonfiguruj ponownie
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- Załaduj ponownie
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
Jeśli nie możesz ponownie uruchomić przeglądarki
apigee-monit
, sprawdź, czy plik dziennika nie zawiera błędów opisanych w sekcji Uzyskiwanie dostępu do plików dziennikaapigee-monit
. - Powtórz tę procedurę dla każdego węzła w klastrze.
Globalne ustawienia konfiguracji
Możesz zdefiniować globalne ustawienia konfiguracji dla funkcji apigee-monit
, na przykład dodać e-maile z powiadomieniami o alertach. Aby to zrobić, utwórz plik konfiguracji w katalogu /opt/apigee/data/apigee-monit
, a następnie uruchom ponownie przeglądarkę apigee-monit
.
Aby zdefiniować globalne ustawienia konfiguracji dla apigee-monit
:
- Utwórz nowy plik konfiguracji komponentu w tym miejscu:
/opt/apigee/data/apigee-monit/filename.conf
Gdzie filename może być dowolną prawidłową nazwą pliku oprócz „monit”.
- Zmień właściciela nowego pliku konfiguracji na użytkownika „apigee”, jak pokazano w tym przykładzie:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
- Dodaj do nowego pliku globalne ustawienia konfiguracji. Ten przykład pozwala skonfigurować serwer poczty i ustawić odbiorców alertów:
SET MAILSERVER smtp.gmail.com PORT 465 USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD" USING SSL, WITH TIMEOUT 15 SECONDS SET MAIL-FORMAT { from: edge-alerts@example.com subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST } SET ALERT fred@example.com SET ALERT nancy@example.com
Pełną listę globalnych opcji konfiguracji znajdziesz w dokumentacji Monit.
- Zapisz zmiany w pliku konfiguracji komponentu.
- Załaduj ponownie
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
Jeśli
apigee-monit
nie uruchomi się ponownie, sprawdź, czy plik dziennika nie zawiera błędów opisanych w sekcji Uzyskiwanie dostępu do plików dziennikaapigee-monit
. - Powtórz tę procedurę dla każdego węzła w klastrze.
Konfiguracje komponentów innych niż Apigee
Możesz dodać do usługi apigee-monit
własne konfiguracje, aby sprawdzała usługi, które nie są częścią Apigee Edge dla Private Cloud. Możesz na przykład użyć apigee-monit
, aby sprawdzić, czy interfejsy API działają, wysyłając żądania do docelowego punktu końcowego.
Aby dodać konfigurację komponentu inną niż Apigee:
- Utwórz nowy plik konfiguracji komponentu w tym miejscu:
/opt/apigee/data/apigee-monit/filename.conf
Gdzie filename może być dowolną prawidłową nazwą pliku oprócz „monit”.
Możesz utworzyć dowolną liczbę plików konfiguracji komponentów. Możesz na przykład utworzyć oddzielny plik konfiguracji dla każdego komponentu innego niż Apigee, który chcesz monitorować w węźle.
- Zmień właściciela nowego pliku konfiguracji na użytkownika „apigee”, jak pokazano w tym przykładzie:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
- Dodaj do nowego pliku konfiguracje niestandardowe. Ten przykład sprawdza docelowy punkt końcowy na serwerze lokalnym:
CHECK HOST localhost_validate_test WITH ADDRESS localhost IF FAILED PORT 15999 PROTOCOL http REQUEST "/validate__test" CONTENT = "Server Ready" FOR 2 times WITHIN 3 cycles THEN alert
Pełną listę możliwych ustawień konfiguracji znajdziesz w dokumentacji Monit.
- Zapisz zmiany w pliku konfiguracji.
- Załaduj ponownie
apigee-monit
za pomocą tego polecenia:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
Jeśli
apigee-monit
nie uruchomi się ponownie, sprawdź, czy plik dziennika nie zawiera błędów opisanych w sekcji Uzyskiwanie dostępu do plików dziennikaapigee-monit
. - Powtórz tę procedurę dla każdego węzła w klastrze.
Pamiętaj, że dotyczy to tylko komponentów innych niż Edge. Nie możesz dostosować konfiguracji komponentów Edge.
Dostęp do plików dziennika apigee-monit
Usługa apigee-monit
zapisuje w pliku dziennika całą aktywność, w tym zdarzenia, ponowne uruchomienia, zmiany konfiguracji i alerty.
Domyślna lokalizacja pliku dziennika to:
/opt/apigee/var/log/apigee-monit/apigee-monit.log
Domyślną lokalizację możesz zmienić, dostosowując ustawienia elementu sterującego apigee-monit
.
Wpisy w pliku dziennika mają następujący format:
'edge-message-processor' trying to restart [UTC Dec 14 16:20:42] info : 'edge-message-processor' trying to restart 'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'
Nie możesz dostosować formatu wpisów w pliku dziennika apigee-monit
.
Wyświetl stan zagregowany apigee-monit
apigee-monit
zawiera te polecenia, które podają zbiorcze informacje o stanie komponentów w węźle:
Polecenie | Wykorzystanie |
---|---|
report |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report |
summary |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary |
Objaśnienie każdego z tych poleceń znajdziesz bardziej szczegółowo w poniższych sekcjach.
raport
Polecenie report
zawiera podsumowanie informacji o liczbie komponentów, które są aktywne, wyłączone, są obecnie inicjowane i niemonitorowane w węźle. Ten przykład wywołuje polecenie report
:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
Ten przykład przedstawia dane wyjściowe report
w kompleksowej konfiguracji AIO:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report up: 11 (100.0%) down: 0 (0.0%) initialising: 0 (0.0%) unmonitored: 1 (8.3%) total: 12 services
W tym przykładzie 11 z 12 usług zostało zgłoszonych przez usługę apigee-monit
jako działającą. Jedna usługa nie jest obecnie monitorowana.
Przy pierwszym uruchomieniu polecenia report
może wystąpić błąd Connection refused
. W takim przypadku poczekaj na czas trwania właściwości conf_monit_monit_delay_time
i spróbuj jeszcze raz.
podsumowanie
Polecenie summary
zawiera listę wszystkich komponentów i ich stan. Poniżej znajduje się przykład wywołania polecenia summary
:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Ten przykład przedstawia dane wyjściowe summary
w kompleksowej konfiguracji AIO:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary Monit 5.25.1 uptime: 4h 20m Service Name Status Type host_name OK System apigee-zookeeper OK Process apigee-cassandra OK Process apigee-openldap OK Process apigee-qpidd OK Process apigee-postgresql OK Process edge-ui OK Process edge-qpid-server OK Remote Host edge-postgres-server OK Remote Host edge-management-server OK Remote Host edge-router OK Remote Host edge-message-processor OK Remote Host
Jeśli przy pierwszym wykonaniu polecenia summary
wystąpi błąd Connection refused
, poczekaj, aż właściwość conf_monit_monit_delay_time
zostanie ustawiona, i spróbuj ponownie.
Monitorowanie Apigee-Monit
Sprawdzoną metodą jest regularne sprawdzanie, czy w każdym węźle działa apigee-monit
.
Aby sprawdzić, czy apigee-monit
jest uruchomiony, użyj tego polecenia:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
Apigee zaleca okresowe uruchamianie tego polecenia w każdym węźle, w którym działa apigee-monit
.
Możesz to na przykład zrobić za pomocą narzędzia takiego jak cron
, które wykonuje zaplanowane zadania we wstępnie zdefiniowanych odstępach czasu.
Aby użyć narzędzia cron
do monitorowania urządzenia apigee-monit
:
- Dodaj obsługę
cron
, kopiując katalogapigee-monit.cron
do katalogu/etc/cron.d
, jak pokazano w tym przykładzie:cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
- Otwórz plik
apigee-monit.cron
, aby go edytować.Plik
apigee-monit.cron
określa zadaniecron
do wykonania oraz częstotliwość, z jaką ma być wykonywane. Ten przykład pokazuje wartości domyślne:# Cron entry to check if monit process is running. If not start it */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
Ten plik używa tej składni, w której pierwszych 5 pól definiuje czas wykonania działania przez
apigee-monit
:min hour day_of_month month day_of_week task_to_execute
Na przykład domyślny czas wykonywania to
*/2 * * * *
, co oznacza, żecron
sprawdza procesapigee-monit
co 2 minuty.Nie możesz wykonywać zadania
cron
częściej niż raz na minutę.Więcej informacji o korzystaniu z
cron
znajdziesz w dokumentacji systemu operacyjnego serwera lub na stronach man. - Zmień ustawienia
cron
, aby były zgodne z zasadami organizacji. Aby na przykład zmienić częstotliwość wykonywania na co 5 minut, ustaw taką definicję zadania:*/5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
- Zapisz plik
apigee-monit.cron
. - Powtórz tę procedurę dla każdego węzła w klastrze.
Jeśli cron
nie zacznie oglądać filmu apigee-monit
, sprawdź, czy:
- Po definicji zadania
cron
znajduje się pusty wiersz. - W pliku zdefiniowano tylko jedno zadanie
cron
. (Wiersze z komentarzem nie są uwzględniane).
Jeśli chcesz zatrzymać lub tymczasowo wyłączyć zadanie apigee-monit
, musisz też wyłączyć to zadanie cron
. W przeciwnym razie cron
ponownie uruchomi zadanie apigee-monit
.
Aby wyłączyć usługę cron
, wykonaj jedną z tych czynności:
- Usuń plik
/etc/cron.d/apigee-monit.cron
:sudo rm /etc/cron.d/apigee-monit.cron
Jeśli później zechcesz ponownie włączyć w usłudze
cron
możliwość oglądania filmuapigee-monit
, konieczne będzie jego ponowne skopiowanie.LUB
- Edytuj plik
/etc/cron.d/apigee-monit.cron
i zmień w komentarzu definicję zadania, dodając znak „#” na początku wiersza, na przykład:# 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit