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

モニタリング方法

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

概要

Edge では、サービスの詳細情報の取得や、そのステータスの確認を行う複数の方法がサポートされています。次の表に、対象サービスごとに実行できるチェックの種類を示します。

		Management API
コンポーネント	メモリ使用量 [JMX^*]	サービスの確認	ユーザー/組織/ デプロイステータス	axstatus	データベースチェック	`apigee-service` ステータス	`apigee-monit`**
Management Server
Message Processor
ルーター
QPD
Postgres
	詳細	詳細	詳細	詳細	詳細	詳細	詳細
^{* JMX を使用するには、その前に JMX を有効にするの手順に沿って JMX を有効にする必要があります。} ^{** apigee-monit サービスは、コンポーネントが起動しているかどうかを検査し、起動していない場合は再起動を試みます。詳細については、apigee-monit による自己修復をご覧ください。}

ポートと構成ファイルのモニタリング

Java Management Extensions（JMX）と Management API のモニタリング呼び出しに使用されるポートは、コンポーネントごとに異なります。次の表に、それぞれの種類のサーバーで使用される JMX と Management API のポートと、構成ファイルの場所を示します。

コンポーネント	JMX ポート	Management API ポート	構成ファイルの場所
管理サーバー	1099	8080	`$APIGEE_ROOT/customer/application/management-server.properties`
Message Processor	1101	8082	`$APIGEE_ROOT/customer/application/message-processor.properties`
ルーター	1100	8081	`$APIGEE_ROOT/customer/application/router.properties`
QPD	1102	8083	`$APIGEE_ROOT/customer/application/qpid-server.properties`
Postgres	1103	8084	`$APIGEE_ROOT/customer/application/postgres-server.properties`

JMX を使用してコンポーネントをモニタリングする

以降のセクションでは、JMX を使用して Edge コンポーネントをモニタリングする方法について説明します。

JMX を有効にする

認証や SSL ベースの通信を使用せずに JMX を有効にするには、次の手順を行います。注: 本番環境システムでは、セキュリティを確保するために暗号化認証と SSL の両方を有効にしてください。

適切な構成ファイル（構成ファイルリファレンスを参照）を編集します。構成ファイルが存在しない場合は作成します。
```
conf_system_jmxremote_enable=true
```
構成ファイルを保存して、ファイルの所有者が apigee:apigee であることを確認します。
該当する Edge コンポーネントを再起動します。
```
apigee-service edge-management-server restart
```

JMX を無効にするには、conf_system_jmxremote_enable プロパティを削除するか、その値を false に変更します。次に、該当する Edge コンポーネントを再起動します。

JMX での認証

Edge for Private Cloud では、ファイルに保存された情報を使用した、パスワードに基づく認証がサポートされています。セキュリティを強化するために、パスワードをハッシュとして保存できます。

edge-* コンポーネントで JMX 認証を有効にするには、適切な構成ファイル（構成ファイルリファレンスを参照）を編集します。構成ファイルが存在しない場合は作成します。
```
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
```
構成ファイルを保存して、ファイルの所有者が apigee:apigee であることを確認します。
パスワードの SHA256 ハッシュを作成します。
```
echo -n '' | openssl dgst -sha256
```
JMX ユーザー認証情報を記載した jmxremote.password ファイルを作成します。
1. 次のファイルを $JAVA_HOME ディレクトリから /opt/apigee/customer/application/<component>/ ディレクトリにコピーします。
```
cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/management-server/jmxremote.password
```
2. ファイルを編集し、次の構文を使用して JMX のユーザー名とパスワードを追加します。
```
USERNAME <HASH-PASSWORD>
```
3. ファイルの所有者を apigee に設定し、ファイルのモードを 400 にします。
```
chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.password
```
JMX ユーザー権限を持つ jmxremote.access ファイルを作成します。
1. $JAVA_HOME ディレクトリ内にある次のファイルを /opt/apigee/customer/application/<component>/ ディレクトリにコピーします。
```
cp ${JAVA_HOME}/lib/management/jmxremote.access$APIGEE_ROOT/customer/application/management-server/jmxremote.password/jmxremote.access
```
2. ファイルを編集し、JMX のユーザー名を追加して、その後に権限を追加します（READONLY/READWRITE）
```
USERNAME READONLY
```
3. ファイルの所有者を apigee に設定し、ファイルのモードを 400 にします。
```
chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password

chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.access
```
適切な Edge コンポーネントを再起動します。
```
apigee-service edge-management-server restart
```

