このページは Cloud Translation API によって翻訳されました。

モニタリング方法

Edge for Private Cloud v4.16.09

このドキュメントでは、Apigee Edge のオンプレミスデプロイメントでサポートされているコンポーネントのモニタリング方法について説明します。

JMX の有効化

JMX は Cassandra ではデフォルトで有効になっており、他のすべての Edge コンポーネントではデフォルトで無効になっています。したがって、JMX をコンポーネントごとに有効にする必要があります。

各コンポーネントは異なるポートで JMX をサポートします。次の表に、JMX ポートと、そのポートで JMX を有効にするように変更するファイルを示します。

コンポーネント	JMX ポート	File
管理サーバー	1099	/opt/apigee/edge-management-server/bin/start
Message Processor	1101	/opt/apigee/edge-mesage-processor/bin/start
QPD	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

たとえば、Management Server で JMX を有効にするには、エディタで /opt/apigee/edge-management-server/bin/start を開きます。Management Server の起動に使用される次の行が表示されます。

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

この行を編集して、以下を追加します。

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

この行では、Management Server の JMX ポート番号を 1099 に指定しています。上記の表で定義されているように、各コンポーネントのポート番号を設定します。次に例を示します。

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

ファイルを保存してから、コンポーネントを再起動します。たとえば、Management Server を再起動するには、次のコマンドを実行します。

> /opt/apigee/apigee-service/bin/ apigee-service edge-management-server restart

JMX 認証を有効にして JMX パスワードを設定する

Management Server、Message Processor、Qpid、Postgres のモニタリングプロセスでは JMX が使用されます。JMX はデフォルトで有効になっており、リモートの JMX アクセスではパスワードは必要ありません。

JMX 認証を有効にするために、各コンポーネントには認証の有効化と無効化、および JMX 認証情報の設定に使用する change_jmx_auth アクションがあります。

JMX 認証を有効にするには、次のコマンドを使用します。

>  /<inst_root>/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

ここで

comp は、edge-management-server、edge-message-processor、edge-qpid-server、または edge-postgres-server のいずれかです。
以下のオプションがあります。
- -u: ユーザー名
- -p: パスワード
- -e: y（有効化）または n（可変）
構成ファイルには次の内容が含まれています。
- JMX_USERNAME=ユーザー名
- JMX_ENABLED=y/n
- （JMX_PASSWORD=パスワード）-（-p で設定しないか渡さない場合、プロンプトが表示されます）

たとえば、コマンドラインでオプションを使用するには、次のようにします。

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

構成ファイルがある場合:

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

複数のノードで Edge を実行している場合は、すべてのノードで同じユーザー名とパスワードを指定してこのコマンドを実行します。

後で JMX 認証を無効にするには、次のコマンドを使用します。

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

管理サーバー

JConsole を使用してシステムのヘルスチェックとプロセス情報をモニタリングする

JConsole（JMX 準拠ツール）を使用して、ヘルスチェックとプロセス統計を管理し、モニタリングします。JConsole を使用すると、Management Server（または任意のサーバー）によって公開された JMX 統計情報をグラフィカルインターフェースで使用できます。JConsole の使用の詳細については、http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html をご覧ください。

JConsole と次のサービス URL を使用して、JMX 経由で提供される JMX 属性（MBeans）をモニタリングします。

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/platform

ここで、<ip address> は Management Server（またはそれぞれのサーバー）の IP アドレスです。デフォルトでは、Management Server のポートは 1099 です。

次の表に、一般的な JMX の統計情報を示します。

JMX MBeans	JMX 属性
メモリ	HeapMemoryUsage
	NonHeapMemoryUsage
	使用状況
注: 属性値は、commit、init、max、used の 4 つの値で表示されます。

Edge Application API チェックを使用する

Management Server（または任意のサーバー）で API チェックを行うには、次の CURL コマンドを実行します。

curl http://<host>:8080/v1/servers/self/up

ここで、<host> は Management Server の IP アドレスです。

この呼び出しは、「true」と「false」を返します。true の場合、ノードは稼働しており、Java サービスが実行されています。

HTTP 200（OK）レスポンスを受信しない場合、Edge はポート 8080 リクエストに応答できません。

トラブルシューティング

サーバーにログインして、次のコマンドを実行します。
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server status
サービスが実行されていない場合は、サービスを起動します。
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server start

Edge アプリケーションの使用 - ユーザー、組織、デプロイに関するチェック

Management Server は、オンプレミスの各インストールで他のすべてのパッケージを接続する際に重要な役割を果たします。Management Server でユーザー、組織、デプロイのステータスを確認するには、次のコマンドを実行します。

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

すべての呼び出しに対して「デプロイ済み」ステータスが表示されます。失敗した場合は、次の操作を行います。

Management Server のログ（<inst_root>/apigee/var/log/edge-management-server）でエラーを確認します。
Management Server に対して呼び出しを行い、適切に機能しているかどうかを確認します。
サーバーを ELB から削除した後、Management Server を再起動します。
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart

ルーター

次の CURL コマンドを呼び出すと、Router（または任意のサーバー）で API チェックを実行できます。

curl http://<host>:8081/v1/servers/self/up

ここで、host は Router の IP アドレスです。

この呼び出しは、「true」と「false」を返します。true の場合、ノードは稼働しており、Router サービスは実行中です。

HTTP 200（OK）レスポンスを受信しない場合、Edge はポート 8081 リクエストに応答できません。