Apigee Edge for Private Cloud enthält apigee-monit
, ein Tool, das auf dem Open-Source-Monit-Dienstprogramm basiert. apigee-monit
fragt regelmäßig Edge-Dienste ab. Wenn ein Dienst nicht verfügbar ist, versucht apigee-monit
, ihn neu zu starten.
Wenn Sie apigee-monit
verwenden möchten, müssen Sie es manuell installieren. Sie ist nicht Teil der Standardinstallation.
Standardmäßig prüft apigee-monit
den Status der Edge-Dienste alle 60 Sekunden.
Schnelleinstieg
In diesem Abschnitt erfahren Sie, wie Sie apigee-monit
schnell einrichten und verwenden.
Wenn Sie Amazon Linux verwenden, installieren Sie zuerst Fedora. Andernfalls überspringen Sie diesen Schritt.
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
So installieren Sie apigee-monit
:
Installierenapigee-monit |
|
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install Dadurch wird |
|
Monitoring von Komponenten beenden | |
/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 |
|
Monitoring der Komponenten starten | |
/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 |
|
Zusammenfassende Statusinformationen abrufen | |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report /opt/apigee/apigee-service/bin/apigee-service apigee-monit summary |
|
Sehen Sie sich die apigee-monit -Protokolldateien an. |
|
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log |
Diese und weitere Themen werden in den folgenden Abschnitten ausführlich beschrieben.
Über Apigee-Monit
apigee-monit
sorgt dafür, dass alle Komponenten auf einem Knoten betriebsbereit bleiben. Dies geschieht durch die Bereitstellung einer Vielzahl von Diensten, darunter:
- Fehlgeschlagene Dienste neu starten
- Zusammenfassungsinformationen anzeigen
- Logging-Monitoringstatus
- Senden von Benachrichtigungen
- Nicht-Edge-Dienste überwachen
Apigee empfiehlt, dass Sie apigee-monit
überwachen, um sicherzustellen, dass es ausgeführt wird. Weitere Informationen finden Sie unter apigee-monit überwachen.
Apigee-Monit-Architektur
Während der Installation und Konfiguration von Apigee Edge for Private Cloud können Sie optional eine separate Instanz von apigee-monit
auf jedem Knoten in Ihrem Cluster installieren. Diese separaten apigee-monit
-Instanzen arbeiten unabhängig voneinander: Sie geben weder den Status ihrer Komponenten an die anderen Knoten noch Fehler des Monitoring-Dienstprogramms an einen zentralen Dienst weiter.
Die folgende Abbildung zeigt die apigee-monit
-Architektur in einem Cluster mit 5 Knoten:
Unterstützte Plattformen
apigee-monit
unterstützt die folgenden Plattformen für Ihren Private Cloud-Cluster. (Das unterstützte Betriebssystem für apigee-monit
hängt von der Version der Private Cloud ab.)
Betriebssystem | Private Cloud-Version | ||
---|---|---|---|
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 |
* Auch wenn es technisch nicht unterstützt wird, können Sie apigee-monit unter CentOS/RHEL/Oracle Version 6.9 für Apigee Edge for Private Cloud Version 4.19.01 installieren und verwenden. |
Komponentenkonfigurationen
apigee-monit
verwendet Komponentenkonfigurationen, um zu bestimmen, welche Komponenten überwacht werden sollen, welche Aspekte der Komponente geprüft werden sollen und welche Aktion im Falle eines Fehlers ausgeführt werden soll.
Standardmäßig überwacht apigee-monit
alle Edge-Komponenten auf einem Knoten mithilfe ihrer vordefinierten Komponentenkonfigurationen. In den Konfigurationsdateien der apigee-monit
-Komponente können Sie die Standardeinstellungen aufrufen. Die Konfigurationen der Standardkomponenten können nicht geändert werden.
apigee-monit
prüft verschiedene Aspekte einer Komponente, je nachdem, welche Komponente gerade geprüft wird. In der folgenden Tabelle ist aufgeführt, was apigee-monit
auf die einzelnen Komponenten prüft und wo sich die Komponentenkonfiguration für jede Komponente befindet. Beachten Sie, dass einige Komponenten in einer einzelnen Konfigurationsdatei definiert sind, während andere eigene Konfigurationen haben.
Komponente | Konfigurationsspeicherort | Was wird überwacht? |
---|---|---|
Verwaltungsserver | /opt/apigee/edge-management-server/monit/default.conf |
apigee-monit Prüfungen:
Außerdem gilt für diese Komponenten
|
Nachrichtenprozessor | /opt/apigee/edge-message-processor/monit/default.conf |
|
Postgres-Server | /opt/apigee/edge-postgres-server/monit/default.conf |
|
Qpid-Server | /opt/apigee/edge-qpid-server/monit/default.conf |
|
Router | /opt/apigee/edge-router/monit/default.conf |
|
Cassandra Edge-UI OpenLDAP Postgres Qpid Zookeeper |
/opt/apigee/data/apigee-monit/monit.conf |
apigee-monit Prüfungen:
|
Das folgende Beispiel zeigt die Standardkomponentenkonfiguration für die Komponente 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
Das folgende Beispiel zeigt die Standardkonfiguration für die Komponente der klassischen UI (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"
Dies gilt für die klassische Benutzeroberfläche, nicht für die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui
ist.
Sie können die Standardkomponentenkonfigurationen für Apigee Edge für Private Cloud-Komponenten nicht ändern. Sie können jedoch Ihre eigenen Komponentenkonfigurationen für externe Dienste hinzufügen, z. B. Ihren Zielendpunkt oder den Dienst httpd
. Weitere Informationen finden Sie unter Konfigurationen von Nicht-Apigee-Komponenten.
Standardmäßig überwacht apigee-monit
alle Komponenten auf einem Knoten, auf dem es ausgeführt wird. Sie können sie für alle Komponenten oder für einzelne Komponenten aktivieren oder deaktivieren. Weitere Informationen finden Sie unter:
Apigee-Monit installieren
apigee-monit
ist nicht standardmäßig installiert. Sie können es manuell installieren, nachdem Sie ein Upgrade oder eine Installation von Version 4.19.01 oder höher von Apigee Edge for Private Cloud durchgeführt haben.
In diesem Abschnitt wird beschrieben, wie Sie apigee-monit
auf den unterstützten Plattformen installieren.
Informationen zum uninstalling von apigee-monit
finden Sie unter apigee-monit
deinstallieren.
Apigee-Monit auf einer unterstützten Plattform installieren
In diesem Abschnitt wird beschrieben, wie Sie apigee-monit
auf einer unterstützten Plattform installieren.
So installierst du apigee-monit
auf einer unterstützten Plattform:
- Installieren Sie
apigee-monit
mit dem folgenden Befehl:/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
- Konfigurieren Sie
apigee-monit
mit dem folgenden Befehl:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- Starten Sie
apigee-monit
mit dem folgenden Befehl:/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
- Wiederholen Sie diesen Vorgang auf jedem Knoten im Cluster.
Monitoring-Komponenten beenden und starten
Wenn ein Dienst aus irgendeinem Grund beendet wird, versucht apigee-monit
, ihn neu zu starten.
Dies kann zu Problemen führen, wenn Sie eine Komponente absichtlich stoppen möchten. Sie können beispielsweise eine Komponente beenden, wenn Sie sie sichern oder upgraden müssen.
Wenn apigee-monit
den Dienst während der Sicherung oder des Upgrades neu startet, wird der Wartungsvorgang möglicherweise unterbrochen und schlägt unter Umständen fehl.
Die folgenden Abschnitte zeigen die Optionen zum Beenden der Überwachung von Komponenten.
Komponente beenden und Überwachung aufheben
Führen Sie den folgenden Befehl aus, um eine Komponente zu beenden und ihre Überwachung aufzuheben:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_namecomponent_name kann einer der folgenden Werte sein:
apigee-cassandra
(Cassandra)apigee-openldap
(OpenLDAP)apigee-postgresql
(PostgreSQL-Datenbank)apigee-qpidd
(Qpidd)apigee-sso
(Edge-SSO)apigee-zookeeper
(ZooKeeper)edge-management-server
(Verwaltungsserver)edge-management-ui
(neue Edge-Benutzeroberfläche)edge-message-processor
(Nachrichtenprozessor)edge-postgres-server
(Postgres-Server)edge-qpid-server
(Qpid-Server)edge-router
(Edge-Router)edge-ui
(klassische Benutzeroberfläche)
„all“ ist keine gültige Option für stop-component
. Mit stop-component
können Sie immer nur eine Komponente gleichzeitig beenden und die Überwachung aufheben.
Führen Sie den folgenden Befehl aus, um die Komponente neu zu starten und das Monitoring fortzusetzen:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name
„all“ ist keine gültige Option für start-component
.
Eine Anleitung zum Beenden und Aufheben der Überwachung aller Komponenten finden Sie unter Alle Komponenten stoppen und die Überwachung aufheben.
Überwachung einer Komponente aufheben (aber nicht stoppen)
Führen Sie den folgenden Befehl aus, um die Überwachung einer Komponente aufzuheben (aber nicht zu beenden):
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_namecomponent_name kann einer der folgenden Werte sein:
apigee-cassandra
(Cassandra)apigee-openldap
(OpenLDAP)apigee-postgresql
(PostgreSQL-Datenbank)apigee-qpidd
(Qpidd)apigee-sso
(Edge-SSO)apigee-zookeeper
(ZooKeeper)edge-management-server
(Verwaltungsserver)edge-management-ui
(neue Edge-Benutzeroberfläche)edge-message-processor
(Nachrichtenprozessor)edge-postgres-server
(Postgres-Server)edge-qpid-server
(Qpid-Server)edge-router
(Edge-Router)edge-ui
(klassische Benutzeroberfläche)
Führen Sie den folgenden Befehl aus, um die Überwachung der Komponente wieder aufzunehmen:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
Überwachung aller Komponenten aufheben (aber nicht stoppen)
Führen Sie den folgenden Befehl aus, um die Überwachung aller Komponenten aufzuheben (sie aber nicht zu beenden):
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
Führen Sie den folgenden Befehl aus, um das Monitoring aller Komponenten fortzusetzen:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
Alle Komponenten anhalten und deren Überwachung aufheben
Führen Sie die folgenden Befehle aus, um alle Komponenten zu beenden und deren Überwachung aufzuheben:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop
Führen Sie die folgenden Befehle aus, um alle Komponenten neu zu starten und das Monitoring fortzusetzen:
/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
Sie können auch apigee-monit
deaktivieren, wie unter Apigee-Monit beenden, starten und deaktivieren beschrieben, um das Monitoring aller Komponenten zu beenden.
Apigee-Monit beenden, starten und deaktivieren
Wie bei jedem Dienst können Sie apigee-monit
mit dem Befehl apigee-service
beenden und starten. Darüber hinaus unterstützt apigee-monit
den Befehl unmonitor
, mit dem Sie Monitoringkomponenten vorübergehend stoppen können.
Apigee-Monit beenden
Verwenden Sie den folgenden Befehl, um apigee-monit
zu beenden:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
Apigee-Monit starten
Verwenden Sie den folgenden Befehl, um apigee-monit
zu starten:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
Apigee-Monit deaktivieren
Mit dem folgenden Befehl können Sie das Monitoring aller Komponenten auf dem Knoten aussetzen:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
Alternativ können Sie apigee-monit
dauerhaft deaktivieren. Deinstallieren Sie es dazu wie unter apigee-monit
deinstallieren beschrieben.
Apigee-Monit deinstallieren
So deinstallieren Sie apigee-monit
:
- Wenn Sie einen
cron
-Job zum Überwachen vonapigee-monit
einrichten, entfernen Sie dencron
-Job, bevor Sieapigee-monit
deinstallieren:sudo rm /etc/cron.d/apigee-monit.cron
- Beenden Sie
apigee-monit
mit dem folgenden Befehl:/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
- Deinstallieren Sie
apigee-monit
mit folgendem Befehl:/opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
- Wiederholen Sie diesen Vorgang auf jedem Knoten im Cluster.
Neu installierte Komponente überwachen
Wenn Sie eine neue Komponente auf einem Knoten installieren, auf dem apigee-monit
ausgeführt wird, können Sie mit dem Monitoring der Komponente beginnen, indem Sie den Befehl restart
von apigee-monit
ausführen. Dadurch wird eine neue Datei monit.conf erstellt, in der die neue Komponente in ihre Komponentenkonfigurationen aufgenommen wird.
Im folgenden Beispiel wird apigee-monit
neu gestartet:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart
Apigee-Monit anpassen
Sie können verschiedene apigee-monit
-Einstellungen anpassen, darunter:
- Standardeinstellungen für
apigee-monit
-Steuerelemente - Globale Konfigurationseinstellungen
- Konfigurationen von Nicht-Apigee-Komponenten
Standardeinstellungen für Apigee-Monit-Steuerung
Sie können die standardmäßigen apigee-monit
-Steuereinstellungen anpassen, z. B. die Häufigkeit von Statusprüfungen und den Speicherort der apigee-monit
-Dateien. Dazu bearbeiten Sie eine Attributdatei mithilfe des Verfahrens Code mit Konfiguration. Attributdateien bleiben auch nach dem Upgrade von Apigee Edge für Private Cloud erhalten.
In der folgenden Tabelle werden die standardmäßigen Einstellungen der apigee-monit
-Steuerelemente beschrieben, die Sie anpassen können:
Property | Beschreibung |
---|---|
conf_monit_httpd_port |
Port des Daemons httpd . apigee-monit verwendet httpd für seine Dashboard-Anwendung und zum Aktivieren von Berichten/Zusammenfassungen. Der Standardwert ist 2.812.
|
conf_monit_httpd_allow |
Einschränkungen für Anfragen an den httpd -Daemon. apigee-monit verwendet httpd , um die zugehörige Dashboardanwendung auszuführen und Berichte/Zusammenfassungen zu aktivieren. Dieser Wert muss auf den lokalen Host verweisen (den Host, auf dem httpd ausgeführt wird.
Wenn Anfragen einen Nutzernamen und ein Passwort enthalten müssen, verwenden Sie die folgende Syntax: conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1 Fügen Sie beim Hinzufügen eines Nutzernamens und Passworts zwischen jeder Einschränkung ein „\n“ ein. Fügen Sie keine tatsächlichen Zeilenumbrüche oder Wagenrückläufe in den Wert ein. |
conf_monit_monit_datadir |
Das Verzeichnis, in dem die Termindetails gespeichert sind. |
conf_monit_monit_delay_time |
Die Zeit, die apigee-monit nach dem ersten Laden in den Arbeitsspeicher wartet, bevor es ausgeführt wird. Dies betrifft nur die erste Prozessprüfung apigee-monit . |
conf_monit_monit_logdir |
Der Speicherort der apigee-monit -Logdatei. |
conf_monit_monit_retry_time |
Die Häufigkeit, mit der apigee-monit versucht, jeden Prozess zu prüfen. Der Standardwert beträgt 60 Sekunden. |
conf_monit_monit_rundir |
Der Speicherort der PID- und Statusdateien, die apigee-monit zur Überprüfung von Prozessen verwendet. |
So passt du die Standardeinstellungen der apigee-monit
-Steuerelemente an:
- Bearbeiten Sie die folgende Datei:
/opt/apigee/customer/application/monit.properties
Wenn die Datei nicht vorhanden ist, erstellen Sie sie und legen Sie den Eigentümer auf den Benutzer „apigee“ fest:
chown apigee:apigee /opt/apigee/customer/application/monit.properties
Wenn die Datei bereits vorhanden ist, enthält sie möglicherweise zusätzliche Konfigurationsattribute, die über die oben in der Tabelle aufgeführten Attribute hinausgehen. Ändern Sie nur die oben aufgeführten Attribute.
Legen Sie Property-Werte fest oder ersetzen Sie sie durch Ihre neuen Werte.
Wenn Sie beispielsweise den Speicherort der Logdatei in
/tmp
ändern möchten, fügen Sie das folgende Attribut hinzu oder bearbeiten Sie es:conf_monit_monit_logdir=/tmp/apigee-monit.log
- Speichern Sie die Änderungen in der Datei
monit.properties
. - Konfigurieren Sie
apigee-monit
mit dem folgenden Befehl neu:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- Laden Sie
apigee-monit
mit dem folgenden Befehl neu:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
Wenn Sie
apigee-monit
nicht neu starten können, prüfen Sie die Logdatei auf Fehler, wie unter Aufapigee-monit
-Logdateien zugreifen beschrieben. - Wiederholen Sie diesen Vorgang für jeden Knoten im Cluster.
Globale Konfigurationseinstellungen
Sie können globale Konfigurationseinstellungen für apigee-monit
definieren und beispielsweise E-Mail-Benachrichtigungen für Benachrichtigungen hinzufügen. Dazu erstellen Sie eine Konfigurationsdatei im Verzeichnis /opt/apigee/data/apigee-monit
und starten apigee-monit
dann neu.
So definieren Sie globale Konfigurationseinstellungen für apigee-monit
:
- Erstellen Sie eine neue Komponentenkonfigurationsdatei am folgenden Speicherort:
/opt/apigee/data/apigee-monit/filename.conf
Dabei kann filename ein beliebiger gültiger Dateiname sein, außer "monit".
- Ändern Sie den Inhaber der neuen Konfigurationsdatei in den Nutzer „apigee“, wie im folgenden Beispiel gezeigt:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
- Fügen Sie die globalen Konfigurationseinstellungen in die neue Datei ein. Im folgenden Beispiel wird ein E-Mail-Server konfiguriert und die Empfänger der Benachrichtigung festgelegt:
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
Eine vollständige Liste der globalen Konfigurationsoptionen finden Sie in der Monit-Dokumentation.
- Speichern Sie die Änderungen an der Komponentenkonfigurationsdatei.
- Laden Sie
apigee-monit
mit dem folgenden Befehl neu:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
Wenn
apigee-monit
nicht neu gestartet wird, prüfen Sie die Logdatei auf Fehler, wie unter Aufapigee-monit
-Logdateien zugreifen beschrieben. - Wiederholen Sie diesen Vorgang für jeden Knoten im Cluster.
Konfigurationen von Nicht-Apigee-Komponenten
Sie können apigee-monit
eigene Konfigurationen hinzufügen, damit Dienste geprüft werden, die nicht Teil von Apigee Edge for Private Cloud sind. Mit apigee-monit
können Sie beispielsweise prüfen, ob Ihre APIs ausgeführt werden. Dazu senden Sie Anfragen an Ihren Zielendpunkt.
So fügen Sie eine Nicht-Apigee-Komponentenkonfiguration hinzu:
- Erstellen Sie eine neue Komponentenkonfigurationsdatei am folgenden Speicherort:
/opt/apigee/data/apigee-monit/filename.conf
Dabei kann filename ein beliebiger gültiger Dateiname sein, außer "monit".
Sie können so viele Komponentenkonfigurationsdateien wie nötig erstellen. Sie können beispielsweise eine separate Konfigurationsdatei für jede Nicht-Apigee-Komponente erstellen, die Sie auf dem Knoten überwachen möchten.
- Ändern Sie den Inhaber der neuen Konfigurationsdatei in den Nutzer „apigee“, wie im folgenden Beispiel gezeigt:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
- Fügen Sie der neuen Datei Ihre benutzerdefinierten Konfigurationen hinzu. Im folgenden Beispiel wird der Zielendpunkt auf dem lokalen Server geprüft:
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
Eine vollständige Liste der möglichen Konfigurationseinstellungen finden Sie in der Monit-Dokumentation.
- Speichern Sie die Änderungen in der Konfigurationsdatei.
- Laden Sie
apigee-monit
mit dem folgenden Befehl neu:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
Wenn
apigee-monit
nicht neu gestartet wird, prüfen Sie die Logdatei auf Fehler, wie unter Aufapigee-monit
-Logdateien zugreifen beschrieben. - Wiederholen Sie diesen Vorgang für jeden Knoten im Cluster.
Beachten Sie, dass dies nur für Nicht-Edge-Komponenten gilt. Sie können die Komponentenkonfigurationen für Edge-Komponenten nicht anpassen.
Auf Apigee-Monit-Protokolldateien zugreifen
apigee-monit
protokolliert alle Aktivitäten, einschließlich Ereignissen, Neustarts, Konfigurationsänderungen und Benachrichtigungen, in einer Logdatei.
Der Standardspeicherort der Logdatei ist:
/opt/apigee/var/log/apigee-monit/apigee-monit.log
Sie können den Standardspeicherort ändern, indem Sie die Einstellungen der apigee-monit
-Steuerelemente anpassen.
Logeinträge haben das folgende 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'
Sie können das Format der apigee-monit
-Logdateieinträge nicht anpassen.
Aggregierten Status mit Apigee-Monit anzeigen
apigee-monit
enthält die folgenden Befehle, die aggregierte Statusinformationen zu den Komponenten auf einem Knoten liefern:
Befehl | Nutzung |
---|---|
report |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report |
summary |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary |
Jeder dieser Befehle wird in den folgenden Abschnitten ausführlicher erläutert.
Bericht
Mit dem Befehl report
erhalten Sie eine Zusammenfassung der Anzahl der Komponenten, die hoch- oder heruntergelaufen sind, gerade initialisiert werden oder auf einem Knoten nicht überwacht werden. Im folgenden Beispiel wird der Befehl report
aufgerufen:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
Das folgende Beispiel zeigt die report
-Ausgabe bei einer AIO-Konfiguration (All-in-one):
/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
In diesem Beispiel wird von apigee-monit
gemeldet, dass 11 der 12 Dienste aktiv sind. Ein Dienst wird derzeit nicht überwacht.
Wenn Sie den Befehl report
zum ersten Mal ausführen, wird möglicherweise der Fehler Connection refused
angezeigt. Warten Sie in diesem Fall, bis das Attribut conf_monit_monit_delay_time
aktiv ist, und versuchen Sie es dann noch einmal.
Zusammenfassung
Mit dem Befehl summary
werden alle Komponenten aufgelistet und ihr Status angegeben. Im folgenden Beispiel wird der Befehl summary
aufgerufen:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Das folgende Beispiel zeigt die summary
-Ausgabe bei einer AIO-Konfiguration (All-in-one):
/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
Wenn bei der ersten Ausführung des Befehls summary
der Fehler Connection refused
angezeigt wird, warten Sie die Dauer des Attributs conf_monit_monit_delay_time
ab und versuchen Sie es dann noch einmal.
Apigee-Monit überwachen
Es empfiehlt sich, regelmäßig zu prüfen, ob apigee-monit
auf jedem Knoten ausgeführt wird.
Prüfen Sie mit dem folgenden Befehl, ob apigee-monit
ausgeführt wird:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
Apigee empfiehlt, dass Sie diesen Befehl regelmäßig auf jedem Knoten ausführen, auf dem apigee-monit
ausgeführt wird.
Eine Möglichkeit dafür ist ein Dienstprogramm wie cron
, das geplante Aufgaben in vordefinierten Intervallen ausführt.
So verwenden Sie cron
zum Überwachen von apigee-monit
:
- Fügen Sie die Unterstützung für
cron
hinzu. Kopieren Sie dazu das Verzeichnisapigee-monit.cron
in das Verzeichnis/etc/cron.d
, wie im folgenden Beispiel gezeigt:cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
- Öffnen Sie die Datei
apigee-monit.cron
, um sie zu bearbeiten.Die Datei
apigee-monit.cron
definiert den auszuführendencron
-Job sowie die Häufigkeit, mit der er ausgeführt werden soll. Das folgende Beispiel zeigt die Standardwerte:# 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
Diese Datei verwendet die folgende Syntax, wobei die ersten fünf Felder den Zeitpunkt definieren, zu dem
apigee-monit
seine Aktion ausführt:min hour day_of_month month day_of_week task_to_execute
Die Standardausführungszeit ist beispielsweise
*/2 * * * *
. Damit wirdcron
angewiesen, denapigee-monit
-Prozess alle 2 Minuten zu prüfen.Sie können einen
cron
-Job nicht öfter als einmal pro Minute ausführen.Weitere Informationen zur Verwendung von
cron
finden Sie in der Dokumentation oder den Manpages des Serverbetriebssystems. - Ändern Sie die Einstellungen für
cron
so, dass sie den Richtlinien Ihrer Organisation entsprechen. Wenn Sie beispielsweise die Ausführungshäufigkeit auf alle 5 Minuten ändern möchten, legen Sie die Jobdefinition so fest:*/5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
- Speichern Sie die Datei
apigee-monit.cron
. - Wiederholen Sie diesen Vorgang für jeden Knoten im Cluster.
Wenn cron
die Wiedergabe von apigee-monit
nicht startet, überprüfe Folgendes:
- Nach der Jobdefinition
cron
befindet sich eine leere Zeile. - In der Datei ist nur ein
cron
-Job definiert. (Kommentarzeilen werden nicht mitgezählt.)
Wenn Sie apigee-monit
anhalten oder vorübergehend deaktivieren möchten, müssen Sie auch diesen cron
-Job deaktivieren. Andernfalls startet cron
apigee-monit
neu.
Sie haben folgende Möglichkeiten, cron
zu deaktivieren:
- Löschen Sie die Datei
/etc/cron.d/apigee-monit.cron
:sudo rm /etc/cron.d/apigee-monit.cron
Wenn du
cron
später wieder aktivieren möchtest, umapigee-monit
anzusehen, musst du es noch einmal kopieren.ODER
- Bearbeiten Sie die Datei
/etc/cron.d/apigee-monit.cron
und kommentieren Sie die Jobdefinition aus. Fügen Sie dazu am Anfang der Zeile ein „#“ ein. Beispiel:# 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit