Samozdrowienie z apigee-monit

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

Ta sekcja pokazuje, jak szybko rozpocząć korzystanie z usługi apigee-monit.

Jeśli używasz Amazon Linux lub Oracle-Linux-7.X, najpierw zainstaluj zarabianie za pomocą Fedora. W przeciwnym razie pomiń ten krok.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

Aby zainstalować aplikację apigee-monit, wykonaj te czynności:

  Zainstaluj: apigee-monit
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Spowoduje to zainstalowanie komponentu apigee-monit i rozpoczęcie domyślnie monitorowania wszystkich komponentów w węźle.

  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:

Architektura zarabiania na Apigee w klastrze z 5 węzłami
Rysunek 1. Oddzielna instancja apigee-monit działa niezależnie w każdym węźle w klastrze

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:
  • Podane porty są otwarte i akceptują żądania
  • Określone protokoły są obsługiwane
  • Stan odpowiedzi

Dodatkowo w przypadku tych komponentów apigee-monit:

  • Wymaga wielu błędów w ciągu określonej liczby cykli przed podjęciem działania
  • Ustawia niestandardową ścieżkę żądania
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:
  • Usługa jest uruchomiona

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

Poniższy przykład pokazuje domyślną konfigurację komponentu klasycznego interfejsu użytkownika (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"

Dotyczy to klasycznego interfejsu użytkownika, a nie nowego interfejsu Edge z nazwą komponentu edge-management-ui.

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:

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.

Ta sekcja zawiera informacje na temat instalowania apigee-monit.

Informacje na temat uninstalling apigee-monit znajdziesz w artykule Odinstalowywanie aplikacji apigee-monit.

Zainstaluj apigee-monit

Ta sekcja zawiera informacje na temat instalowania apigee-monit.

Aby zainstalować aplikację apigee-monit:

  1. Zainstaluj apigee-monit za pomocą tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. Skonfiguruj apigee-monit za pomocą tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. Uruchom apigee-monit za pomocą tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. Powtórz tę procedurę w każdym węźle w klastrze.

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_name
component_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_name
component_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:

  1. Jeśli skonfigurowano zadanie cron do monitorowania apigee-monit, usuń to zadanie cron przed odinstalowaniem apigee-monit:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. Zatrzymaj apigee-monit za pomocą tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. Odinstaluj apigee-monit za pomocą tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. 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:

  1. Domyślne ustawienia sterowania apigee-monit
  2. Globalne ustawienia konfiguracji
  3. 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:

  1. 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.

  2. 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

  3. Zapisz zmiany w pliku monit.properties.
  4. Skonfiguruj ponownie apigee-monit za pomocą tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. 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 dziennika apigee-monit.

  6. 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:

  1. 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”.

  2. 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
  3. 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.

  4. Zapisz zmiany w pliku konfiguracji komponentu.
  5. 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 dziennika apigee-monit.

  6. 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:

  1. 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.

  2. 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
  3. 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.

  4. Zapisz zmiany w pliku konfiguracji.
  5. 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 dziennika apigee-monit.

  6. 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:

  1. Dodaj obsługę cron, kopiując katalog apigee-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/
  2. Otwórz plik apigee-monit.cron, aby go edytować.

    Plik apigee-monit.cron określa zadanie cron 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, że cron sprawdza proces apigee-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.

  3. 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
  4. Zapisz plik apigee-monit.cron.
  5. 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 filmu apigee-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