sentry-logger-connect

リモートセントリーの特定のロガーで収集されたログをLogpresso Sonarサーバーへ送信するよう設定します。

コマンド属性

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

構文

sentry-logger-connect [timeout=INT]

オプション

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

入力フィールド

| フィールド | 型 | 必須 | 説明 | | ---------- | -- | ---- | ---- | | guid | 文字列 | 必須 | セントリー固有識別子。 | | name | 文字列 | 必須 | セントリー名前空間内で一意のロガー名。 |

出力フィールド

| フィールド | 型 | 説明 | | ---------- | -- | ---- | | _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` フィールド値が空文字列の場合。
`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-connect コマンドは、入力レコードの guid と name フィールドを使用して対応するセントリーに非同期RPCリクエストを送信し、指定したロガーで収集されたデータをLogpresso Sonarサーバーへ送信するよう設定します。

非同期RPCリクエストキューの最大サイズはデフォルトで100であり、logpresso.core.sentry_rpc_parallel システムプロパティで変更できます。キューが満杯の場合、新しいリクエストは既存のリクエストが完了またはタイムアウトするまで待機します。

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

使用例

Linuxセントリーにwtmpロガーを作成してログ送信を設定

sentry
| search os == "Linux" and is_connected
| eval name = "wtmp_linux"
| eval factory_name = "wtmp"
| eval configs = dict("path", "/var/log/wtmp", "server", "linux", "dst_ip", remote_ip)
| fields guid, name, factory_name, configs
| sentry-logger-create
| sentry-logger-connect

接続されているすべてのLinuxセントリーにwtmpロガーを作成し、ログをサーバーへ送信するよう設定します。