Monitoring

In diesem Dokument werden die Monitoringtechniken von Komponenten beschrieben, die von einer lokalen Bereitstellung von Apigee Edge for Private Cloud unterstützt werden.

Übersicht

Edge bietet mehrere Möglichkeiten, Details zu Diensten abzurufen und ihren Status zu prüfen. In der folgenden Tabelle sind die Arten von Prüfungen aufgeführt, die Sie für jeden unterstützten Dienst ausführen können:

Ports und Konfigurationsdateien überwachen

Jede Komponente unterstützt JMX- und Management API-Monitoringaufrufe auf verschiedenen Ports. In der folgenden Tabelle sind die JMX- und Management API-Ports für jeden Servertyp und die Speicherorte der Konfigurationsdateien aufgeführt:

JMX zum Überwachen von Komponenten verwenden

In den folgenden Abschnitten wird beschrieben, wie Sie Edge-Komponenten mit JMX überwachen.

JMX aktivieren

Führen Sie die folgenden Schritte aus, um JMX ohne Authentifizierung oder SSL-basierte Kommunikation zu aktivieren. Hinweis:In Produktionssystemen sollten aus Sicherheitsgründen sowohl die verschlüsselte Authentifizierung als auch SSL aktiviert sein.

1. Bearbeiten Sie die entsprechende Konfigurationsdatei (siehe Referenz zur Konfigurationsdatei). Erstellen Sie die Konfigurationsdatei, falls sie noch nicht vorhanden ist.

   conf_system_jmxremote_enable=true

2. Speichern Sie die Konfigurationsdatei und achten Sie darauf, dass apigee:apigee der Eigentümer ist.
3. Entsprechende Edge-Komponente neu starten

   apigee-service edge-management-server restart

Wenn Sie JMX deaktivieren möchten, entfernen Sie die Property conf_system_jmxremote_enable oder ändern Sie ihren Wert in false. Starten Sie dann die entsprechende Edge-Komponente neu.

Authentifizierung in JMX

Edge for Private Cloud unterstützt die passwortbasierte Authentifizierung mit in Dateien gespeicherten Details. Sie können Passwörter für zusätzliche Sicherheit als Hash speichern.

1. Wenn Sie die JMX-Authentifizierung in einer edge-*-Komponente aktivieren möchten, bearbeiten Sie die entsprechende Konfigurationsdatei (siehe Konfigurationsdatei – Referenz). Erstellen Sie die Konfigurationsdatei, falls sie noch nicht vorhanden ist:

   conf_system_jmxremote_enable=true
   conf_system_jmxremote_authenticate=true
   conf_system_jmxremote_encrypted_auth=true
   conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
   conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password

   Speichern Sie die Konfigurationsdatei und achten Sie darauf, dass apigee:apigee der Eigentümer ist.
2. Erstellen Sie einen SHA256-Hash des Passworts:

   echo -n '' | openssl dgst -sha256

3. Erstellen Sie eine jmxremote.password-Datei mit JMX-Nutzeranmeldedaten:
   1. Kopieren Sie die folgenden Dateien aus dem Verzeichnis $JAVA_HOME in das Verzeichnis /opt/apigee/customer/application/<component>/:

      cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/management-server/jmxremote.password

   2. Bearbeiten Sie die Datei und fügen Sie Ihren JMX-Nutzernamen und Ihr Passwort mit der folgenden Syntax hinzu:

      USERNAME <HASH-PASSWORD>

   3. Prüfen Sie, ob die Datei zu apigee gehört und der Dateimodus 400 ist:

      chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
      chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.password

4. Erstellen Sie eine jmxremote.access-Datei mit JMX-Nutzerberechtigungen:
   1. Kopieren Sie die folgenden Dateien aus dem Verzeichnis $JAVA_HOME in das Verzeichnis /opt/apigee/customer/application/<component>/:

      
      cp ${JAVA_HOME}/lib/management/jmxremote.access$APIGEE_ROOT/customer/application/management-server/jmxremote.password/jmxremote.access

   2. Bearbeiten Sie die Datei und fügen Sie Ihren JMX-Nutzernamen gefolgt von einer Berechtigung hinzu (READONLY/READWRITE).

      USERNAME READONLY

   3. Prüfen Sie, ob die Datei zu apigee gehört und der Dateimodus 400 ist:

      chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
      
      chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.access

5. Starten Sie die entsprechende Edge-Komponente neu:

   apigee-service edge-management-server restart

Wenn Sie die JMX-Authentifizierung deaktivieren möchten, entfernen Sie entweder die Property conf_system_jmxremote_authenticate oder ändern Sie den Wert in false und starten Sie die entsprechende Edge-Komponente neu.

SSL in JMX

So aktivieren Sie SSL-basiertes JMX in einer Edge*-Komponente:

1. Bearbeiten Sie die entsprechende Konfigurationsdatei (siehe Referenz zur Konfigurationsdatei). Erstellen Sie die Konfigurationsdatei, falls sie noch nicht vorhanden ist:

   conf_system_jmxremote_enable=true
   conf_system_jmxremote_ssl=true
   conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
   conf_system_javax_net_ssl_keystorepassword=<keystore-password>

   Speichern Sie die Konfigurationsdatei und achten Sie darauf, dass apigee:apigee der Eigentümer ist.
2. Erstellen Sie einen Schlüsselspeicher mit dem Serverschlüssel und platzieren Sie ihn im Pfad, der in der Konfiguration conf_system_javax_net_ssl_keystore oben angegeben ist. Die Schlüsseldatei muss von apigee:apigee gelesen werden können.
3. Starten Sie die entsprechende Edge-Komponente neu:

   apigee-service edge-management-server restart

Wenn Sie SSL-basierte JMX deaktivieren möchten, entfernen Sie entweder die Property conf_system_jmxremote_ssl oder ändern Sie den Wert in false. Starten Sie die entsprechende Edge-Komponente neu.

Monitoring über Jconsole

Die Anleitung zum Überwachen über jconsole bleibt unverändert und ist unter https://docs.apigee.com/private-cloud/v4.52.01/how-monitor#jconsole beschrieben.

Mit JConsole überwachen

Verwenden Sie die JConsole (ein JMX-konformes Tool), um Systemdiagnosen und Verarbeitungsstatistiken zu verwalten und zu überwachen. Mit JConsole können Sie von Ihren Servern bereitgestellte JMX-Statistiken auf einer grafischen Benutzeroberfläche anzeigen. Weitere Informationen finden Sie unter JConsole verwenden.

Sie müssen JConsole mit Truststore und Truststore-Passwort starten, wenn SSL für JMX aktiviert ist. Weitere Informationen finden Sie unter JConsole verwenden.

Die JConsole verwendet die folgende Dienst-URL, um die über JMX angebotenen JMX-Attribute (MBeans) zu überwachen:

service:jmx:rmi:///jndi/rmi://IP_address:port_number/jmxrmi

Wobei:

• IP_address ist die IP-Adresse des Servers, den Sie überwachen möchten.
• port_number ist die JMX-Portnummer des Servers, den Sie überwachen möchten.

Wenn Sie beispielsweise den Verwaltungsserver überwachen möchten, geben Sie einen Befehl wie den folgenden ein (vorausgesetzt, die IP-Adresse des Servers lautet 216.3.128.12):

service:jmx:rmi:///jndi/rmi://216.3.128.12:1099/jmxrmi

In diesem Beispiel ist Port 1099 angegeben. Das ist der JMX-Port des Verwaltungsservers. Informationen zu anderen Ports finden Sie unter JMX- und Management API-Monitoring-Ports.

Die folgende Tabelle zeigt die generischen JMX-Statistiken:

Konfigurationsdateireferenz

In den folgenden Abschnitten werden Änderungen beschrieben, die Sie möglicherweise an den Edge-Komponentenkonfigurationsdateien für JMX-bezogene Konfigurationen vornehmen müssen. Weitere Informationen finden Sie unter Ports und Konfigurationsdateien überwachen.

JMX-Konfiguration, die der Konfigurationsdatei der entsprechenden Komponente hinzugefügt wird

• Aktivieren Sie den JMX-Agenten auf der Edge-Komponente. Standardmäßig „false“.

  conf_system_jmxremote_enable=true

Konfigurationen für die passwortbasierte Authentifizierung

• Aktivieren Sie die passwortbasierte Authentifizierung. Standardmäßig „false“.

  conf_system_jmxremote_authenticate=true

• Pfad zur Zugriffsdatei. Sollte nur dem Apigee-Nutzer gehören und nur von ihm lesbar sein.

  conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access

• Pfad zur Passwortdatei. Sollte nur einem Apigee-Nutzer gehören und von diesem gelesen werden können.

  conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password

• Aktivieren Sie das Speichern des Passworts im verschlüsselten Format. Standardmäßig „false“.

  conf_system_jmxremote_encrypted_auth=true

Konfigurationen für SSL-basierte JMX

• Aktivieren Sie SSL für die JMX-Kommunikation. Standardmäßig „false“.

  conf_system_jmxremote_ssl=true

• Pfad zum Schlüsselspeicher. Sollte nur dem Apigee-Nutzer gehören und nur von ihm lesbar sein.

  conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore

• Schlüsselspeicher-Passwort:

  conf_system_javax_net_ssl_keystorepassword=changeme

Optionale JMX-Konfigurationen

Die aufgeführten Werte sind Standardwerte und können geändert werden.

• JMX-Port Die Standardwerte sind in der folgenden Tabelle aufgeführt.

  conf_system_jmxremote_port=

• JMX-RMI-Port. Standardmäßig wählt der Java-Prozess einen zufälligen Port aus.

  conf_system_jmxremote_rmi_port=

• Der Hostname für Remote-Stubs. Standard-IP-Adresse von localhost.

  conf_system_java_rmi_server_hostname=

• Schützen Sie die JMX-Registrierung mit SSL. Standardeinstellung: false. Gilt nur, wenn SSL aktiviert ist.

  conf_system_jmxremote_registry_ssl=false

Mit der Verwaltungs-API überwachen

Edge enthält mehrere APIs, mit denen Sie Dienstprüfungen auf Ihren Servern sowie auf Ihre Nutzer, Organisationen und Bereitstellungen durchführen können. In diesem Abschnitt werden diese APIs beschrieben.

Dienstprüfungen durchführen

Die Management API bietet mehrere Endpunkte für das Monitoring und die Diagnose von Problemen mit Ihren Diensten. Zu diesen Endpunkten gehören:

<ServerField>
  <Up>true</Up>
</ServerField>

curl: Failed connect to localhost:port_number; Connection refused

Wenn Sie diese Endpunkte verwenden möchten, rufen Sie ein Dienstprogramm wie curl mit Befehlen mit der folgenden Syntax auf:

curl http://host:port_number/v1/servers/self/up -H "Accept: [application/json|application/xml]"
curl http://host:port_number/v1/servers/self -u username:password -H "Accept: [application/json|application/xml]"

Wobei:

• host ist die IP-Adresse des Servers, den Sie prüfen möchten. Wenn Sie auf dem Server angemeldet sind, können Sie „localhost“ verwenden. Andernfalls geben Sie die IP-Adresse des Servers sowie den Nutzernamen und das Passwort an.
• port_number ist der Management API-Port für den Server, den Sie prüfen möchten. Dieser Anschluss ist für jeden Komponententyp unterschiedlich. Beispiel: Der Management API-Port des Verwaltungsservers ist 8080. Eine Liste der zu verwendenden Management API-Portnummern finden Sie unter JMX- und Management API-Monitoring-Ports.

Wenn Sie das Format der Antwort ändern möchten, können Sie den Accept-Header als „application/json“ oder „application/xml“ angeben.

Im folgenden Beispiel wird der Status des Routers auf dem lokalen Host (Port 8081) abgerufen:

curl http://localhost:8081/v1/servers/self/up -H "Accept: application/xml"

Im folgenden Beispiel werden Informationen zum Message Processor unter 216.3.128.12 (Port 8082) abgerufen:

curl http://216.3.128.12:8082/v1/servers/self -u sysAdminEmail:password
  -H "Accept: application/xml"

Nutzer-, Organisations- und Bereitstellungsstatus im Blick behalten

Mit der Management API können Sie den Nutzer-, Organisations- und Bereitstellungsstatus Ihrer Proxys auf Management-Servern und Nachrichten-Prozessoren überwachen. Dazu geben Sie die folgenden Befehle ein:

curl http://host:port_number/v1/users -u sysAdminEmail:password
curl http://host:port_number/v1/organizations -u sysAdminEmail:password
curl http://host:port_number/v1/organizations/orgname/deployments -u sysAdminEmail:password

Dabei ist port_number entweder 8080 für den Verwaltungsserver oder 8082 für den Message Processor.

Für diesen Aufruf müssen Sie sich mit Ihrem Nutzernamen und Passwort für die Systemadministration authentifizieren.

Der Server sollte für alle Aufrufe den Status „deployed“ zurückgeben. Wenn diese Schritte nicht funktionieren, gehen Sie so vor:

1. Prüfen Sie die Serverprotokolle auf Fehler. Die Protokolle befinden sich hier:
   • Verwaltungsserver: opt/apigee/var/log/edge-management-server
   • Nachrichtenverarbeiter: opt/apigee/var/log/edge-message-processor
2. Rufen Sie den Server auf, um zu prüfen, ob er richtig funktioniert.
3. Entfernen Sie den Server aus dem ELB und starten Sie ihn dann neu:

   /opt/apigee/apigee-service/bin/apigee-service service_name restart

   Wo service_name Folgendes ist:

   • edge-management-server
   • edge-message-processor

Status mit dem Befehl apigee-service prüfen

Sie können Ihre Edge-Dienste mit dem Befehl apigee-service beheben, wenn Sie auf dem Server, auf dem der Dienst ausgeführt wird, angemeldet sind.

So prüfen Sie den Status eines Dienstes mit apigee-service:

1. Melden Sie sich auf dem Server an und führen Sie den folgenden Befehl aus:

   /opt/apigee/apigee-service/bin/apigee-service service_name status

   Dabei kann service_name für folgendes stehen:

   • Verwaltungsserver: edge-management-server
   • Nachrichtenprozessor: edge-message-processor
   • Postgres: edge-postgres-server
   • Qpid: edge-qpid-server
   • Router: edge-router

   Beispiel:

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

2. Wenn der Dienst nicht ausgeführt wird, starten Sie ihn:

   /opt/apigee/apigee-service/bin/apigee-service service_name start

3. Prüfen Sie nach dem Neustart des Dienstes, ob er funktioniert. Verwenden Sie dazu entweder den zuvor verwendeten apigee-service status-Befehl oder die Management API (siehe Mit der Management API überwachen).

   Beispiel:

   curl -v http://localhost:port_number/v1/servers/self/up

   Dabei ist port_number der Port der Management API für den Dienst.

   In diesem Beispiel wird davon ausgegangen, dass Sie auf dem Server angemeldet sind und „localhost“ als Hostnamen verwenden können. Wenn Sie den Status per Fernzugriff mit der Management API prüfen möchten, müssen Sie die IP-Adresse des Servers angeben und den Nutzernamen und das Passwort des Systemadministrators in Ihren API-Aufruf aufnehmen.

Postgres-Monitoring

Postgres unterstützt mehrere Dienstprogramme, mit denen Sie den Status prüfen können. Diese Dienstprogramme werden in den folgenden Abschnitten beschrieben.

Organisationen und Umgebungen in Postgres prüfen

Sie können mit dem folgenden curl-Befehl nach Namen von Organisationen und Umgebungen suchen, die auf dem Postgres-Server eingerichtet sind:

curl -v http://postgres_IP:8084/v1/servers/self/organizations

Das System sollte den Namen der Organisation und der Umgebung anzeigen.

Analysestatus überprüfen

Sie können den Status der Postgres- und Qpid-Analyseserver mit dem folgenden curl-Befehl prüfen:

curl -u userEmail:password http://host:port_number/v1/organizations/orgname/environments/envname/provisioning/axstatus

Das System sollte für alle Analyseserver einen Erfolgsstatus anzeigen, wie im folgenden Beispiel zu sehen:

{
  "environments" : [ {
    "components" : [ {
      "message" : "success at Thu Feb 28 10:27:38 CET 2013",
      "name" : "pg",
      "status" : "SUCCESS",
      "uuid" : "[c678d16c-7990-4a5a-ae19-a99f925fcb93]"
     }, {
      "message" : "success at Thu Feb 28 10:29:03 CET 2013",
      "name" : "qs",
      "status" : "SUCCESS",
      "uuid" : "[ee9f0db7-a9d3-4d21-96c5-1a15b0bf0adf]"
     } ],
    "message" : "",
    "name" : "prod"
   } ],
  "organization" : "acme",
  "status" : "SUCCESS"
}

PostgreSQL-Datenbank

In diesem Abschnitt werden Techniken beschrieben, die Sie speziell für das Monitoring der Postgres-Datenbank verwenden können.

check_postgres.pl-Script verwenden

Sie können ein Standard-Monitoring-Script verwenden, um die PostgreSQL-Datenbank zu überwachen: check_postgres.pl. Weitere Informationen finden Sie unter http://bucardo.org/wiki/Check_postgres.

Vor dem Ausführen des Scripts:

1. Sie müssen das Skript check_postgres.pl auf jedem Postgres-Knoten installieren.
2. Sie müssen perl-Time-HiRes.x86_64 installiert haben, ein Perl-Modul, das Wecker, Sleep, gettimeofday und Intervall-Timer mit hoher Auflösung implementiert. Sie können es beispielsweise mit dem folgenden Befehl installieren:
   

   yum install perl-Time-HiRes.x86_64

3. CentOS 7: Bevor Sie check_postgres.pl unter CentOS 7 verwenden, müssen Sie das RPM perl-Data-Dumper.x86_64 installieren.

check_postgres.pl-Ausgabe

Die Standardausgabe der API-Aufrufe mit check_postgres.pl ist mit Nagios kompatibel. Führen Sie nach der Installation des Skripts folgende Prüfungen durch:

1. Prüfen Sie die Datenbankgröße:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -include=apigee -action database_size --warning='800 GB' --critical='900 GB'

2. Prüfen Sie die Anzahl der eingehenden Verbindungen zur Datenbank und vergleichen Sie sie mit der maximal zulässigen Anzahl:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends

3. Prüfen, ob die Datenbank ausgeführt wird und verfügbar ist:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action connection

4. Prüfen Sie den Speicherplatz:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action disk_space --warning='80%' --critical='90%'

