PDF

テレメトリノード

テレメトリノードは、RESTまたは OTLP経由で外部システムからメトリック、ステータス、イベントを受信するためのNetCrunchノードタイプです。クラウド、IoT、カスタムシステムのテレメトリデータをアンカーし、イベント対応設計に置き換えられたノードです。

概要

NetCrunchでは、全ての監視オブジェクトをノードに紐付ける必要があります。テレメトリノードは、外部のメトリクス、ステータス、イベントを取り込むために特別に設計されており、ポーリングできない、または直接ネットワーク外にあるワークロードやデバイス（クラウド、スクリプト、IoT、組み込み機器など）に最適です。

一般的な用途:

  • リモートシステムまたは組み込みシステム
  • クラウドアプリケーションとAPI
  • IoT/ヘッドレスデバイス
  • テレメトリをプッシュするアプリ/スクリプト

テレメトリノードの追加方法

  1. NetCrunch UI上部の追加 (+) ボタンをクリックします
  2. ポップアップメニューで、
    監視 → Telemetryノード (ラベルは”Telemetryレシーバー”と表示される場合もあります)を選択します
  3. 任意のノード名を入力し、表示オプションを選択します
  4. NetCrunchでは nodeId を割り当て、デフォルトのテレメトリセンサー (sensorId) を作成します。

センサーは常に作成され、削除はできず、無効化のみ可能です。

ノードタイプの移行

  • RESTレシーバーのノードタイプは廃止され、テレメトリノードに置き換えられました
  • テレメトリノード:
    • イベントの取り込みをサポート
    • sensorIdをメイン識別子として使用します（nodeId のみではありません）
    • センサーは自動的に追加されます (無効化は可能ですが、削除はできません)
    • 従来の REST レシーバーは引き続き動作しますが、テレメトリノードに置き換えられます

サポートされている入力プロトコル

プロトコル エンドポイントタイプ データフォーマット
REST (JSON) ローカル/ クラウド REST NetCrunch JSON
OTLP OTLPゲートウェイ OpenTelemetry (HTTP/gRPC)

全てのデータはテレメトリノードセンサー (nodeId + sensorId)にルーティングされます

REST エンドポイント

  • ローカルREST:
    https://<nc-server>/api/rest/1/sensors/<sensorId>@<nodeId>/update
  • クラウドREST:
    https://gw.netcrunch.io/tm/v1/<serverId>@<sensorId>@<nodeId>/update

ペイロードの例


{
  "counters": { "system/cpu.load": 0.75 },
  "statuses": {
    "uptime": {
      "value": "ok",
      "data": { "statusCode": 1 },
      "message": "System running for 3 days"
    }
  }
}

OTLP ゲートウェイ (OpenTelemetry)

  • メトリクス:
    https://otlp.netcrunch.io/v1/<serverId>@<sensorId>@<nodeId>/metrics
  • ログ:
    https://otlp.netcrunch.io/v1/<serverId>@<sensorId>@<nodeId>/logs
アスペクト REST エンドポイント OTLP ゲートウェイ
フォーマット NetCrunch JSON OTLP メトリクス/ログ
プロトコル HTTPS (JSON) HTTP/HTTPS (OTLP JSON/Binary)
URL gw.netcrunch.io otlp.netcrunch.io
処理 直接取り込み 内部形式に変換

注釈

  • トレースはサポートされていません
  • ログ = 非アクティブなアラート。 メトリクス = カウンタ
  • ヒストグラムのサポートを予定しています

イベント取り込みエンドポイント: テレメトリノード vs Webメッセージセンサー

重要 テレメトリノードのイベント送信エンドポイントは、従来のWebメッセージセンサーとは異なります。間違ったエンドポイントを使用すると、イベントは処理されません。

テレメトリノードのイベントエンドポイント

テレメトリノードの場合、イベントはセンサーエンドポイントに送信する必要があります。

https://<nc-server>/api/rest/1/sensors/<sensorId>/event

  • イベントは、テレメトリノード用に作成された特定のセンサー (sensorId) にリンクされます
  • 全てのテレメトリノードのイベントアラートが機能するために必要です

Webメッセージセンサー (レガシー) イベントエンドポイント

レガシーWebメッセージセンサー（非テレメトリ）の場合、イベントは ノード エンドポイント に送信する必要があります:

https://<nc-server>/api/rest/1/node/<nodeId>/event

  • イベントはノード(nodeId)に直接リンクされます

重要な理由

  • テレメトリノードは、sensorIdでイベントを受け取ります
  • Webメッセージセンサー は、nodeIdでイベントを受け取ります

テレメトリノードのイベントをnode/<nodeId>/eventエンドポイントに送信しても、イベントは処理されません

クイックリファレンス

ノードタイプ 適切なエンドポイント
テレメトリノード https://<nc-server>/api/rest/1/sensors/<sensorId>/event
Webメッセージセンサー https://<nc-server>/api/rest/1/node/<nodeId>/event

テレメトリノードには常に sensorId エンドポイントを使用してください。従来の Web メッセージセンサーには nodeId のみを使用してください。

データの送信 – 例

クラウドRESTアップデート


curl -X POST https://gw.netcrunch.io/tm/v1/SRV-1@sensor42@node91/update \
  -H "Content-Type: application/json" \
  -d '{"counters":{"system/disk.freeMB":12800},"statuses":{"system/fan":{"value":"ok","message":"normal"}}}'

ローカルRESTイベント


curl -X POST https://<nc-server>/api/rest/1/sensors/sensor42/event \
  -H "Content-Type: application/json" \
  -d '{"message": "failed login"}'

  • イベントフィールド: message, description, attributes (ユーザー、時間などの追加パラメータ)

イベントアラート

  • イベントアラートは、イベントフィールドによるフィルタリングをサポートしています
  • Empty filter = match all.

空のフィルターは全てのイベントに一致します。テレメトリノードセンサーとWebメッセージセンサーの両方に適用されます。

ノードの動作と監視

  • テレメトリノードは、全ての受信メトリック、ステータス、イベントをアンカーします
  • ダッシュボード、アラート、履歴データをサポートします
  • 監視パックとポリシーを受信できます
  • トポロジービューに表示されます (非表示の場合は除く)

概要

テレメトリノードは、プッシュベースの可観測性モデルを提供します。リモート/クラウド/IoTデータに最適で、堅牢なRESTおよびOTLPサポートと直接イベントの取り込み機能を備えています。これにより、外部システムやサーバーレスシステムとNetCrunch監視の統合が簡素化されます。

event endpointnetcrunchobservabilityotlp gatewaypush monitoringreceiver noderemote metricsrest apisensor updatetelemetry node