Selbstheilung mit Apigee-Monit

Apigee Edge for Private Cloud umfasst 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 alle 60 Sekunden den Status von Edge-Diensten.

Schnelleinstieg

In diesem Abschnitt erfahren Sie, wie Sie schnell mit apigee-monit loslegen können.

Wenn Sie Amazon Linux oder Oracle-Linux-7.X verwenden, müssen Sie zuerst monit über Fedora installieren. 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:

/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

/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

/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

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Jedes dieser Themen und weitere werden in den folgenden Abschnitten ausführlich beschrieben.

Informationen zu apigee-monit

apigee-monit sorgt dafür, dass alle Komponenten auf einem Knoten ausgeführt werden. Dazu bietet sie eine Vielzahl von Diensten an, darunter:

• Fehlgeschlagene Dienste neu starten
• Zusammenfassende Informationen anzeigen
• Status des Logging-Monitorings
• Benachrichtigungen senden
• Nicht-Edge-Dienste überwachen

Apigee empfiehlt, apigee-monit zu ü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 kommunizieren den Status ihrer Komponenten nicht an die anderen Knoten und melden auch keine Fehler des Überwachungstools an einen zentralen Dienst.

Das folgende Bild zeigt die apigee-monit-Architektur in einem Cluster mit fünf Knoten:

Komponentenkonfigurationen

apigee-monit verwendet Komponentenkonfigurationen, um zu bestimmen, welche Komponenten überwacht werden sollen, welche Aspekte der Komponente geprüft werden sollen und welche Maßnahmen im Fehlerfall ergriffen werden sollen.

Standardmäßig überwacht apigee-monit alle Edge-Komponenten auf einem Knoten anhand ihrer vordefinierten Komponentenkonfigurationen. Die Standardeinstellungen finden Sie in den Konfigurationsdateien der apigee-monit-Komponente. Sie können die Standardkonfigurationen von Komponenten nicht ändern.

apigee-monit prüft verschiedene Aspekte einer Komponente, je nachdem, welche Komponente geprüft wird. In der folgenden Tabelle sehen Sie, was apigee-monit für jede Komponente prüft, und wo die Konfiguration der einzelnen Komponenten zu finden ist. Einige Komponenten werden in einer einzelnen Konfigurationsdatei definiert, andere haben eigene Konfigurationen.

Das folgende Beispiel zeigt die Standardkonfiguration der 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 „Classic 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"

Das 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 Standardkonfigurationen für keine Apigee Edge for Private Cloud-Komponente ändern. Sie können jedoch eigene Komponentenkonfigurationen für externe Dienste hinzufügen, z. B. für Ihren Zielendpunkt oder den httpd-Dienst. 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 die Funktion für alle oder für einzelne Komponenten aktivieren oder deaktivieren. Weitere Informationen finden Sie unter:

• Überwachung einer Komponente beenden und starten
• apigee-monit beenden, starten und deaktivieren

apigee-monit installieren

apigee-monit wird nicht standardmäßig installiert. Sie können es manuell installieren, nachdem Sie ein Upgrade auf Version 4.19.01 oder höher von Apigee Edge for Private Cloud durchgeführt oder diese Version installiert haben.

In diesem Abschnitt wird beschrieben, wie Sie apigee-monit installieren.

Informationen zum Deinstallieren von apigee-monit finden Sie unter apigee-monit deinstallieren.

apigee-monit installieren

In diesem Abschnitt wird beschrieben, wie Sie apigee-monit installieren.

So installieren Sie apigee-monit:

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 in Ihrem Cluster.

Monitoring-Komponenten beenden und starten

Wenn ein Dienst aus irgendeinem Grund beendet wird, versucht apigee-monit, ihn neu zu starten.

Das kann zu Problemen führen, wenn Sie eine Komponente absichtlich beenden möchten. Sie möchten beispielsweise eine Komponente beenden, wenn Sie sie sichern oder aktualisieren müssen. Wenn apigee-monit den Dienst während der Sicherung oder des Upgrades neu startet, kann Ihr Wartungsverfahren unterbrochen werden, was möglicherweise zu einem Fehler führt.

In den folgenden Abschnitten werden die Optionen zum Beenden der Überwachung von Komponenten beschrieben.

Komponente stoppen und nicht mehr überwachen

Führen Sie den folgenden Befehl aus, um eine Komponente zu beenden und die Überwachung aufzuheben:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name

• 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 jeweils nur eine Komponente beenden und die Überwachung aufheben.

Führen Sie den folgenden Befehl aus, um die Komponente neu zu starten und die Überwachung 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 dazu, wie Sie alle Komponenten beenden und die Überwachung aufheben, finden Sie unter Alle Komponenten beenden und die Überwachung aufheben.