JMX 認証を無効にするには、conf_system_jmxremote_authenticate プロパティを削除するか、その値を false に変更して適切な Edge コンポーネントを再起動します。

JMX での SSL

edge-* コンポーネントで SSL ベースの JMX を有効にするには:

適切な構成ファイル（構成ファイルリファレンスを参照）を編集します。構成ファイルが存在しない場合は作成します。
```
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>
```
構成ファイルを保存して、ファイルの所有者が apigee:apigee であることを確認します。
サーバーキーを含むキーストアを準備し、構成 conf_system_javax_net_ssl_keystore で指定されたパスに配置します。apigee:apigee がキーストアファイルを読み取れるようにします。
適切な Edge コンポーネントを再起動します。
```
apigee-service edge-management-server restart
```

SSL ベースの JMX を無効にするには、conf_system_jmxremote_ssl プロパティを削除するか、その値を false に変更します。適切な Edge コンポーネントを再起動します。

JConsole でのモニタリング

JConsole でのモニタリング手順は、https://docs.apigee.com/private-cloud/v4.50.00/how-monitor#jconsole で説明されている手順と同じままです。

「JMX で SSL が有効になっている場合は、トラストストアとトラストストアパスワードを使用して JConsole を起動する必要があります」という 1 行を追加できます。参照: https://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html

JConsole でモニタリングする

JConsole（JMX 準拠ツール）を使用して、ヘルスチェックとプロセス統計を管理し、モニタリングします。JConsole では、サーバーで公開された JMX 統計情報を使用し、グラフィカルインターフェースに表示できます。詳細については、JConsole の使用をご覧ください。

JMX で SSL が有効になっている場合は、トラストストアとトラストストアパスワードを使用して JConsole を起動する必要があります。 JConsole の使用をご覧ください。

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

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

ここで

IP_address は、モニタリングするサーバーの IP アドレスです。
port_number は、モニタリングするサーバーの JMX ポート番号です。

たとえば、Management Server をモニタリングするには、次のようなコマンドを実行します（サーバーの IP アドレスが 216.3.128.12 の場合）。

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

この例では、Management Server の JMX のポート「1099」を指定しています。他のポートについては、JMX と Management API のモニタリングポートをご覧ください。

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

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

構成ファイルリファレンス

以降のセクションでは、JMX 関連の構成を行う際に Edge コンポーネント構成ファイルに加える変更について説明します。詳細については、ポートと構成ファイルのモニタリングをご覧ください。

適切なコンポーネントの構成ファイルに追加する JMX 構成

エッジコンポーネントで JMX エージェントを有効にします。デフォルトは false です。
```
conf_system_jmxremote_enable=true
```

パスワードベースの認証の構成

パスワードに基づく認証を有効にする。デフォルトは false です。
```
conf_system_jmxremote_authenticate=true
```
アクセスファイルのパス。このファイルは Apigee ユーザーが所有して、他のユーザーは読み取れないようにする必要があります。
```
conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
```
パスワードファイルのパス。このファイルは Apigee ユーザーが所有して、他のユーザーは読み取れないようにする必要があります。
```
conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password
```
パスワードを暗号化形式で保存できるようにします。デフォルトは false です。
```
conf_system_jmxremote_encrypted_auth=true
```

SSL ベースの JMX の構成

JMX 通信に対して SSL を有効にする。デフォルトは false です。
```
conf_system_jmxremote_ssl=true
```
キーストアへのパス。このファイルは Apigee ユーザーが所有して、他のユーザーは読み取れないようにする必要があります。
```
conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
```

キーストアパスワード:

conf_system_javax_net_ssl_keystorepassword=changeme

オプションの JMX 構成

以下にデフォルト値を記載します。これらのデフォルト値は変更できます。

JMX ポート。デフォルト値は以下の表に記載されています。
```
conf_system_jmxremote_port=
```
JMX RMI ポート。デフォルトでは、Java プロセスでランダムにポートが選択されます。
```
conf_system_jmxremote_rmi_port=
```
リモートスタブのホスト名。localhost のデフォルト IP アドレス。
```
conf_system_java_rmi_server_hostname=
```
JMX レジストリを SSL で保護する。デフォルトは false です。SSL が有効にされている場合にのみ適用されます。
```
conf_system_jmxremote_registry_ssl=false
```

