基本REST APIモニタリング
The Access GatewayREST APIモニタリングエンドポイントを使用すると、Access Gatewayクラスターまたはスタンドアロンインスタンスの現在のヘルス状態を確認できます。
注:
REST APIのモニタリングエンドポイントはデフォルトで無効になっています。詳細については、「REST APIモニタリングを管理する」 の「モニタリングの有効化/無効化」を参照してください。
Request
基本的なモニタリング情報を取得するには、ノードの/basic_statusエンドポイントに対してgetリクエストを行います。
リクエストに以下を含めます。
Host: Always 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>
関連項目