sentry-logger-configs
リモートセントリーのロガー設定を取得します。
コマンド属性
| 項目 | 説明 |
|---|---|
| コマンド種別 | 加工クエリ |
| 必要権限 | 管理者 |
| ライセンス使用量 | 該当なし |
| 並列実行 | 対応 |
| 分散実行 | 非対応 |
構文
sentry-logger-configs [timeout=INT]
オプション
timeout=INT- 秒単位のRPCタイムアウト。1〜600の値を指定できます。(デフォルト:
30)
入力フィールド
| フィールド | 型 | 必須 | 説明 | | ---------- | -- | ---- | ---- | | guid | 文字列 | 必須 | セントリー固有識別子。 | | name | 文字列 | 必須 | セントリー名前空間内で一意のロガー名。 |
出力フィールド
| フィールド | 型 | 説明 | | ---------- | -- | ---- | | configs | object | 収集設定のキーと値のペア。 | | _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 フィールド値が空文字列の場合。 |
| name should be not null | 入力レコードの name フィールド値がnullの場合。 |
| name should be string | 入力レコードの name フィールド値が文字列でない場合。 |
| name should be non empty string | 入力レコードの name フィールド値が空文字列の場合。 |
| not connected | セントリーが接続状態でない場合。 |
| timeout | RPCリクエストがタイムアウトした場合。 |
| disconnected | RPCリクエスト処理中に接続が切断された場合。 |
上記以外にも、セントリーがインストールされたシステムの状態により、他のRPC例外メッセージが返される場合があります。
説明
sentry-logger-configs コマンドは、入力レコードの guid と name フィールドを使用して対応するセントリーに非同期RPCメッセージを送信し、ロガーの設定を取得します。
セントリーからのRPC応答メッセージを受信した順に結果を返すため、出力レコードの順序は入力レコードの順序と異なる場合があります。
非同期RPCリクエストキューの最大長はデフォルトで100であり、logpresso.core.sentry_rpc_parallel 環境変数で調整できます。
使用例
-
すべてのセントリーのロガー設定を取得
sentry | fields guid | sentry-loggers | sentry-logger-configs接続されているすべてのセントリーの全ロガーの設定を取得します。