Management API でモニタリングする

Edge には、サーバー上でサービスチェックを行い、ユーザー、組織、デプロイをチェックするために使用できる API がいくつか用意されています。このセクションでは、これらの API について説明します。

サービスチェックを実行する

Management API には、サービスの問題をモニタリングし、診断するためのエンドポイントがいくつか用意されています。これらのエンドポイントには、次のものがあります。

エンドポイント説明

エンドポイント	説明
`/servers/self/up`	サービスが実行されているかどうかを確認します。この API 呼び出しでは、認証する必要はありません。サービスが実行されている場合、このエンドポイントは次のレスポンスを返します。 <ServerField> <Up>true</Up> </ServerField> サービスが実行されていない場合は、次のようなレスポンスが返されます（使用するサービスと確認方法によって異なります）。 curl: Failed connect to localhost:`port_number`; Connection refused
`/servers/self`	次のようなサービスに関する情報を返します。構成プロパティ開始時間と開始時間ビルド、RPM、UUID 情報内部および外部のホスト名と IP アドレスリージョンと Pod サービスが実行されているかどうかを示す `<isUp>` プロパティこの API 呼び出しでは、Apigee 管理者の認証情報を使用して認証を行う必要があります。

/servers/self/up

サービスが実行されているかどうかを確認します。この API 呼び出しでは、認証する必要はありません。

サービスが実行されている場合、このエンドポイントは次のレスポンスを返します。

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

サービスが実行されていない場合は、次のようなレスポンスが返されます（使用するサービスと確認方法によって異なります）。

curl: Failed connect to localhost:port_number; Connection refused

/servers/self

次のようなサービスに関する情報を返します。

構成プロパティ
開始時間と開始時間
ビルド、RPM、UUID 情報
内部および外部のホスト名と IP アドレス
リージョンと Pod
サービスが実行されているかどうかを示す <isUp> プロパティ

この API 呼び出しでは、Apigee 管理者の認証情報を使用して認証を行う必要があります。

これらのエンドポイントを使用するには、次の構文を使用するコマンドを使用して、curl などのユーティリティを呼び出します。

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]"

ここで

host は、検査するサーバーの IP アドレスです。サーバーにログインしている場合は、「localhost」を使用できます。ログインしていない場合は、サーバーの IP アドレスとユーザー名、パスワードを指定します。
port_number は、検査するサーバーの Management API ポートです。これは、コンポーネントのタイプごとに異なるポートです。たとえば、Management Server の Management API ポートは 8080 です。使用する Management API ポート番号の一覧については、JMX と Management API のモニタリングポートをご覧ください。

レスポンスの形式を変更するには、Accept ヘッダーを「application/json」または「application/xml」として指定します。

次の例では、localhost の Router のステータス（ポート 8081）を取得します。

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

次の例では、216.3.128.12（ポート 8082）で Message Processor に関する情報を取得します。

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

ユーザー、組織、デプロイのステータスをモニタリングする

Management API を使用して次のコマンドを実行すると、Management Server と Message Processor でプロキシのユーザー、組織、デプロイのステータスをモニタリングできます。

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

port_number は、Management Server の場合は 8080、Message Processor の場合は 8082 です。

この呼び出しを行うには、システム管理者のユーザー名とパスワードで認証を行う必要があります。

サーバーはすべての呼び出しに対して「デプロイ済み」ステータスを返します。失敗した場合は、次の手順を行います。

サーバーログにエラーがないか確認します。ログは次の場所にあります。
- Management Server: opt/apigee/var/log/edge-management-server
- Message Processor: opt/apigee/var/log/edge-message-processor
サーバーを呼び出して、正しく機能しているかどうかを確認します。
サーバーを ELB から削除した後、再起動します。
```
/opt/apigee/apigee-service/bin/apigee-service service_name restart
```
ここで、service_name は次のようになります。
- edge-management-server
- edge-message-processor

`apigee-service` コマンドでステータスを確認する