5. Prüfen Sie die Anzahl der Organisationen und Umgebungen, die in einem Postgres-Knoten eingerichtet wurden:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action=custom_query --query="select count(*) as result from pg_tables where schemaname='analytics' and tablename like '%fact'" --warning='80' --critical='90' --valtype=integer

Datenbankprüfungen ausführen

Sie können prüfen, ob die richtigen Tabellen in der PostgreSQL-Datenbank erstellt wurden. Melden Sie sich mit dem folgenden Befehl in der PostgreSQL-Datenbank an:

psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee

Führen Sie dann diesen Befehl aus:

\d analytics."org.env.fact"

Systemstatus des Postgres-Prozesses prüfen

Sie können API-Prüfungen auf der Postgres-Maschine mit dem folgenden curl-Befehl durchführen:

curl -v http://postgres_IP:8084/v1/servers/self/health

Dieser Befehl gibt den Status ACTIVE zurück, wenn der Postgres-Prozess aktiv ist. Wenn der Postgres-Prozess nicht aktiv ist, wird der Status INACTIVE zurückgegeben.

Postgres-Ressourcen

Weitere Informationen zum Überwachen des Postgres-Dienstes finden Sie hier:

• http://www.postgresql.org/docs/9.0/static/monitoring.html
• http://www.postgresql.org/docs/9.0/static/diskusage.html
• http://bucardo.org/check_postgres/check_postgres.pl.html

Apache Cassandra

JMX ist standardmäßig für Cassandra aktiviert und für den Remote-JMX-Zugriff auf Cassandra ist kein Passwort erforderlich.

JMX-Authentifizierung für Cassandra aktivieren

Sie können die JMX-Authentifizierung für Cassandra aktivieren. Danach müssen Sie bei allen Aufrufen des nodetool-Dienstprogramms einen Nutzernamen und ein Passwort angeben.

So aktivieren Sie die JMX-Authentifizierung für Cassandra:

1. Erstellen und bearbeiten Sie die Datei cassandra.properties:
   1. Bearbeiten Sie die Datei /opt/apigee/customer/application/cassandra.properties. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
   2. Fügen Sie der Datei Folgendes hinzu:

      conf_cassandra_env_com.sun.management.jmxremote.authenticate=true
      conf_cassandra_env_com.sun.management.jmxremote.password.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.password
      conf_cassandra_env_com.sun.management.jmxremote.access.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.access

   3. Speichern Sie die Datei cassandra.properties.
   4. Ändern Sie den Eigentümer der Datei in apigee:apigee, wie im folgenden Beispiel gezeigt:

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

   Weitere Informationen zum Festlegen von Tokens mithilfe von Properties-Dateien finden Sie unter Edge konfigurieren.

2. So erstellen und bearbeiten Sie jmx_auth.sh:
   1. Erstellen Sie eine Datei an folgendem Speicherort, falls sie noch nicht vorhanden ist:

      /opt/apigee/customer/application/jmx_auth.sh

   2. Fügen Sie der Datei die folgenden Properties hinzu:

      export CASS_JMX_USERNAME=JMX_USERNAME
      export CASS_JMX_PASSWORD=JMX_PASSWORD

   3. Speichern Sie die Datei jmx_auth.sh.
   4. Quelle der Datei:

      source /opt/apigee/customer/application/jmx_auth.sh

3. Kopieren und bearbeiten Sie die Datei jmxremote.password:
   1. Kopieren Sie die folgende Datei aus dem Verzeichnis $JAVA_HOME in /opt/apigee/customer/application/apigee-cassandra/:

      cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password

   2. Bearbeiten Sie die Datei jmxremote.password und fügen Sie Ihren JMX-Nutzernamen und Ihr JMX-Passwort mit der folgenden Syntax hinzu:

      JMX_USERNAME JMX_PASSWORD

      Dabei sind JMX_USERNAME und JMX_PASSWORD der zuvor festgelegte JMX-Nutzername und das zuvor festgelegte JMX-Passwort.

   3. Die Datei muss zu „apigee“ gehören und der Dateimodus muss 400 sein:

      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.password

4. Kopieren und bearbeiten Sie die Datei jmxremote.access:
   1. Kopieren Sie die folgende Datei aus dem Verzeichnis $JAVA_HOME in /opt/apigee/customer/application/apigee-cassandra/:

      cp ${JAVA_HOME}/lib/management/jmxremote.access
      $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.access

   2. Bearbeiten Sie die Datei jmxremote.access und fügen Sie die folgende Rolle hinzu:

      JMX_USERNAME readwrite

   3. Die Datei muss zu „apigee“ gehören und der Dateimodus muss 400 sein:

      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.access

5. Führen Sie configure auf Cassandra aus:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

6. Starten Sie Cassandra neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

7. Wiederholen Sie diesen Vorgang auf allen anderen Cassandra-Knoten.

JMX-Passwortverschlüsselung aktivieren

So aktivieren Sie die JMX-Passwortverschlüsselung:

1. Öffnen Sie die Datei source/conf/casssandra-env.sh.
2. Erstellen und bearbeiten Sie die Datei cassandra.properties:
   1. Bearbeiten Sie die Datei /opt/apigee/customer/application/cassandra.properties. Ist die Datei nicht vorhanden, erstellen Sie sie.
   2. Fügen Sie der Datei Folgendes hinzu:

      conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true

   3. Speichern Sie die Datei cassandra.properties.
   4. Ändern Sie den Eigentümer der Datei in apigee:apigee, wie im folgenden Beispiel gezeigt:

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

3. Generieren Sie in der Befehlszeile SHA1-Hashes der gewünschten Passwörter, indem Sie echo -n 'Secret' | openssl dgst -sha1 eingeben
4. Legen Sie die Passwörter für den Nutzernamen in $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password fest, den Sie im vorherigen Abschnitt erstellt haben.
5. Führen Sie „configure“ auf Cassandra aus:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

6. Starten Sie Cassandra neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

7. Wiederholen Sie diesen Vorgang auf allen anderen Cassandra-Knoten.

JMX mit SSL für Cassandra aktivieren