Komponente nicht mehr überwachen (aber nicht beenden)

Führen Sie den folgenden Befehl aus, um die Überwachung einer Komponente zu beenden, ohne sie zu stoppen:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name

• 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 fortzusetzen:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

Überwachung aller Komponenten aufheben (aber nicht beenden)

Führen Sie den folgenden Befehl aus, um die Überwachung aller Komponenten aufzuheben, ohne sie zu stoppen:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Führen Sie den folgenden Befehl aus, um die Überwachung aller Komponenten fortzusetzen:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Alle Komponenten beenden und die Überwachung aufheben

Führen Sie die folgenden Befehle aus, um alle Komponenten zu beenden und die Ü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

Wenn Sie das Monitoring aller Komponenten beenden möchten, können Sie auch apigee-monit deaktivieren, wie unter apigee-monit beenden, starten und deaktivieren beschrieben.

apigee-monit beenden, starten und deaktivieren

Wie bei jedem Dienst können Sie apigee-monit mit dem Befehl apigee-service beenden und starten. Außerdem unterstützt apigee-monit den Befehl unmonitor, mit dem Sie die Überwachung von Komponenten vorübergehend beenden 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 die Überwachung aller Komponenten auf dem Knoten anhalten:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Alternativ können Sie apigee-monit auch dauerhaft deaktivieren, indem Sie es vom Knoten deinstallieren, 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 eingerichtet haben, entfernen Sie den cron-Job, bevor Sie apigee-monit deinstallieren:

   sudo rm /etc/cron.d/apigee-monit.cron

2. Stoppen Sie apigee-monit mit dem folgenden Befehl:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

3. Deinstallieren Sie apigee-monit mit dem folgenden Befehl:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall

4. Wiederholen Sie diesen Vorgang auf jedem Knoten in Ihrem Cluster.

Neu installierte Komponente überwachen

Wenn Sie eine neue Komponente auf einem Knoten installieren, auf dem apigee-monit ausgeführt wird, können Sie sie überwachen, indem Sie den Befehl restart von apigee-monit ausführen. Dadurch wird eine neue monit.conf-Datei generiert, die die neue Komponente in ihren Komponentenkonfigurationen enthält.

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 die apigee-monit-Steuerung
2. Globale Konfigurationseinstellungen
3. Konfigurationen von Nicht-Apigee-Komponenten

Standardeinstellungen für die apigee-monit-Steuerung

Sie können die Standardeinstellungen für das apigee-monit-Steuerelement anpassen, z. B. die Häufigkeit von Statusprüfungen und die Speicherorte der apigee-monit-Dateien. Dazu bearbeiten Sie eine Eigenschaftendatei mit der Technik Code mit Konfiguration. Eigenschaftendateien bleiben auch nach dem Upgrade von Apigee Edge for Private Cloud erhalten.

In der folgenden Tabelle werden die Standardeinstellungen für die apigee-monit-Steuerung beschrieben, die Sie anpassen können:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

So passen Sie die Standardeinstellungen für die apigee-monit-Steuerung 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 Nutzer „apigee“ fest:

   chown apigee:apigee /opt/apigee/customer/application/monit.properties

   Wenn die Datei bereits vorhanden ist, sind darin möglicherweise zusätzliche Konfigurationseigenschaften definiert, die nicht in der obigen Tabelle aufgeführt sind. Sie sollten keine anderen Eigenschaften als die oben aufgeführten ändern.

2. Legen Sie Attributwerte mit Ihren neuen Werten fest oder ersetzen Sie sie.

   Wenn Sie beispielsweise den Speicherort der Logdatei in /tmp ändern möchten, fügen Sie die folgende Eigenschaft hinzu oder bearbeiten Sie sie:

   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 in Ihrem Cluster.

Globale Konfigurationseinstellungen

Sie können globale Konfigurationseinstellungen für apigee-monit definieren, z. B. E-Mail-Benachrichtigungen für Benachrichtigungen hinzufügen. Dazu erstellen Sie eine Konfigurationsdatei im Verzeichnis /opt/apigee/data/apigee-monit und starten apigee-monit neu.

Globale Konfigurationseinstellungen für apigee-monit definieren:

1. Erstellen Sie eine neue Konfigurationsdatei für Komponenten am folgenden Speicherort:

   /opt/apigee/data/apigee-monit/filename.conf

   Dabei kann filename ein beliebiger gültiger Dateiname sein, mit Ausnahme von „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 der neuen Datei Ihre globalen Konfigurationseinstellungen hinzu. Im folgenden Beispiel wird ein Mailserver konfiguriert und die Empfänger von Benachrichtigungen 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 in der Konfigurationsdatei der Komponente.
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 in Ihrem 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, indem Sie Anfragen an Ihren Zielendpunkt senden.