Edge Service のトラブルシューティングを行うには、サービスを実行しているサーバーにログインしているときに、apigee-service コマンドを使用します。

apigee-service でサービスのステータスを確認するには:

サーバーにログインし、次のコマンドを実行します。
```
/opt/apigee/apigee-service/bin/apigee-service service_name status
```
ここで、service_name は次のいずれかです。
- Management Server: edge-management-server
- Message Processor: edge-message-processor
- Postgres: edge-postgres-server
- Qpid: edge-qpid-server
- ルーター: edge-router
次に例を示します。
```
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor status
```
サービスが実行されていない場合は、サービスを起動します。
```
/opt/apigee/apigee-service/bin/apigee-service service_name start
```
サービスを再起動したら、上記の apigee-service status コマンドを使用するか、Management API でモニタリングするで説明した Management API を使用して、サービスが正常に機能していることを確認します。
次に例を示します。
```
curl -v http://localhost:port_number/v1/servers/self/up
```
port_number は、サービスの Management API ポートです。

この例では、サーバーにログインしており、ホスト名に "localhost" を使用できることを前提としています。Management API を使用してリモートでステータスを確認するには、サーバーの IP アドレスを指定し、システム管理者のユーザー名とパスワードを API 呼び出しに含める必要があります。

Postgres のモニタリング

Postgres は、ステータスを確認するために使用できるいくつかのユーティリティをサポートしています。以降のセクションで、このユーティリティについて説明します。

Postgres の組織と環境を確認する

次の curl コマンドを実行すると、Postgres Server にオンボーディングされている組織名と環境名を確認できます。

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

組織と環境の名前が表示されます。

分析のステータスを確認する

Postgres と Qpid の分析サーバーのステータスを確認するには、次の curl コマンドを実行します。

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

次の例に示すように、すべての分析サーバーに成功ステータスが表示されます。