Wenn Sie JMX mit SSL aktivieren, erhalten Sie zusätzliche Sicherheit und Verschlüsselung für die JMX-basierte Kommunikation mit Cassandra. Wenn Sie JMX mit SSL aktivieren möchten, müssen Sie Cassandra einen Schlüssel und ein Zertifikat zur Verfügung stellen, damit SSL-basierte JMX-Verbindungen akzeptiert werden. Außerdem müssen Sie nodetool und alle anderen Tools, die über JMX mit Cassandra kommunizieren, für SSL konfigurieren.

SSL-fähige JMX-Passwörter unterstützen sowohl Klartext- als auch verschlüsselte JMX-Passwörter.

So aktivieren Sie JMX mit SSL für Cassandra:

1. Aktivieren Sie JMX. Aktivieren Sie gegebenenfalls die Passwortverschlüsselung.
2. Aktivieren Sie die JMX-Authentifizierung für Cassandra. wie oben beschrieben. Prüfen Sie, ob nodetool mit dem konfigurierten Nutzernamen und Passwort funktioniert.

   /opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring

3. Schlüsselspeicher und Truststore vorbereiten

   • Der Schlüsselspeicher sollte einen Schlüssel und ein Zertifikat enthalten und wird zum Konfigurieren des Cassandra-Servers verwendet. Wenn der Schlüsselspeicher mehrere Schlüsselpaare enthält, verwendet Cassandra das erste Schlüsselpaar, um SSL zu aktivieren.

     Die Passwörter für den Schlüsselspeicher und den Schlüssel müssen gleich sein (Standardeinstellung beim Generieren des Schlüssels mit keytool).

   • Der Truststore sollte nur das Zertifikat enthalten und wird von Clients (Apigee-dienstbasierte Befehle oder Nodetool) verwendet, um eine Verbindung über JMX herzustellen.

   Nachdem Sie die oben genannten Anforderungen überprüft haben, gehen Sie so vor:

   1. Platzieren Sie die Schlüsselspeicherdatei in /opt/apigee/customer/application/apigee-cassandra/.
   2. Achten Sie darauf, dass die Schlüsselspeicherdatei nur für Apigee-Nutzer lesbar ist. Geben Sie dazu

      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/keystore.node1
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/keystore.node1

      ein
4. Konfigurieren Sie Cassandra für JMX mit SSL mit den folgenden Schritten:
   1. Beenden Sie den Cassandra-Knoten, indem Sie

      apigee-service apigee-cassandra stop

      eingeben.
   2. Aktivieren Sie SSL in Cassandra. Öffnen Sie dazu die Datei /opt/apigee/customer/application/cassandra.properties und fügen Sie die folgenden Zeilen hinzu:

      conf_cassandra_env_com.sun.management.jmxremote.ssl=true
      conf_cassandra_env_javax.net.ssl.keyStore=/opt/apigee/customer/application/apigee-cassandra/keystore.node1
      conf_cassandra_env_javax.net.ssl.keyStorePassword=keystore-password
      ## On FIPS enabled systems, when you are using non standard keystore, set the following:
      ## These can be skipped otherwise
      ## Possible values are JKS, PKCS12, BCFKS
      conf_cassandra_env_javax.net.ssl.keyStoreType=PKCS12
      conf_cassandra_env_javax.net.ssl.keyStoreAlias=cassjmx-tls-alias

   3. Ändern Sie den Eigentümer der Datei in apigee:apigee, wie im folgenden Beispiel gezeigt:

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

   4. Führen Sie „config“ in Cassandra aus:

      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

   5. Starten Sie Cassandra neu:

      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

   6. Wiederholen Sie diesen Vorgang auf allen anderen Cassandra-Knoten.
   7. Starten Sie den Cassandra-Knoten, indem Sie

      apigee-service apigee-cassandra start

      eingeben.
5. Konfigurieren Sie die apigee-service-Cassandra-Befehle. Sie müssen bestimmte Umgebungsvariablen festlegen, wenn Sie apigee-service-Befehle ausführen. Dazu gehören die folgenden:

   apigee-service apigee-cassandra stop
   apigee-service apigee-cassandra wait_for_ready
   apigee-service apigee-cassandra ring
   apigee-service apigee-cassandra backup

   Es gibt mehrere Möglichkeiten, apigee-service für die JMX-Authentifizierung und SSL zu konfigurieren. Wählen Sie eine Option basierend auf der Nutzerfreundlichkeit und Ihren Sicherheitspraktiken aus.

   • Option 1 (SSL-Argumente in Datei gespeichert)
   • Option 2 (SSL-Argumente in Umgebungsvariablen gespeichert)
   • Option 3 (SSL-Argumente werden direkt an apigee-service übergeben)

   Option 1 (SSL-Argumente in Datei gespeichert)

   Legen Sie die folgenden Umgebungsvariablen fest:

   export CASS_JMX_USERNAME=ADMIN
   # Provide encrypted password here if you have setup JMX password encryption
   export CASS_JMX_PASSWORD=PASSWORD
   export CASS_JMX_SSL=Y

   Erstellen Sie eine Datei im Basisverzeichnis des Apigee-Nutzers (/opt/apigee).

   $HOME/.cassandra/nodetool-ssl.properties

   Bearbeiten Sie die Datei und fügen Sie die folgenden Zeilen hinzu:

   -Djavax.net.ssl.trustStore=
   -Djavax.net.ssl.trustStorePassword=
   -Dcom.sun.management.jmxremote.registry.ssl=true
   ## If you are using a non standard truststore, set below, otherwise skip
   ## Possible values are JKS, PKCS12, BCFKS
   -Djavax.net.ssl.trustStoreType=PKCS12

   Die Trustore-Datei muss für Apigee-Nutzer lesbar sein.

   Führen Sie dazu den folgenden apigee-service-Befehl aus. Wenn der Test ohne Fehler ausgeführt wird, sind Ihre Konfigurationen korrekt.

   apigee-service apigee-cassandra ring

   Option 2 (SSL-Argumente in Umgebungsvariablen gespeichert)

   Legen Sie die folgenden Umgebungsvariablen fest:

   export CASS_JMX_USERNAME=ADMIN
   # Provide encrypted password here if you have setup JMX password encryption
   export CASS_JMX_PASSWORD=PASSWORD
   export CASS_JMX_SSL=Y
   # Ensure the truststore file is accessible by Apigee user.
   export CASS_JMX_TRUSTSTORE=
   export CASS_JMX_TRUSTSTORE_PASSWORD=
   # If you are using a non standard truststore type, export truststore type as well
   # Possible values are JKS, PKCS12, BCFKS
   export CASS_JMX_TRUSTSTORE_TYPE=PKCS12

   Führen Sie dazu den folgenden apigee-service-Befehl aus. Wenn der Test ohne Fehler ausgeführt wird, sind Ihre Konfigurationen korrekt.

   apigee-service apigee-cassandra ring

   Option 3 (SSL-Argumente werden direkt an apigee-service übergeben)

   Führen Sie einen beliebigen apigee-service-Befehl wie den folgenden aus. Sie müssen keine Umgebungsvariablen konfigurieren.

   CASS_JMX_USERNAME=ADMIN CASS_JMX_PASSWORD=PASSWORD CASS_JMX_SSL=Y CASS_JMX_TRUSTSTORE= CASS_JMX_TRUSTSTORE_PASSWORD= CASS_JMX_TRUSTSTORE_TYPE=PKCS12 /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring

6. Richten Sie nodetool ein. Nodetool erfordert, dass JMX-Parameter übergeben werden. Es gibt zwei Möglichkeiten, nodetool für die Ausführung mit SSL-fähigem JMX zu konfigurieren. Eine Beschreibung der Konfigurationsoptionen finden Sie unten:

   • Konfigurationsoption 1
   • Konfigurationsoption 2

   Die Optionen unterscheiden sich darin, wie SSL-bezogene Konfigurationen an nodetool übergeben werden. In beiden Fällen sollte der Nutzer, der das nodetool ausführt, Leseberechtigungen für die Truststore-Datei haben. Wählen Sie basierend auf der Nutzerfreundlichkeit und Ihren Sicherheitspraktiken eine Option aus.

   Weitere Informationen zu den Parametern von nodetool finden Sie in der DataStax-Dokumentation.

   Konfigurationsoption 1

   Erstellen Sie eine Datei im Basisverzeichnis des Nutzers, der nodetool ausführt.

   $HOME/.cassandra/nodetool-ssl.properties

   Fügen Sie der Datei die folgenden Zeilen hinzu:

   -Djavax.net.ssl.trustStore=
   -Djavax.net.ssl.trustStorePassword=
   -Dcom.sun.management.jmxremote.registry.ssl=true
   ## If you are using a non standard truststore, set below, otherwise skip
   ## Possible values are JKS, PKCS12, BCFKS
   -Djavax.net.ssl.trustStoreType=PKCS12

   Auf den oben angegebenen Truststore-Pfad muss jeder Nutzer zugreifen können, der nodetool ausführt.

   Führen Sie nodetool mit der Option --ssl aus.

   /opt/apigee/apigee-cassandra/bin/nodetool --ssl -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring

   Konfigurationsoption 2

   Führen Sie nodetool als einzelnen Befehl mit den unten aufgeführten zusätzlichen Parametern aus.

   /opt/apigee/apigee-cassandra/bin/nodetool -Djavax.net.ssl.trustStore= -Djavax.net.ssl.trustStorePassword= -Dcom.sun.management.jmxremote.registry.ssl=true -Djavax.net.ssl.trustStoreType=PKCS12 -Dssl.enable=true -u  -pw  -h localhost ring

SSL-Konfigurationen rückgängig machen

Wenn Sie die oben beschriebenen SSL-Konfigurationen rückgängig machen möchten, gehen Sie so vor:

1. apigee-cassandra beenden, indem Sie

   apigee-service apigee-cassandra stop

   eingeben
2. Entfernen Sie die Zeile conf_cassandra-env_com.sun.management.jmxremote.ssl=true aus der Datei /opt/apigee/customer/application/cassandra.properties.
3. Kommentieren Sie die folgenden Zeilen in /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh:

   # JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStore=/opt/apigee/data/apigee-cassandra/keystore.node0"
   # JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStorePassword=keypass"
   # JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.registry.ssl=true”

4. Starte apigee-cassandra, indem du

apigee-service apigee-cassandra start

5. Entfernen Sie die Umgebungsvariable CASS_JMX_SSL, falls sie festgelegt wurde.

   unset CASS_JMX_SSL

6. Prüfen Sie, ob apigee-service-basierte Befehle wie ring, stop, backup usw. funktionieren.
7. --ssl-Schalter mit nodetool nicht mehr verwenden

JMX-Authentifizierung für Cassandra deaktivieren

So deaktivieren Sie die JMX-Authentifizierung für Cassandra:

1. /opt/apigee/customer/application/cassandra.properties bearbeiten
2. Entfernen Sie die folgende Zeile aus der Datei:

   conf_cassandra-env_com.sun.management.jmxremote.authenticate=true

3. Führen Sie „config“ in Cassandra aus:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

4. Starten Sie Cassandra neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

5. Wiederholen Sie diesen Vorgang auf allen anderen Cassandra-Knoten.

JConsole verwenden: Aufgabenstatistiken überwachen

Verwenden Sie JConsole und die folgende Dienst-URL, um die über JMX angebotenen JMX-Attribute (MBeans) zu überwachen:

service:jmx:rmi:///jndi/rmi://IP_address:7199/jmxrmi

Dabei ist IP_address die IP-Adresse des Cassandra-Servers.

Cassandra-JMX-Statistiken

Clusterknoten mit nodetool verwalten

Das nodetool-Dienstprogramm ist eine Befehlszeilenschnittstelle für Cassandra, mit der Clusterknoten verwaltet werden. Sie finden das Dienstprogramm unter /opt/apigee/apigee-cassandra/bin.

Die folgenden Aufrufe können auf allen Cassandra-Clusterknoten ausgeführt werden:

1. Allgemeine Ringinformationen (auch für einen einzelnen Cassandra-Knoten möglich): Prüfen Sie, ob für alle Knoten der Status „Up“ (Aktiv) und „Normal“ angezeigt wird.

   nodetool [-u username -pw password] -h localhost ring

   Sie müssen nur Ihren Nutzernamen und Ihr Passwort übergeben, wenn Sie die JMX-Authentifizierung für Cassandra aktiviert haben.

   Die Ausgabe des obigen Befehls sieht so aus:

   Datacenter: dc-1
   ==========
   Address            Rack     Status State   Load    Owns    Token
   192.168.124.201    ra1      Up     Normal  1.67 MB 33,33%  0
   192.168.124.202    ra1      Up     Normal  1.68 MB 33,33%  5671...5242
   192.168.124.203    ra1      Up     Normal  1.67 MB 33,33%  1134...0484

2. Allgemeine Informationen zu Knoten (Anruf pro Knoten)

   nodetool [-u username -pw password]  -h localhost info

   Die Ausgabe des Befehls sieht in etwa so aus:

   ID                     : e2e42793-4242-4e82-bcf0-oicu812
   Gossip active          : true
   Thrift active          : true
   Native Transport active: true
   Load                   : 273.71 KB
   Generation No          : 1234567890
   Uptime (seconds)       : 687194
   Heap Memory (MB)       : 314.62 / 3680.00
   Off Heap Memory (MB)   : 0.14
   Data Center            : dc-1
   Rack                   : ra-1
   Exceptions             : 0
   Key Cache              : entries 150, size 13.52 KB, capacity 100 MB, 1520781 hits, 1520923 requests, 1.000 recent hit rate, 14400 save period in seconds
   Row Cache              : entries 0, size 0 bytes, capacity 0 bytes, 0 hits, 0 requests, NaN recent hit rate, 0 save period in seconds
   Counter Cache          : entries 0, size 0 bytes, capacity 50 MB, 0 hits, 0 requests, NaN recent hit rate, 7200 save period in seconds
   Token                  : 0

3. Status des Secondhandservers (Bereitstellungsclient API)

   nodetool [-u username -pw password] -h localhost statusthrift

   Die Ausgabe des Befehls sieht in etwa so aus:
   

   running

4. Status der Datenstreaming-Vorgänge: Beobachten Sie den Traffic für Cassandra-Knoten:

   nodetool [-u username -pw password] -h localhost netstats

   Die Ausgabe des obigen Befehls sieht so aus:
   

   Mode: NORMAL
   Not sending any streams.
   Read Repair Statistics:
   Attempted: 151612
   Mismatch (Blocking): 0
   Mismatch (Background): 0
   Pool Name                    Active   Pending      Completed   Dropped
   Commands                        n/a         0              0         0
   Responses                       n/a         0              0       n/a

Weitere Informationen zu nodetool finden Sie unter Das Dienstprogramm „nodetool“.

Cassandra-Ressource

Weitere Informationen finden Sie unter http://www.datastax.com/docs/1.0/operations/monitoring.

Apache Qpid Broker-J überwachen

Sie können Qpid Broker-J über die Qpid-Verwaltungskonsole überwachen. In diesem Abschnitt wird erläutert, wie Sie auf die Console zugreifen und damit grundlegende Monitoringfunktionen ausführen. Weitere Informationen zur Verwendung der Verwaltungskonsole finden Sie in der Apache Qpid-Dokumentation unter Web Management Console.

Auf die Verwaltungskonsole zugreifen

Der Standardport der Verwaltungskonsole ist 8090. Wenn Sie auf die Konsole über diesen Standardport zugreifen möchten, geben Sie in Ihrem Webbrowser Folgendes ein:

http://QPID_NODE_IP:8090

Verwenden Sie zum Anmelden in der Console die von Apigee festgelegten Standardanmeldedaten oder die in der Edge-Konfigurationsdatei festgelegten Anmeldedaten. Weitere Informationen finden Sie in der Referenz zu Edge-Konfigurationsdateien.

Warteschlangen und Nachrichten überwachen

Gehen Sie im linken Navigationsbereich zu Java-Broker > Virtualhosts > Warteschlangen. Wählen Sie eine Warteschlange aus, um die zugehörigen Details im Hauptbereich der Benutzeroberfläche aufzurufen. In der Detailansicht sehen Sie Queue-Attribute und -Statistiken, einschließlich Informationen zu zugestellten, in die Warteschlange gestellten und gesendeten Nachrichten sowie zu Nachrichtenraten.

Logdateien ansehen und herunterladen

Gehen Sie im linken Navigationsbereich zu Java-Broker > Broker-Logger > Logdatei. In der Detailansicht der Benutzeroberfläche können Sie Details zu Logdateien aufrufen und Logdateien herunterladen.

Qpid Management API verwenden

Mit der Apache Qpid Broker-J REST API können Sie Verwaltungsaufgaben automatisieren und den Broker überwachen. Weitere Informationen finden Sie in der REST API-Dokumentation für Apache Qpid Broker.

Sie können den Broker auch mit Befehlszeilentools überwachen. Beispiel:

curl "QPID_NODE_IP":"8090"/api/latest/broker -u "USERNAME":"PASSWORD"

Monitoring mit SSL für Qpid aktivieren

Aktivieren Sie SSL im Qpid-Verwaltungsportal und in den Qpid-Verwaltungs-APIs, um für zusätzliche Sicherheit bei Überwachung und Verwaltung zu sorgen. Folgen Sie der Anleitung unten, um einen Schlüssel und ein Zertifikat anzugeben.

Qpid bietet eine Option für einen Datei-Schlüsselspeicher, der in Apigee aktiviert ist. Dieser Typ akzeptiert das standardmäßige JKS-Schlüsselspeicherformat, das von Java- und Java-Tools wie keytool erkannt wird.

Schlüsselspeicher vorbereiten

Sie müssen die Zertifikatdatei zusätzlich zum Keytool direkt für die Verwendung durch Qpidd-Clients bereitstellen.

Informationen zum Generieren von Schlüsselspeichern finden Sie in der Java Keytool-Dokumentation.

Nach der Überprüfung der Anforderungen

1. Platzieren Sie die Schlüsselspeicher- und Zertifikatsdateien in /opt/apigee/customer/application/apigee-qpidd.
2. Achten Sie darauf, dass die Keystore-Datei nur vom Apigee-Nutzer gelesen werden kann:

   chown apigee:apigee /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore
     chmod 400 /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore
       
     chown apigee:apigee /opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem
     chmod 400 /opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem

SSL in Qpid aktivieren

Führen Sie die folgenden Schritte jeweils für einen Qpid-Knoten aus:

Öffnen Sie die Datei /opt/apigee/customer/application/qpidd.properties und fügen Sie die folgenden Zeilen hinzu:

conf_qpidd_qpid_management.https.enabled=true
  conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/qpidd.keystore
  conf_qpidd_qpid.keystore.password=keystore-password
  conf_qpidd_qpid.keystore.certificateAlias=certificate-alias
  conf_qpidd_qpid.keystore.certificate=/opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem

1. Ändern Sie den Eigentümer der Datei in apigee:apigee:

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

   .
2. Qpidd konfigurieren:

   apigee-service apigee-qpidd configure

3. Starten Sie Qpidd neu:

   apigee-service apigee-qpidd restart

4. Prüfen Sie den Status mit „wait_for_ready“:

   apigee-service apigee-qpidd wait_for_ready

SSL-Konfiguration rückgängig machen

Entfernen Sie die Attribute aus der Datei /opt/apigee/customer/application/qpidd.properties oder kommentieren Sie sie aus:

conf_qpidd_qpid_management.https.enabled=true
  conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/keystore

1. Konfigurieren Sie Qpidd:

   apigee-service apigee-qpidd configure

2. Starten Sie Qpidd neu:

   apigee-service apigee-qpidd restart

3. Prüfen Sie den Status mit „wait_for_ready“:

   apigee-service apigee-qpidd wait_for_ready

Apache ZooKeeper

ZooKeeper-Status prüfen

1. Vergewissern Sie sich, dass der ZooKeeper-Prozess ausgeführt wird. ZooKeeper schreibt eine PID-Datei in opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid.
2. Testen Sie die ZooKeeper-Ports, um sicherzustellen, dass Sie auf jedem ZooKeeper-Server eine TCP-Verbindung zu den Ports 2181 und 3888 herstellen können.
3. Prüfen Sie, ob Sie Werte aus der ZooKeeper-Datenbank lesen können. Stellen Sie eine Verbindung über eine ZooKeeper-Clientbibliothek (oder /opt/apigee/apigee-zookeeper/bin/zkCli.sh) her und lesen Sie einen Wert aus der Datenbank.
4. Prüfen Sie den Status:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper status

Vierstellige ZooKeeper-Wörter verwenden

ZooKeeper kann über eine kleine Anzahl von Befehlen (Vier-Buchstaben-Wörter) überwacht werden, die über Netcat (nc) oder Telnet an den Port 2181 gesendet werden.

Weitere Informationen zu ZooKeeper-Befehlen finden Sie in der Referenz zu Apache ZooKeeper-Befehlen.

Beispiel:

• srvr: Hier werden alle Details zum Server aufgeführt.
• stat: Hier werden kurze Details zum Server und zu den verbundenen Clients aufgeführt.

Die folgenden Befehle können an den ZooKeeper-Port gesendet werden:

1. Führen Sie den vierstelligen Befehl „ruok“ aus, um zu prüfen, ob der Server ohne Fehler ausgeführt wird. Eine erfolgreiche Antwort gibt „imok“ zurück.

   echo ruok | nc host 2181

   Liefert:

   imok

2. Führen Sie den vierstelligen Befehl stat aus, um Statistiken zur Serverleistung und zu verbundenen Clients aufzulisten:

   echo stat | nc host 2181

   Liefert:

   Zookeeper version: 3.4.5-1392090, built on 09/30/2012 17:52 GMT
   Clients:
   /0:0:0:0:0:0:0:1:33467[0](queued=0,recved=1,sent=0)
   /192.168.124.201:42388[1](queued=0,recved=8433,sent=8433)
   /192.168.124.202:42185[1](queued=0,recved=1339,sent=1347)
   /192.168.124.204:39296[1](queued=0,recved=7688,sent=7692)
   Latency min/avg/max: 0/0/128
   Received: 26144
   Sent: 26160
   Connections: 4
   Outstanding: 0
   Zxid: 0x2000002c2
   Mode: follower
   Node count: 283

3. Wenn netcat (nc) nicht verfügbar ist, können Sie Python als Alternative verwenden. Erstellen Sie eine Datei mit dem Namen zookeeper.py, die Folgendes enthält:

   import time, socket,
   sys c = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
   c.connect((sys.argv[1], 2181))
   c.send(sys.argv[2])
   time.sleep(0.1)
   print c.recv(512)

   Führen Sie nun die folgenden Python-Zeilen aus:

   python zookeeper.py 192.168.124.201 ruok
   python zookeeper.py 192.168.124.201 stat

Test auf LDAP-Ebene

Sie können OpenLDAP überwachen, um zu sehen, ob die jeweiligen Anfragen ordnungsgemäß ausgeführt werden. Mit anderen Worten: Suchen Sie nach einer bestimmten Suche, die das richtige Ergebnis zurückgibt.

1. Verwenden Sie ldapsearch (yum install openldap-clients), um den Eintrag des Systemadministrators abzufragen. Mit diesem Eintrag werden alle API-Aufrufe authentifiziert.

   ldapsearch -b "uid=admin,ou=users,ou=global,dc=apigee,dc=com" -x -W -D "cn=manager,dc=apigee,dc=com" -H ldap://localhost:10389 -LLL

   Sie werden dann aufgefordert, das LDAP-Administratorpasswort einzugeben:

   Enter LDAP Password:

   Nachdem Sie das Passwort eingegeben haben, wird eine Antwort im Formular angezeigt:

   dn:
   uid=admin,ou=users,ou=global,dc=apigee,dc=com
   objectClass: organizationalPerson
   objectClass: person
   objectClass: inetOrgPerson
   objectClass: top
   uid: admin
   cn: admin
   sn: admin
   userPassword:: e1NTSEF9bS9xbS9RbVNXSFFtUWVsU1F0c3BGL3BQMkhObFp2eDFKUytmZVE9PQ=
    =
   mail: opdk@google.com

2. Prüfen Sie mit dem folgenden Befehl, ob der Verwaltungsserver noch mit LDAP verbunden ist:

   curl -u userEMail:password http://localhost:8080/v1/users/ADMIN

   Liefert:

   {
     "emailId" : ADMIN,
     "firstName" : "admin",
     "lastName" : "admin"
   }

Sie können auch die OpenLDAP-Caches überwachen, um die Anzahl der Festplattenzugriffe zu reduzieren und so die Leistung des Systems zu verbessern. Das Monitoring und die anschließende Optimierung der Cache-Größe auf dem OpenLDAP-Server kann die Leistung des Verzeichnisservers erheblich beeinträchtigen. In den Protokolldateien (opt/apigee/var/log) finden Sie Informationen zum Cache.