基本REST APIモニタリング
The Access GatewayREST APIモニタリングエンドポイントを使用すると、Access Gatewayクラスターまたはスタンドアロンインスタンスの現在のヘルス状態を確認できます。
REST APIのモニタリングエンドポイントはデフォルトで無効になっています。詳細については、「REST APIモニタリングを管理する」 の「モニタリングの有効化/無効化」を参照してください。
リクエスト
基本的なモニタリング情報を取得するには、ノードの/basic_statusエンドポイントに対してgetリクエストを行います。
リクエストに以下を含めます。
- Host(ホスト):常にmonitoring.rest.service.oagを指定します。
次のcurlの例では、デフォルトエンドポイントを使用してノードのステータスをリクエストします。
curl -k -X GET -H "Host:monitoring.rest.service.oag" https://gw.{gateway.tld}/basic_status成功時
成功時に以下の結果が返されます。
Active connections: {total active and waiting connections} server accepts handled requests {server accepts} {handled accepts} {total requests} Reading: {reads} Writing: {writes} Waiting: {waits}次のように定義されます。
フィールド | 値 |
---|---|
Active connections(アクティブな接続数) | 待機中の接続を含む、現在のアクティブなクライアント接続数。 |
server accepts(サーバーによる受け入れ) | 受け入れたクライアント接続の総数。 |
handled(処理された接続数) | 処理された接続の総数。 通常、何らかのリソース制限に達していない限り、このパラメーター値はサーバーが処理する接続の数と同じです。 |
requests(リクエスト) | クライアントリクエストの総数。 |
Reading(参照) | Access Gatewayがリクエストヘッダーを読み込んでいる現在の接続数。 |
Writing(更新) | nginxが応答をクライアントに書き戻している現在の接続数。 |
Waiting(待機中) | リクエストを待っている現在のアイドルクライアント接続数。 |
例:
Active connections: 291 server accepts handled requests 16630948 16630948 31070465 Reading: 6 Writing: 179 Waiting: 106その他の返される結果
400 Unknown host
ステータスエンドポイントが無効になっています。
例:
<html><head><title>Access Gateway</title></head> <body> . . . <p>Status code: 400. . . The request . . . is not being served by this Access Gateway.</p> . . . </body> </html>403 Forbidden
クライアントのIPアドレスがエンドポイントへのアクセスのために許可されていません。
例:
<html><head><title>403 Forbidden</title></head> <body> . . . </body> </html>