{
  "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 データベース

このセクションでは、Postgres データベースのモニタリングに特に使用できる手法について説明します。

`check_postgres.pl` スクリプトを使用する

PostgreSQL データベースをモニタリングするには、標準のモニタリングスクリプトである check_postgres.pl を使用します。詳しくは、http://bucardo.org/wiki/Check_postgres をご覧ください。

スクリプトを実行する前に:

各 Postgres ノードに check_postgres.pl スクリプトをインストールする必要があります。
高解像度アラーム、スリープ、gettimeofday、インターバルタイマーを実装する Perl モジュールである perl-Time-HiRes.x86_64 がインストールされていることを確認します。たとえば、次のコマンドを使用してインストールできます。
```
yum install perl-Time-HiRes.x86_64
```
CentOS 7: CentOS v7 で check_postgres.pl を使用する前に、perl-Data-Dumper.x86_64 RPM をインストールします。

check_postgres.pl の出力

check_postgres.pl を使用した API 呼び出しのデフォルト出力は、Nagios と互換性があります。スクリプトをインストールしたら、以下の点を確認します。

データベースのサイズを確認します。

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'

データベースへの受信接続数を確認し、最大許容接続数と比較します。
```
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends
```

データベースが実行中で、使用可能かどうかを確認します。

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

ディスク容量を確認します。

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

Postgres ノードにオンボーディングされている組織と環境の数を確認します。

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

データベースチェックを実行する

適切なテーブルが PostgresSQL データベースに作成されていることを確認します。次のコマンドを使用して PostgreSQL データベースにログインします。

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

次のコマンドを実行します。

\d analytics."org.env.fact"

postgres プロセスのヘルスステータスを確認する

Postgres マシンで API チェックを実行するには、次の curl コマンドを実行します。

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

このコマンドは、postgres プロセスがアクティブな場合に ACTIVE ステータスを返します。Postgres プロセスが稼働していない場合は、INACTIVE ステータスが返されます。

Postgres リソース

Postgres サービスのモニタリングの詳細については、以下をご覧ください。

Apache Cassandra

Cassandra では JMX がデフォルトで有効になっており、リモートの JMX では Cassandra へのアクセスにパスワードは必要ありません。

Cassandra の JMX 認証を有効にする

Cassandra の JMX 認証を有効にできます。その後、nodetool ユーティリティを呼び出すたびにユーザー名とパスワードを渡す必要があります。

Cassandra の JMX 認証を有効にするには:

cassandra.properties ファイルを作成して編集します。
1. /opt/apigee/customer/application/cassandra.properties ファイルを編集します。ファイルが存在しない場合は作成します。
2. ファイルに以下を追加します。
```
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. cassandra.properties ファイルを保存します。
4. 次の例に示すように、ファイルの所有者を apigee:apigee に変更します。
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
プロパティファイルを使用したトークンの設定について詳しくは、Edge の構成方法をご覧ください。
jmx_auth.sh を作成して編集します。
1. 次の場所にファイルを作成します（
```
/opt/apigee/customer/application/jmx_auth.sh
```
  ）。
2. ファイルに次のプロパティを追加します。
```
export CASS_JMX_USERNAME=JMX_USERNAME
export CASS_JMX_PASSWORD=JMX_PASSWORD
```
3. jmx_auth.sh ファイルを保存します。
4. ファイルのソース:
```
source /opt/apigee/customer/application/jmx_auth.sh
```
jmxremote.password ファイルをコピーして編集します。
1. 次のファイルを $JAVA_HOME ディレクトリから /opt/apigee/customer/application/apigee-cassandra/ にコピーします。
```
cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password
```
2. jmxremote.password ファイルを編集して、次の構文を使用して JMX のユーザー名とパスワードを追加します。
```
JMX_USERNAME JMX_PASSWORD
```
  ここで、JMX_USERNAME と JMX_PASSWORD は、以前に設定した JMX のユーザー名とパスワードです。
3. ファイルの所有者を「apigee」に設定し、ファイルのモードを 400 にします。
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
```
jmxremote.access ファイルをコピーして編集します。
1. 次のファイルを $JAVA_HOME ディレクトリから /opt/apigee/customer/application/apigee-cassandra/ にコピーします。
```
cp ${JAVA_HOME}/lib/management/jmxremote.access
$APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.access
```
2. jmxremote.access ファイルを編集して、次のロールを追加します。
```
JMX_USERNAME readwrite
```
3. ファイルの所有者を「apigee」に設定し、ファイルのモードを 400 にします。
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
```

Cassandra で configure を実行します。

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

Cassandra を再起動します。

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

このプロセスを他のすべての Cassandra ノードで繰り返します。

JMX のパスワード暗号化を有効にする

JMX のパスワード暗号化を有効にする手順は次のとおりです。

source/conf/casssandra-env.sh ファイルを開きます。
cassandra.properties ファイルを作成して編集します。
1. /opt/apigee/customer/application/cassandra.properties ファイルを編集します。ファイルが存在しない場合は作成します。
2. ファイルに以下を追加します。
```
conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true
```
3. cassandra.properties ファイルを保存します。
4. 次の例に示すように、ファイルの所有者を apigee:apigee に変更します。
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
コマンドラインで「echo -n 'Secret' | openssl dgst -sha1」と入力して、目的のパスワードの SHA1 ハッシュを生成します。
前のセクションで作成した $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password のユーザー名に対応するパスワードを設定します。

Cassandra で構成を実行:

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

Cassandra を再起動します。

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

このプロセスを他のすべての Cassandra ノードで繰り返します。

Cassandra 用に SSL を使用する JMX を有効にする

SSL を使用する JMX を有効にすると、Cassandra との JMX ベースの通信でセキュリティと暗号化が強化されます。SSL を使用する JMX を有効にするには、Cassandra が SSL ベースの JMX 接続を受け入れるように、鍵と証明書を Cassandra に提供する必要があります。また、nodetool（および JMX を介して Cassandra と通信する他のすべてのツール）を SSL 用に構成する必要があります。

SSL 対応の JMX では、平文パスワードと暗号化パスワードの両方がサポートされます。

Cassandra 用に SSL を使用する JMX を有効にする手順は次のとおりです。

JMX を有効にします。必要に応じて、パスワードの暗号化を有効にします。
Cassandra の JMX 認証を有効にします。。構成されたユーザー名とパスワードを使用して nodetool が機能することを確認します。
```
/opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring
```
キーストアとトラストストアを準備する。
- キーストアには鍵と証明書を入れておきます。Cassandra サーバーを構成するときにこれが使用されます。キーストアに複数の鍵ペアが含まれている場合、Cassandra は最初の鍵ペアを使用して SSL を有効にします。
  
  キーストアと鍵のパスワードを同じにする必要があります（keytool を使って鍵を生成するときにはデフォルトでそのように設定されます）。
- トラストストアには証明書のみを入れておきます。クライアント（apigee-service ベースのコマンドまたは nodetool）はこれを使用して JMX 経由で接続します。
上記の要件を確認した後、次の手順を行います。
1. キーストアファイルを /opt/apigee/customer/application/apigee-cassandra/ に配置します。
2. 「
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/keystore.node1
chmod 400 /opt/apigee/customer/application/apigee-cassandra/keystore.node1
```
  」と入力して、Apigee ユーザーのみがキーストアファイルを読み取れるようにします。
SSL を使用する JMX に対応するように Cassandra を構成するには、次の手順を行います。
1. 「
```
apigee-service apigee-cassandra stop
```
  」と入力して Cassandra ノードを停止します。
2. Cassandra で SSL を有効にするには、ファイル /opt/apigee/customer/application/cassandra.properties を開いて次の行を追加します。
```
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
```
3. 次の例に示すように、ファイルの所有者を apigee:apigee に変更します。
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
4. Cassandra で構成を実行します。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
```
5. Cassandra を再起動します。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
```
6. このプロセスを他のすべての Cassandra ノードで繰り返します。
7. 「
```
apigee-service apigee-cassandra start
```
  」と入力して Cassandra ノードを起動します。
apigee-service Cassandra コマンドを構成します。 apigee-service コマンドを実行するときには、特定の環境変数を設定する必要があります。そのいくつかを次に示します。
```
apigee-service apigee-cassandra stop
apigee-service apigee-cassandra wait_for_ready
apigee-service apigee-cassandra ring
apigee-service apigee-cassandra backup
```
JMX 認証と SSL に対応するように apigee-service を構成するには、いくつかの方法があります。便利さやセキュリティ対策を考慮して、オプションを 1 つ選択してください。
オプション 1（SSL 引数をファイルに保存する）

次の環境変数を設定します。
```
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
```
Apigee ユーザーのホームディレクトリ（/opt/apigee）にファイルを作成します。
```
$HOME/.cassandra/nodetool-ssl.properties
```
ファイルを編集し、次の行を追加します。
```
-Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true
```
Apigee ユーザーがトラストストアファイルを確実に読み取れるようにしてください。

次の apigee-service コマンドを実行します。エラーなしで実行される場合、構成は正常です。
```
apigee-service apigee-cassandra ring
```
オプション 2（SSL 引数を環境変数に格納）

次の環境変数を設定します。
```
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=<path-to-trustore.node1>
export CASS_JMX_TRUSTSTORE_PASSWORD=<truststore-password>
```
次の apigee-service コマンドを実行します。エラーなしで実行される場合、構成は正常です。
```
apigee-service apigee-cassandra ring
```
オプション 3（SSL 引数を apigee-service に直接渡す）

次のような apigee-service コマンドを実行します。環境変数を構成する必要はありません。
```
CASS_JMX_USERNAME=ADMIN CASS_JMX_PASSWORD=PASSWORD CASS_JMX_SSL=Y CASS_JMX_TRUSTSTORE=<path-to-trustore.node1> CASS_JMX_TRUSTSTORE_PASSWORD=<trustore-password> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring
```
nodetool を設定します。Nodetool には JMX パラメータを渡す必要があります。以下の構成オプションで説明するように、SSL 対応の JMX で動作するように nodetool を構成する方法が 2 つあります。
- 構成オプション 1
- 構成オプション 2
このオプションでは、SSL 関連の構成が nodetool に渡される方法が異なります。どちらの場合も、nodetool を実行するユーザーは、トラストストアファイルに対する READ 権限を持っている必要があります。便利さやセキュリティ対策を考慮して、適切なオプションを選択してください。

nodetool パラメータの詳細については、 DataStax のドキュメントをご覧ください。

構成オプション 1

nodetool を実行するユーザーのホームディレクトリにファイルを作成します。
```
$HOME/.cassandra/nodetool-ssl.properties
```
このファイルに次の行を追加します。
```
-Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true
```
nodetool を実行するすべてのユーザーが上記のトラストストアパスにアクセスできるようにする必要があります。

--ssl オプションを指定して nodetool を実行します。
```
/opt/apigee/apigee-cassandra/bin/nodetool --ssl -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring
```
構成オプション 2

以下の追加のパラメータを使用して、単一のコマンドとして nodetool を実行します。
```
/opt/apigee/apigee-cassandra/bin/nodetool -Djavax.net.ssl.trustStore=<path-to-truststore.node1> -Djavax.net.ssl.trustStorePassword=<truststore-password> -Dcom.sun.management.jmxremote.registry.ssl=true -Dssl.enable=true -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring
```

SSL 構成を元に戻す

上記の手順で説明した SSL 構成を元に戻す必要がある場合は、次の手順を行います。

「
```
apigee-service apigee-cassandra stop
```
」と入力して apigee-cassandra を停止します。
ファイル /opt/apigee/customer/application/cassandra.properties から行 conf_cassandra-env_com.sun.management.jmxremote.ssl=true を削除します。

/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”

次のコマンドを入力して apigee-cassandra を開始します。

apigee-service apigee-cassandra start

環境変数 CASS_JMX_SSL が設定されている場合は、それを削除します。
```
unset CASS_JMX_SSL
```
ring、stop、backup などの apigee-service ベースのコマンドが機能していることを確認します。
nodetool で --ssl スイッチの使用を停止します。

Cassandra の JMX 認証を無効にする

Cassandra の JMX 認証を無効にするには:

/opt/apigee/customer/application/cassandra.properties を編集します。

ファイルから次の行を削除します。

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

Cassandra で構成を実行します。

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

Cassandra を再起動します。

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

このプロセスを他のすべての Cassandra ノードで繰り返します。

JConsole の使用: タスク統計をモニタリングする

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

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

ここで、IP_address は Cassandra サーバーの IP です。

Cassandra JMX の統計

JMX MBeans	JMX 属性
ColumnFamilies/apprepo/environments ColumnFamilies/apprepo/organizations ColumnFamilies/apprepo/apiproxy_revisions ColumnFamilies/apprepo/apiproxies 列ファミリー/監査/監査 ColumnFamilies/audit/audits_ref	保留中のタスク
	メモリ列数
	メモリテーブルのデータサイズ
	読み取り数
	最近の読み取りのレイテンシ（マイクロ秒）
	合計読み取りレイテンシマイクロ
	WriteCount
	最近の書き込みレイテンシのマイクロ
	合計書き込みレイテンシマイクロ
	合計ディスク使用量
	LiveDiskSpace が使用されている
	LiveSSTableCount
	BloomFilterFalsePositives
	最近の BloomFilterFalseRatio
	BloomFilterFalseRatio

nodetool でクラスタノードを管理する

nodetool ユーティリティは、クラスタノードを管理する Cassandra 用のコマンドラインインターフェースです。このユーティリティは /opt/apigee/apigee-cassandra/bin にあります。

次の呼び出しは、すべての Cassandra クラスタノードで行うことができます。

一般的なリング情報（単一の Cassandra ノードでも可能）: すべてのノードで「Up」と「Normal」を探します。

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

ユーザー名とパスワードを渡す必要があるのは、Cassandra 用に JMX 認証を有効にした場合のみです。

上記のコマンドの出力は次のようになります。

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

ノードに関する一般的な情報（ノードあたりの呼び出し）

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

上記のコマンドの出力は次のようになります。

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

thrift サーバーのステータス（サービングクライアント API）
```
nodetool [-u username -pw password] -h localhost statusthrift
```
上記のコマンドの出力は次のようになります。
```
running
```

データストリーミングオペレーションのステータス: cassandra ノードのトラフィックを確認します。

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

上記のコマンドの出力は次のようになります。

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

nodetool の詳細については、nodetool ユーティリティについてをご覧ください。

Cassandra のリソース

http://www.datastax.com/docs/1.0/operations/monitoring をご覧ください。

Apache ZooKeeper

ZooKeeper のステータスを確認する

ZooKeeper プロセスが実行されていることを確認します。ZooKeeper が PID ファイルを opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid に書き込みます。
ZooKeeper ポートをテストして、すべての ZooKeeper サーバーのポート 2181 および 3888 との TCP 接続を確立できることを確認します。
ZooKeeper データベースから値を読み取れるようにします。ZooKeeper クライアントライブラリ（/opt/apigee/apigee-zookeeper/bin/zkCli.sh）を使用して接続し、データベースから値を読み取ります。

ステータスを確認します。

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

ZooKeeper の 4 文字コマンドを使用する

netcat（nc）または telnet を使用してポート 2181 に小さなコマンドセット（4 文字コマンド）を送ることで、ZooKeeper をモニタリングできます。

ZooKeeper コマンドの詳細については、Apache ZooKeeper コマンドリファレンスをご覧ください。

次に例を示します。

srvr: サーバーの詳細を一覧表示します。
stat: サーバーと接続済みクライアントの詳細情報を表示します。

ZooKeeper ポートに次のコマンドを発行できます。

4 文字のコマンド ruok を実行して、サーバーがエラー以外の状態で実行されているかどうかをテストします。成功すると、「imok」が返されます。
```
echo ruok | nc host 2181
```
戻り値:
```
imok
```

4 文字コマンド stat を実行して、サーバーのパフォーマンスと接続しているクライアントの統計情報を一覧表示します。

echo stat | nc host 2181

戻り値:

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

netcat（nc）を使用できない場合は、代わりに python を使用できます。次のファイルを含む zookeeper.py という名前のファイルを作成します。

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)

