sentry-jstack
リモートセントリーからスレッドダンプを取得します。ロガーの内部動作状態などをリモートで診断する際に使用します。
コマンド属性
| 項目 | 説明 |
|---|---|
| コマンド種別 | 加工クエリ |
| 必要権限 | 管理者 |
| ライセンス使用量 | 該当なし |
| 並列実行 | 対応 |
| 分散実行 | 非対応 |
構文
オプション
timeout=INT- 秒単位のRPCタイムアウト。1〜600の値を指定できます。（デフォルト:
30）
入力フィールド
| フィールド | 型 | 必須 | 説明 | | ---------- | -- | ---- | ---- | | guid | 文字列 | 必須 | セントリー固有識別子。 |
出力フィールド
| フィールド | 型 | 説明 |
| ---------- | -- | ---- |
| guid | 文字列 | セントリー固有識別子。 |
| tid | long | スレッドID。 |
| name | 文字列 | スレッド名。 |
| state | 文字列 | スレッド状態（RUNNABLE、BLOCKED、TIMED_WAITING、WAITING）。 |
| stacktrace | 文字列 | スタックトレース。 |
| _error | 文字列 | エラー発生時に元のレコードに追加されるエラーメッセージ。 |
エラーコード
解析エラー
| エラーコード | メッセージ | 説明 |
|---|---|---|
| 23100 | No permission to call sentry RPC. | 管理者権限のないユーザーがコマンドを実行した場合。 |
| 23101 | Invalid sentry RPC timeout option value. Use a value 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 | セントリーが接続状態でない場合。 |
| timeout | RPCリクエストがタイムアウトした場合。 |
| disconnected | RPCリクエスト処理中に接続が切断された場合。 |
上記以外にも、セントリーがインストールされたシステムの状態により、他のRPC例外メッセージが返される場合があります。
説明
sentry-jstack コマンドは、入力レコードの guid フィールドを読み取り、対応するセントリーに非同期RPCメッセージを送信してスレッドダンプを取得します。
セントリーからのRPC応答メッセージを受信した順に結果を返すため、出力レコードの順序は入力レコードの順序と異なる場合があります。
非同期RPCリクエストキューの最大長はデフォルトで100であり、logpresso.core.sentry_rpc_parallel 環境変数で調整できます。
クラスター環境ですべてのデータノードの結果を一度に取得するには、sonar-sentry-jstack コマンドを使用してください。
使用例
-
すべてのセントリーのスレッドダンプを取得
sentry | fields guid | sentry-jstack接続されているすべてのセントリーからスレッドダンプを取得します。