Selbstheilung mit Apigee-Monit

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
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Dadurch wird apigee-monit installiert und das Monitoring aller Komponenten auf dem Knoten wird standardmäßig gestartet.

  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:

Abbildung 1: Eine separate Instanz von apigee-monit wird auf jedem Knoten in einem Cluster isoliert ausgeführt.

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:
  • Die angegebenen Ports sind offen und Anfragen werden angenommen
  • Die angegebenen Protokolle werden unterstützt
  • Status der Antwort

Außerdem gilt für diese Komponenten apigee-monit:

  • Erfordert mehrere Fehler innerhalb einer bestimmten Anzahl von Zyklen, bevor Maßnahmen ergriffen werden
  • Legt einen benutzerdefinierten Anfragepfad fest
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:
  • Dienst wird ausgeführt

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:

  1. Installieren Sie apigee-monit mit dem folgenden Befehl:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. Konfigurieren Sie apigee-monit mit dem folgenden Befehl:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. Starten Sie apigee-monit mit dem folgenden Befehl:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. 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_name
component_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_name
component_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:

  1. Wenn Sie einen cron-Job zum Überwachen von apigee-monit einrichten, entfernen Sie den cron-Job, bevor Sie apigee-monit deinstallieren:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. Beenden Sie apigee-monit mit dem folgenden Befehl:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. Deinstallieren Sie apigee-monit mit folgendem Befehl:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. 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:

  1. Standardeinstellungen für apigee-monit-Steuerelemente
  2. Globale Konfigurationseinstellungen
  3. 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:

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

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

  3. Speichern Sie die Änderungen in der Datei monit.properties.
  4. Konfigurieren Sie apigee-monit mit dem folgenden Befehl neu:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. 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 Auf apigee-monit-Logdateien zugreifen beschrieben.

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

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

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

  4. Speichern Sie die Änderungen an der Komponentenkonfigurationsdatei.
  5. 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 Auf apigee-monit-Logdateien zugreifen beschrieben.

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

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

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

  4. Speichern Sie die Änderungen in der Konfigurationsdatei.
  5. 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 Auf apigee-monit-Logdateien zugreifen beschrieben.

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

  1. Fügen Sie die Unterstützung für cron hinzu. Kopieren Sie dazu das Verzeichnis apigee-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/
  2. Öffnen Sie die Datei apigee-monit.cron, um sie zu bearbeiten.

    Die Datei apigee-monit.cron definiert den auszuführenden cron-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 wird cron angewiesen, den apigee-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.

  3. Ä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
  4. Speichern Sie die Datei apigee-monit.cron.
  5. 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, um apigee-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