Best Practices für das Monitoring

Monitoringbenachrichtigungen

Mit Apigee Edge können Sie Benachrichtigungen an Protokolle oder externe Überwachungssysteme/-tools weiterleiten, wenn ein Fehler oder Ausfall aufgrund eines fehlgeschlagenen Ereignisses auftritt. Diese Benachrichtigungen/Ereignisse können auf System- oder Anwendungsebene erfolgen. Benachrichtigungen auf Anwendungsebene sind in der Regel benutzerdefinierte Benachrichtigungen, die auf Grundlage generierter Ereignisse erstellt werden. Die benutzerdefinierten Bedingungen werden in der Regel vom Netzwerkadministrator konfiguriert. Weitere Informationen zu Benachrichtigungen erhalten Sie vom Apigee-Support.

Benachrichtigungsgrenzwerte festlegen

Legen Sie einen Grenzwert fest, ab dem eine Benachrichtigung generiert werden soll. Was Sie festlegen, hängt von Ihrer Hardwarekonfiguration ab. Der Grenzwert sollte in Relation zu Ihrer Kapazität festgelegt werden. Beispielsweise ist Apigee Edge möglicherweise zu niedrig, wenn Sie nur eine Kapazität von 6 GB haben. Sie können einen Grenzwert mit dem Kriterium „gleich“ (=) oder „größer als“ (>) zuweisen. Sie können auch ein Zeitintervall zwischen zwei aufeinanderfolgenden Benachrichtigungen angeben. Sie können die Option „Stunden/Minuten/Sekunden“ verwenden.

Kriterien für die Festlegung von Benachrichtigungen auf Systemebene

In der folgenden Tabelle werden die Kriterien beschrieben:

Apigee-spezifische und Drittanbieter-Ports prüfen

Überwachen Sie die folgenden Ports, um sicherzustellen, dass sie aktiv sind.

• Port 4526, 4527 und 4528 auf dem Verwaltungsserver, dem Router und dem Nachrichtenprozessor
• Port 1099, 1100 und 1101 auf dem Verwaltungsserver, Router und Nachrichtenprozessor
• Port 8081 und 15999 auf Routern
• Port 8082 und 8998 auf Message Processors
• Port 8080 auf dem Verwaltungsserver

Prüfen Sie, ob die folgenden Ports von Drittanbietern aktiv sind:

• Qpid-Port 5672
• Postgres-Port 5432
• Cassandra-Port 7000, 7199, 9042, 9160
• ZooKeeper-Port 2181
• OpenLDAP-Port 10389

Um zu ermitteln, auf welchem Port jede Apigee-Komponente auf API-Aufrufe wartet, führen Sie die folgenden API-Aufrufe an den Verwaltungsserver aus (der sich in der Regel auf Port 8080 befindet):

curl -v -u username:password http://host:port/v1/servers?pod=gateway&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=central&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=analytics&region=dc-1

Die Ausgabe dieser Befehle enthält Abschnitte, die dem unten gezeigten ähneln. Im Abschnitt http.management.port wird die Portnummer für die angegebene Komponente angegeben.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

Logs ansehen

In Logdateien werden Nachrichten zu Ereignissen/Vorgängen des Systems erfasst. Meldungen werden im Protokoll angezeigt, wenn Prozesse beginnen und abgeschlossen werden oder ein Fehler auftritt. In Protokolldateien finden Sie Informationen zu Systemkomponenten wie CPU, Arbeitsspeicher, Festplatte, Auslastung und Prozessen vor und nach dem Auftreten eines Fehlers. So können Sie auch die Ursache aktueller Systemprobleme ermitteln und diagnostizieren oder potenzielle Systemprobleme vorhersagen.

Ein typisches Systemprotokoll einer Komponente enthält beispielsweise die folgenden Einträge:

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

Sie können die Datei /opt/apigee/conf/logback.xml bearbeiten, um den Protokollierungsmechanismus zu steuern, ohne einen Server neu starten zu müssen. Die Datei „logback.xml“ enthält die folgende Eigenschaft, mit der festgelegt wird, wie oft der Logging-Mechanismus die Datei „logback.xml“ auf Konfigurationsänderungen prüft:

<configuration scan="true" scanPeriod="30 seconds" >

Standardmäßig prüft der Logging-Mechanismus jede Minute auf Änderungen. Wenn Sie die Zeiteinheiten für das scanPeriod-Attribut weglassen, wird standardmäßig „Millisekunden“ verwendet.

In der folgenden Tabelle finden Sie den Speicherort der Protokolldateien der Apigee Edge Private Cloud-Komponenten.

Debug-Protokolle für den Message Processor und die Edge-Benutzeroberfläche aktivieren

So aktivieren Sie Debug-Logs für den Nachrichtenverarbeiter:

1. Bearbeiten Sie im Knoten „Message Processor“ die Variable /opt/apigee/customer/application/messsage-processor.properties. Wenn diese Datei nicht vorhanden ist, erstellen Sie sie.
2. Fügen Sie der Datei das folgende Attribut hinzu:

   conf_system_log.level=DEBUG

3. Starten Sie den Message Processor neu:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

So aktivieren Sie Fehlerbehebungsprotokolle für die Edge-Benutzeroberfläche:

1. Bearbeiten Sie im Knoten „Edge UI“ die Variable /opt/apigee/customer/application/ui.properties. Wenn diese Datei nicht vorhanden ist, erstellen Sie sie.
2. Fügen Sie der Datei das folgende Attribut hinzu:

   conf_application_logger.application=DEBUG

3. Starten Sie die Edge-Benutzeroberfläche neu:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Best Practices für apigee-monit

Apigee empfiehlt bei der Verwendung von apigee-monit Folgendes:

• Halten Sie das Monitoring einer Komponente an, bevor Sie einen Vorgang ausführen, der sie startet oder anhält, z. B. eine Sicherung oder ein Upgrade.
• Überwachen Sie apigee-monit mit einem Tool wie cron. Weitere Informationen finden Sie unter apigee-monit überwachen.

Monitoring-Tools

Mit Monitoring-Tools wie Nagios, Collectd, Graphite, Splunk, Sumologic und Monit können Sie Ihre gesamte Unternehmensumgebung und Ihre Geschäftsprozesse im Blick behalten.