PDF

NetCrunch データ形式について

NetCrunch は、入力、センサーの結果、外部連携の監視に複数の構造化データ形式をサポートしています。このトピックでは、ネイティブデータ形式、内部データ保存メカニズム、これらの形式を使用してシステムにデータを送信する方法について説明します。

概要

NetCrunchは、相互運用性、パフォーマンス、明瞭性を確保するために、明確に定義されたフォーマットを使用して入力データと出力データを処理します。構造化データは、ファイルベースのセンサー、テレメトリノード、APIエンドポイントを使用して送信できます。NetCrunchは内部的に、イベントログ、トレンド、ステータス、アトラス定義を保存するために専用のデータベースを使用しています。

ネイティブ入力形式

これらの形式は、データファイルセンサー、スクリプトセンサー、テレメトリノードなどのファイルベースおよびスクリプトベースのセンサーでサポートされています。

NetCrunch JSON

最も柔軟性が高く、推奨されるフォーマットです。複数のカウンターや複雑なステータスオブジェクトをメタデータとともに送信できます。


{
  "cpu.usage": 47.5,
  "disk.free": {
    "value": 13000,
    "message": "13 GB free",
    "critical": true,
    "class": "critical",
    "retain": true
  }
}

フィールド 説明
value 表示する数値またはテキスト値
message オプションの説明メッセージ
critical アラートのブール値インジケーター
class いずれかを使用できます: normal, warning, critical, unknown
retain データの自動クリアを防止するブール値
data 追加のデータ用キー値。オプションのオブジェクト

NetCrunch XML

JSONと同じスキーマですが、XMLで表現されます。レガシーシステムで役立ちます。


<values>
  <cpu.usage>47.5</cpu.usage>
  <disk.free class="critical" message="13 GB free">13000</disk.free>
</values>

NetCrunch CSV

数値カウンタ用の軽量フォーマット。キーと値のペアで使用できます。


cpu.usage,47.5
disk.free,13000

パーサーによるカスタムフォーマット

データがネイティブフォーマットでない場合は、カスタムパーサーを定義できます。

サポートされているパーサーの方法:

  • CSV解析
  • キーと値のペアの抽出
  • 正規表現
  • XPath (for XML)
  • JSONPath (for JSON)
  • JavaScript式

内部データストレージ

NetCrunchは、パフォーマンスを向上させるために、専用の内部データベースを使用しています。

データベース 説明
アトラス インメモリのトポロジーと構成モデル。定期的にXML/JSON形式で保存されます。
イベントログ ODBC経由でアクセス可能なSQLデータベース。イベント履歴を保存します。
ステータスDB インメモリNoSQLストア。現在のアラートと監視状態を記録します。
トレンドDB パフォーマンスメトリックに最適化された追加専用ストア。1日あたり数百万件のレコードを処理できます 。
DocDB ノードノートやドキュメントなどのリッチコンテンツに使用されるRocksDB。

ユースケースとフォーマットマッピング

シナリオ 推奨フォーマット
カスタムデバイス送信メトリクス JSON (Telemetry ノード または REST 経由)
B基本的なセンサースクリプト CSV または JSON
ログまたはステータスチェック class, message, retainを含む JSON
ファイルベースの統合 JSON, XML, CSV
API input カウンタまたはステータスオブジェクトを含む JSON

概要

NetCrunchは複数の構造化フォーマットをサポートし、それらをインテリジェントに解釈してカウンタの更新、アラートのトリガー、ステータスの表示を行います。最適な結果を得るには、JSONを使用し、ステータスクラスやメッセージなどの完全なメタデータを含めてください。

csvcustom parsersdata formatsintegrationjsonnetcrunch storagestatus dbtelemetrytrend dbxml