NetCrunch にデータの送信
NetCrunch にデータを送信する方法を読み、カスタム監視を作成します。NetCrunch エージェントにアプリケーションまたはスクリプトを有効にすることができます。
一般的なエージェントデータの監視センサー
任意のノードで監視センサーリストから追加できます。監視センサーの名前を設定しますと、NetCrunch にデータを送信するため、外部エージェントに必要なAPI キーを自動的に作成します。API キーは、監視センサー名(スペースなし)とノードID 番号で構成されています。例えば、JMX という名前を付けた場合、 JMX@1034 になります。
監視が必要なアプリケーションごとに、単一のノードで複数の監視センサーを追加できます。
保持時間
NetCrunch はデータが送信される頻度がわからないため、有効期限が切れたのち、メモリから消去するまでのデータの「保持時間」を指定する必要があります。
REST API
監視センサーのためのAPI を維持するために必要です。 NetCrunch に要求を送信するよう設定が可能な単純なツールは、ほとんどのプラットフォームで使用可能な cUrl オープンソースプロジェクトです。こちらで参照できます: curl.haxx.se
API は5つの要求で構成されています:
更新
POST /api/rest/1/sensors/<api-key>/update
要求データは、application/json コンテンツタイプに送信する必要があります:
例
{
"retain": 1,
"counters": {
"PBX/line status.0" : 1,
"PBX/line status.1" : 0
},
"statuses": {
"AC" : "On",
"Power: "On"
}
}
このように、単一の要求で複数のステータスとカウンタを送信できます。
カウンタ
GET /api/rest/1/sensors/<api-key>/counter?<parameter-list>
例
<nc-server-addres>/api/rest/1/sensors/<api-key>/counter?Temp=65&Wind=4&@retain=5
Counter/Inc, Counter/dec
NetCrunch がメモリにカウンタ値を保管するように、エージェントは実際の値を保管することなく、増加することができます。要求は、指定の値によってカウンタを増加または減少します。
例
<nc-server-addres>/api/rest/1/sensors/<api-key>/counter/inc?Door.Opened=-1
ステータス
GET /api/rest/1/sensors/<api-key>/status?<parameter-list>
例
<nc-server-addres>/api/rest/1/sensors/<api-key>/counter?Door=Opened&@retain=5
Web メッセージ
HTTP 要求を使用して、NetCrunch にイベントメッセージを送信できます。POST とGET 要求を受け入れます。例では、NetCrunch サーバーのWeb アクセスのURLの最初の部分をスキップしています。また、HTTPS プロトコルを使用してサーバーに設定するよう推奨します。