次の Python 行を実行します。

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

LDAP レベルのテスト

OpenLDAP をモニタリングして、特定のリクエストが正しく処理されているかどうかを確認できます。つまり、正しい検索結果が返される特定の検索を探します。

ldapsearch（yum install openldap-clients）を使用して、システム管理者のエントリをクエリします。このエントリは、すべての API 呼び出しの認証に使用されます。

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

次に、LDAP 管理者のパスワードの入力を求められます。

Enter LDAP Password:

パスワードを入力すると、次の形式のレスポンスが表示されます。

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

次のコマンドを使用して、Management Server が LDAP に接続されているかどうかを確認します。

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

戻り値:

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

また、OpenLDAP キャッシュをモニタリングしてディスクアクセスの数を減らすと、システムのパフォーマンスを改善できます。OpenLDAP サーバーのキャッシュサイズのモニタリングと調整は、ディレクトリサーバーのパフォーマンスに大きな影響を与える可能性があります。ログファイル（opt/apigee/var/log）を表示して、キャッシュに関する情報を取得できます。

モニタリング方法

概要

ポートと構成ファイルのモニタリング

JMX を使用してコンポーネントをモニタリングする

JMX を有効にする

JMX での認証

JMX での SSL

JConsole でのモニタリング

JConsole でモニタリングする