So fügen Sie eine Konfiguration für eine Nicht-Apigee-Komponente hinzu:

1. Erstellen Sie eine neue Konfigurationsdatei für Komponenten am folgenden Speicherort:

   /opt/apigee/data/apigee-monit/filename.conf

   Dabei kann filename ein beliebiger gültiger Dateiname sein, mit Ausnahme von „monit“.

   Sie können beliebig viele Konfigurationsdateien für Komponenten erstellen. Sie können beispielsweise für jede Nicht-Apigee-Komponente, die Sie auf dem Knoten überwachen möchten, eine separate Konfigurationsdatei erstellen.

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 in Ihrem Cluster.

Das gilt nur für Nicht-Edge-Komponenten. Sie können die Komponentenkonfigurationen für Edge-Komponenten nicht anpassen.

Auf apigee-monit-Logdateien zugreifen

apigee-monit protokolliert alle Aktivitäten, einschließlich Ereignisse, 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 Standardstandort ändern, indem Sie die Einstellungen des Steuerelements apigee-monit anpassen.

Logdateieinträ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-Protokolldateieinträge nicht anpassen.

Aggregierten Status mit apigee-monit ansehen

apigee-monit enthält die folgenden Befehle, mit denen Sie aggregierte Statusinformationen zu den Komponenten auf einem Knoten abrufen können:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Jeder dieser Befehle wird in den folgenden Abschnitten genauer erläutert.

Bericht

Der Befehl report bietet eine zusammengefasste Übersicht darüber, wie viele Komponenten auf einem Knoten aktiv, inaktiv, gerade initialisiert oder derzeit nicht überwacht sind. 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 in 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 werden 11 der 12 Dienste von apigee-monit als aktiv gemeldet. Ein Dienst wird derzeit nicht überwacht.

Möglicherweise erhalten Sie den Fehler Connection refused, wenn Sie den Befehl report zum ersten Mal ausführen. Warten Sie in diesem Fall die Dauer der Eigenschaft conf_monit_monit_delay_time ab und versuchen Sie es dann noch einmal.

Zusammenfassung

Der Befehl summary listet jede Komponente auf und gibt ihren Status an. 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 in 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 Sie beim ersten Ausführen des Befehls summary den Fehler Connection refused erhalten, warten Sie die Dauer der Eigenschaft conf_monit_monit_delay_time und versuchen Sie es dann noch einmal.

apigee-monit beobachten

Es wird empfohlen, regelmäßig zu prüfen, ob apigee-monit auf jedem Knoten ausgeführt wird.

Verwenden Sie den folgenden Befehl, um zu prüfen, ob apigee-monit ausgeführt wird:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee empfiehlt, diesen Befehl regelmäßig auf jedem Knoten auszugeben, auf dem apigee-monit ausgeführt wird. Eine Möglichkeit hierfür ist ein Dienstprogramm wie cron, mit dem geplante Aufgaben in vordefinierten Intervallen ausgeführt werden.

So verwenden Sie cron, um apigee-monit zu überwachen:

1. Fügen Sie die cron-Unterstützung hinzu, indem Sie das Verzeichnis apigee-monit.cron in das Verzeichnis /etc/cron.d kopieren, 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.

   In der Datei apigee-monit.cron wird der auszuführende Job cron sowie die Häufigkeit der Ausführung definiert. 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, in der die ersten fünf Felder die Zeit definieren, zu der apigee-monit seine Aktion ausführt:

   min hour day_of_month month day_of_week task_to_execute

   Die Standardausführungszeit ist beispielsweise */2 * * * *. Dadurch 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 Ihres Serverbetriebssystems.

3. Ändern Sie die cron-Einstellungen entsprechend den Richtlinien Ihrer Organisation. 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 in Ihrem Cluster.

Wenn cron nicht mit der Wiedergabe von apigee-monit beginnt, prüfe Folgendes:

• Nach der Jobdefinition cron ist eine leere Zeile vorhanden.
• In der Datei ist nur ein cron-Job definiert. Auskommentierte Zeilen werden nicht gezählt.

Wenn Sie apigee-monit beenden oder vorübergehend deaktivieren möchten, müssen Sie auch diesen cron-Job deaktivieren. Andernfalls wird apigee-monit von cron neu gestartet.

So deaktivieren Sie cron:

• 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 den Code noch einmal kopieren.

  OR

• Bearbeiten Sie die Datei /etc/cron.d/apigee-monit.cron und kommentieren Sie die Jobdefinition aus, indem Sie am Anfang der Zeile ein „#“ einfügen, z. B.:

  # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit