GETメソッド
説明
次の表のリクエストを受け付けるとスナップショットログを収集し,レスポンスとして出力します。
項目 |
値 |
---|---|
Method |
GET |
URL |
/api/v1/snapshot |
パラメタ |
「表17-2 スナップショットログ収集REST APIのパラメタ」に示すパラメタと値 |
形式
http://<IPアドレス>:<ポート番号>/api/v1/snapshot
<IPアドレス>にはTomcatプロセスモニタを起動させているマシンのIPアドレスを指定してください。<ポート番号>には,TomcatプロセスモニタのHTTP機能の受付ポート番号(monitor.rest.portの値の指定値)と同じ値を指定してください。
monitor.rest.portについては,「12.2.4(2) Tomcatプロセスモニタに関するプロパティ」を参照してください。
パラメタ
スナップショットログ収集REST APIのパラメタを次の表に示します。
パラメタ |
指定できる値 |
省略の可否 |
デフォルト値 |
説明 |
---|---|---|---|---|
threaddumpnum |
0〜60 |
省略可 |
<snapshot.rest.default.threaddumpnum※の指定値> |
スレッドダンプ情報を取得する回数を指定します。取得するとTomcatサーバプロセスに負荷が掛かります。 スレッドダンプ情報については,「11.3.2(1)(b) スレッドダンプ情報」を参照してください。 |
watchcommand |
次のどちらかを指定します。
|
省略可 |
<snapshot.rest.default.watchcommand.enabled※の指定値> |
モニタリング情報を取得するかどうかを指定します。取得すると所要時間が長くなります。 モニタリング情報については,「11.3.2(1)(a) モニタリング情報」を参照してください。 |
実行例
リクエストの例を次に示します。
-
デフォルト値で収集
/api/v1/snapshot
-
オプションを指定して収集
/api/v1/snapshot?threaddumpnum=3&watchcommand=true
戻り値
正常時
スナップショットログの収集に成功した場合,レスポンスボディに出力されるスナップショットログ(zip形式)を次の表に示します。
項目 |
値 |
---|---|
Status |
200 |
Content-Type |
application/zip |
Body |
<スナップショットログ(zip形式)> |
異常時
スナップショットログの収集に失敗した場合に出力されるエラーメッセージ(JSON形式)を次の表に示します。
項目 |
値 |
---|---|
Status |
400 |
Content-Type |
application/json |
Body |
{ "message": "<メッセージKDLR10016-E>" } |
項目 |
値 |
---|---|
Status |
500 |
Content-Type |
application/json |
Body |
{ "message": "<メッセージKDLR10017-E>" } |