sentry-logger-set-interval

リモートセントリーの特定のロガーの収集インターバルを変更します。

コマンド属性

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

構文

sentry-logger-set-interval [timeout=INT]

オプション

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

入力フィールド

| フィールド | 型 | 必須 | 説明 | | ---------- | -- | ---- | ---- | | guid | 文字列 | 必須 | セントリー固有識別子。 | | name | 文字列 | 必須 | セントリー名前空間内で一意のロガー名。 | | interval | integer | 必須 | ミリ秒単位の収集インターバル。 |

出力フィールド

| フィールド | 型 | 説明 | | ---------- | -- | ---- | | _error | 文字列 | エラー発生時に元のレコードに追加されるエラーメッセージ。処理成功時はこのフィールドは存在しません。 |

_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` フィールド値が空文字列の場合。
interval should be not null	入力レコードの `interval` フィールド値がnullの場合。
interval should be integer	入力レコードの `interval` フィールド値が整数でない場合。
not connected	指定されたセントリーが接続状態でない場合。
timeout	RPCリクエストがタイムアウトした場合。
disconnected	RPCリクエスト処理中に接続が切断された場合。

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

エラーコード

解析エラー

エラーコード	メッセージ	説明
23100	No permission to call sentry RPC.	管理者権限のないセッションからコマンドが実行された場合。
23101	Invalid sentry RPC timeout option value. Use a value between 1 and 600.	`timeout` オプション値が整数でないか、1〜600の範囲外の場合。

実行時エラー

該当なし

説明

sentry-logger-set-interval コマンドは、入力レコードの guid、name、interval フィールドを使用して対応するセントリーに非同期RPCリクエストを送信し、指定したロガーの収集インターバルを変更します。

非同期RPCリクエストキューの最大サイズはデフォルトで100であり、logpresso.core.sentry_rpc_parallel システムプロパティで変更できます。

結果はRPC応答を受信した順に出力されるため、出力レコードの順序は入力レコードの順序と異なる場合があります。

使用例

指定した名前のロガーの収集インターバルを5秒に変更
```
sentry
| sentry-loggers
| search name == "wtmp_linux"
| eval interval = 5000
| sentry-logger-set-interval
```
接続されているすべてのセントリーで、指定した名前のロガーの収集インターバルを5秒（5,000ms）に変更します。