Documentation
Table of Contents
5 ユーザーパラメーター
概要
窜补产产颈虫にあらかじめ定义されていないエージェントチェックを実行したい场合があります。
このような场合、ユーザパラメータが役に立ちます。
必要なデータを取得するコマンドを作成し、そのデータをユーザパラメータとしてagent configuration file('UserParameter') という设定パラメータを作成します。
ユーザパラメータは次のような构文になります。
このように、ユーザパラメータにはキーも含まれます。キーは、item を设定する際に必要となります。
参照しやすい任意のキーを入力します(ホスト内で一意でなければなりません)。
agent を再起動するか、agent runtime control オプションを使用して、新しいパラメータを取得します。
次に、configuring an itemの际に、実行したいユーザパラメータからコマンドを参照するためのキーを入力します。
ユーザパラメータとは、龙虎赌博 agent が実行するコマンドのことです。item のプリプロセスステップの前に
最大512碍叠のデータを返すことができます。ただし、最终的にデータベースに保存できるテキスト値は、
惭测厂蚕尝では64碍叠に制限されていることに注意してください。
(他のデータベースについては、tableを参照してください)。
UNIX オペレーティングシステムでは、コマンドラインインタプリタとして /bin/sh が使用されます。
ユーザーパラメータはエージェントチェックのタイムアウトに従います。タイムアウトに达すると
フォークされたユーザーパラメータ?プロセスが终了します。
こちらもご覧ください。
- ユーザーパラメータを利用するための Step-by-step tutorial
- Command execution
単纯なユーザーパラメータの例
単纯なコマンド:
agent は、'ping' キーを持つ item に対して常に '1' を返します。
より复雑な例:
agent は、MySQL サーバが生きている場合は '1' を、そうでない場合は '0' を返します。
フレキシブルユーザーパラメータ
フレキシブルユーザーパラメータは、キーでパラメータを受け取ります。
このように、フレキシブルユーザーパラメータは、複数の item を作成するためのベースとなることができます。
フレキシブルユーザーパラメーターの构文は以下の通りです。
| パラメータ | 説明 |
|---|---|
| Key | Unique item key. The [*] defines that this key accepts parameters within the brackets. Parameters are given when configuring the item. |
| Command | Command to be executed to evaluate value of the key. For flexible user parameters only: You may use positional references $1…$9 in the command to refer to the respective parameter in the item key. 龙虎赌博 parses the parameters enclosed in [ ] of the item key and substitutes $1,...,$9 in the command accordingly. $0 will be substituted by the original command (prior to expansion of $0,...,$9) to be run. Positional references are interpreted regardless of whether they are enclosed between double (") or single (') quotes. To use positional references unaltered, specify a double dollar sign - for example, awk '{print $$2}'. In this case $$2 will actually turn into $2 when executing the command. |
龙虎赌博 agent では、柔軟なユーザパラメータの場合のみ、$記号を含む位置参照が検索され、置換されます。
シンプルなユーザパラメータでは、このような参照処理はスキップされるため、$记号の引用は必要ありません。
デフォルトでは、ユーザパラメータに特定のシンボルを使用することはできません。 全リストは UnsafeUserParameters ドキュメントを参照してください。
例1
とてもシンプルなもの:
辫颈苍驳摆蝉辞尘别迟丑颈苍驳闭というフォーマットを持つ监视项目は无制限に定义することができる。
- ping[0] - 常に '0' を戻す
- ping[aaa] - 常に 'aaa' を戻す
例2
もっとセンスを磨こう!
このパラメータは、惭测厂蚕尝データベースの可用性を监视するために使用することができます。
ユーザー名とパスワードを渡すことができます:
例3
正规表现にマッチする行はファイル中に何行あるか？
このパラメータは、ファイル内の行数を计算するために使用することができます。
コマンドの结果
コマンドの戻り値は、标準出力と标準エラー出力です。
標準エラー出力の場合、テキスト（文字、ログ、テキスト型情報）item は未サポ―トになりません。
テキスト（文字、ログ、テキスト型情报）を返すユーザーパラメータは、空白を返すことができます。
無効な結果を返した場合、そのitem は サポートされなくなります。