構成ファイル リファレンス

適切なコンポーネントの構成ファイルに追加する JMX 構成

パスワード ベースの認証の構成

SSL ベースの JMX の構成

オプションの JMX 構成

Management API でモニタリングする

サービス チェックを実行する

ユーザー、組織、デプロイのステータスをモニタリングする

apigee-service コマンドでステータスを確認する

Postgres のモニタリング

Postgres の組織と環境を確認する

分析のステータスを確認する

PostgreSQL データベース

check_postgres.pl スクリプトを使用する

データベース チェックを実行する

postgres プロセスのヘルスステータスを確認する

Postgres リソース

Apache Cassandra

Cassandra の JMX 認証を有効にする

JMX のパスワード暗号化を有効にする

Cassandra 用に SSL を使用する JMX を有効にする

オプション 1（SSL 引数をファイルに保存する）

オプション 2（SSL 引数を環境変数に格納）

オプション 3（SSL 引数を apigee-service に直接渡す）

構成オプション 1

構成オプション 2

SSL 構成を元に戻す

Cassandra の JMX 認証を無効にする

JConsole の使用: タスク統計をモニタリングする

Cassandra JMX の統計

nodetool でクラスタノードを管理する

Cassandra のリソース

Apache ZooKeeper

ZooKeeper のステータスを確認する

ZooKeeper の 4 文字コマンドを使用する

LDAP レベルのテスト

構成ファイルリファレンス

パスワードベースの認証の構成

サービスチェックを実行する

`apigee-service` コマンドでステータスを確認する

`check_postgres.pl` スクリプトを使用する

データベースチェックを実行する

オプション 3（SSL 引数を `apigee-service` に直接渡す）