Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

モニタリング方法

Edge for Private Cloud v. 4.17.01

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

JMX の有効化

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

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

コンポーネント	JMX ポート	ファイル
管理サーバー	1099	/opt/apigee/edge-management-server/bin/start
Message Processor	1101	/opt/apigee/edge-mesage-processor/bin/start
Qpid	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 認証を有効にするには、各コンポーネントに change_jmx_auth アクションがあります。これを使用して、認証の有効化/無効化と JMX 認証情報の設定を行います。

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

>  /opt/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=username
- JMX_ENABLED=y/n
- JMX_PASSWORD=password（設定されていない場合、または -p で渡されていない場合は、入力を求められます）

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

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

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

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

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

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

> /opt/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 属性（MBean）をモニタリングします。

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

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

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

JMX MBean	JMX 属性
メモリ	HeapMemoryUsage
	NonHeapMemoryUsage
	用途
注: 属性値は、committed、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 のリクエストに応答できません。

トラブルシューティング

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

Edge Application の使用 - ユーザー、組織、デプロイのチェック

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

すべての呼び出しで「deployed」ステータスが表示されます。これらが失敗した場合は、次の操作を行います。

Management Server のログ（opt/apigee/var/log/edge-management-server）でエラーを確認します。
Management Server に対して呼び出しを行い、正常に機能しているかどうかを確認します。
ELB からサーバーを削除し、Management Server を再起動します。
/opt/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 のリクエストに応答できません。