Edge for Private Cloud v. 4.16.09
本番環境では一般に、Apigee Edge for Private Cloud デプロイメント内でモニタリングのメカニズムを有効にする必要があります。これらのモニタリング技術により、ネットワーク管理者（またはオペレーター）にエラーまたは障害が警告されます。生成されたすべてのエラーは、 Apigee Edge でアラートを確認できます。アラートの詳細については、モニタリングのベスト プラクティスをご覧ください。
わかりやすいように、Apigee コンポーネントは、主に次の 2 つのカテゴリに分類されます。
- Apigee 固有の Java サーバー サービス – これには管理が含まれます。 Server、Message Processor、Qpid Server、Postgres Server です。
- サードパーティ サービス - Nginx Router、Apache Cassandra、Apache ZooKeeper、OpenLDAP、PostgreSQL データベース、Qpid がこれに該当します。
次の表に、Apigee Edge のオンプレミス デプロイメントでモニタリングできるパラメータの一覧を示します。
|
コンポーネント |
システム チェック |
プロセスレベルの統計 |
API レベルのチェック |
メッセージ フロー チェック |
コンポーネント固有 |
|
|---|---|---|---|---|---|---|
|
Apigee 固有の Java サービス |
管理サーバー |
? |
? |
? |
||
|
Message Processor |
? |
? |
? |
? |
||
|
Qpid サーバー |
? |
? |
? |
|||
|
Postgres サーバー |
? |
? |
? |
|||
|
サードパーティのサービス |
Apache Cassandra |
? |
? |
|||
|
Apache ZooKeeper |
? |
? |
||||
|
OpenLDAP |
? |
? |
||||
|
PostgreSQL データベース |
? |
? |
||||
|
Qpid |
? |
? |
||||
|
Nginx ルーター |
? |
? |
? |
|||
一般に、Apigee Edge をインストールした後、次のモニタリングを実行できます。 Apigee Edge for Private Cloud インストールのパフォーマンスを追跡できます。
システムのヘルスチェック
全体的な CPU 使用率、メモリ使用率、接続性などのシステムヘルス パラメータを測定することは非常に重要です。次のパラメータをモニタリングして、 システムの健全性の基本を把握します。
- CPU 使用率 - CPU 使用率に関する基本的な統計情報（ユーザー / システム / IO 待機 / アイドル）を示します。たとえば、システムによって使用されている CPU の総量など。
- Free/Used Memory – システムメモリの使用率をバイト単位で指定します。 たとえば、システムで使用される物理メモリなどです。
- ディスク使用状況 - 現在のディスク使用状況に基づいてファイル システムの情報を示します。たとえば、システムによって使用されているハードディスクの量など。
- Load Average: 読み込みを待機しているプロセスの数を指定します。 表示されます。
- Network Statistics – 送信されたネットワーク パケットおよび/またはバイト数 特定のコンポーネントに関する送信エラーが表示されます。
プロセス/アプリケーションのチェック
プロセスレベルでは、実行中のすべてのプロセスに関する できます。これには、プロセスまたはアプリケーションが使用するメモリと CPU の使用率の統計情報などが含まれます。qpidd、postgres postmaster、java などのプロセスについては、 次のとおりです。
- プロセス識別: 特定の Apigee プロセスを識別します。たとえば Apigee サーバーの Java プロセスの存在をモニタリングできます。
- スレッドの統計情報: プロセスが基盤となるスレッド パターンを表示します。 あります。たとえば、すべてのプロセスのピークスレッド数、スレッド数をモニタリングできます。
- メモリ使用量: すべての Apigee プロセスのメモリ使用量を表示します。 たとえば、ヒープメモリの使用量、ヒープ以外のメモリ使用量などのパラメータをモニタリングできます。 できます。
API レベルのチェック
API レベルでは、よく使用される API のサーバーが稼働中かどうかをモニタリングできます。 Apigee によってプロキシされる呼び出し。たとえば、管理サーバー、ルーター、 Message Processor 用の次の cURL コマンドを呼び出します。
curl http://<host>:<port>/v1/servers/self/up
ここで、<host> は IP このアドレスです。<port> 番号は Edge コンポーネントによって異なります。例:
管理サーバー: 8080
- ルーター: 8081
- Message Processor: 8082
- その他
各コンポーネントでこのコマンドを実行する方法については、以下の個別のセクションをご覧ください。
この呼び出しは「true」を返します。「false」に設定します。最良の結果を得るには、API 呼び出しを発行して （Apigee ソフトウェアとやり取りする）バックエンドに直接付与することで、 エラーが Apigee ソフトウェア環境内に存在するかバックエンドに存在するかを示します。
注: API プロキシをモニタリングするには、Apigee の API Health も使用できます。API Health により、API プロキシに対するスケジュールされた呼び出しが行われ、いつどのように失敗したかが通知されます。呼び出しが成功すると API Health はレスポンス時間を表示し、レスポンスのレイテンシが高いときに通知することもできます。API Health は、世界中のさまざまな場所から呼び出しを行い、API の動作を比較できます。 あります。
メッセージ フローのチェック
Router と Message Processor からメッセージ フローに関するデータを収集できる パターン/統計。これにより、以下をモニタリングできます。
- アクティブなクライアントの数
- レスポンスの数（10X、20X、30X、40X、50X）
- 接続の失敗
これにより、API メッセージ フロー用のダッシュボードを提供できます。
Message Processor の Router ヘルスチェック
Router では、どの Message Processor が期待どおりに動作しているかを判断するヘルスチェックのメカニズムが実装されます。ある Message Processor のダウンまたは処理速度の低下が検出された場合、Router はその Message Processor を自動的にローテーションから外すことができます。その場合は、「Mark Down」というメッセージが Router のログファイル（/<inst root>/apigee4/var/log/apigee/router/logs/system.log）に書き込まれます。
Router ログファイルでこれらのメッセージをモニタリングできます。たとえば、ルーターが Message Processor はローテーションから外れると、次の形式でメッセージがログに書き込まれます。
2014-05-06 15:51:52,159 org: env: RPCClientClientProtocolChildGroup-RPC-0 INFO CLUSTER - ServerState.setState() : State of 2a8a0e0c-3619-416f-b037-8a42e7ad4577 is now DISCONNECTED. handle = <MP_IP> at 1399409512159 2014-04-17 12:54:48,512 org: env: nioEventLoopGroup-2-2 INFO HEARTBEAT - HBTracker.gotResponse() : No HeartBeat detected from /<MP_IP>:<PORT> Mark Down
ここで、/<MP_IP>:<PORT> は IP アドレスとポート番号です。 Message Processor のコンポーネントです
その後、Router がヘルスチェックを実行し、Message Processor が 正常に機能すると、Router は Message Processor を自動的にローテーションに戻します。「 Router は「Mark Up」トークンを次の形式のログにメッセージを追加します。
2014-05-06 16:07:29,054 org: env: RPCClientClientProtocolChildGroup-RPC-0 INFO CLUSTER - ServerState.setState() : State of 2a8a0e0c-3619-416f-b037-8a42e7ad4577 is now CONNECTED. handle = <IP> at 1399410449054 2014-04-17 12:55:06,064 org: env: nioEventLoopGroup-4-1 INFO HEARTBEAT - HBTracker.updateHB() : HeartBeat detected from /<IP>:<PORT> Mark Up
ヘルスチェックを行うように Router を構成するには、/<inst で次のプロパティを true に設定します。 root>/apigee4/conf/apigee/router/router.properties:
Client.pool.heartBeat.use.http=true
次に、Router を再起動します。
> /<inst-root>/apigee4/bin/apigee-service router restart