sentry-jstack

リモートセントリーからスレッドダンプを取得します。ロガーの内部動作状態などをリモートで診断する際に使用します。

コマンド属性

項目説明
コマンド種別加工クエリ
必要権限管理者
ライセンス使用量該当なし
並列実行対応
分散実行非対応

構文

sentry-jstack [timeout=INT]

オプション

timeout=INT
秒単位のRPCタイムアウト。1〜600の値を指定できます。(デフォルト: 30)

入力フィールド

フィールド型必須説明
guid文字列必須セントリー固有識別子。

出力フィールド

フィールド型説明
guid文字列セントリー固有識別子。
tidlongスレッドID。
name文字列スレッド名。
state文字列スレッド状態(RUNNABLE、BLOCKED、TIMED_WAITING、WAITING)。
stacktrace文字列スタックトレース。
_error文字列エラー発生時に元のレコードに追加されるエラーメッセージ。

エラーコード

解析エラー
エラーコードメッセージ説明
23100no sentry rpc permission管理者権限のないユーザーがコマンドを実行した場合。
23101invalid sentry rpc timeout. use timeout between 1 and 600.timeout オプション値が整数でないか、1〜600の範囲外の場合。
実行時エラー

_error フィールドを通じてエラー内容を返します。

エラーメッセージ説明
guid is null入力レコードの guid フィールド値がnullの場合。
guid should be string入力レコードの guid フィールド値が文字列でない場合。
guid should be non empty string入力レコードの guid フィールド値が空文字列の場合。
not connectedセントリーが接続状態でない場合。
timeoutRPCリクエストがタイムアウトした場合。
disconnectedRPCリクエストを送信する時点で、セントリーとの接続がすでに切断されている場合。

上記以外にも、セントリーがインストールされたシステムの状態により、他のRPC例外メッセージが返される場合があります。

説明

sentry-jstack コマンドは、入力レコードの guid フィールドを読み取り、対応するセントリーに非同期RPCメッセージを送信してスレッドダンプを取得します。

セントリーからのRPC応答メッセージを受信した順に結果を返すため、出力レコードの順序は入力レコードの順序と異なる場合があります。

非同期RPCリクエストキューの最大長はデフォルトで100であり、logpresso.core.sentry_rpc_parallel 環境変数で調整できます。

クラスター環境ですべてのデータノードの結果を一度に取得するには、sonar-sentry-jstack コマンドを使用してください。

使用例

  1. すべてのセントリーのスレッドダンプを取得

    sentry | fields guid | sentry-jstack
    

    接続されているすべてのセントリーからスレッドダンプを取得します。

変更履歴

sentry-jstack コマンドはSonar 4.0以前のバージョンから提供されています。