レポートと JSON エクスポート

すべてのSentinelコマンドは、daemonコマンドがコレクターを実行している場合を除き、デーモンキャッシュを読み取ります。

コマンド

コマンド	出力
simaai-sentinel	インタラクティブな5分割画面によるターミナル操作の表示。
simaai-sentinel table	現在の値、単位、およびしきい値の状態とともに、常に最新の情報に更新される指標テーブル。
simaai-sentinel table --once	ログに適したテーブルのスナップショットを1つ。
simaai-sentinel export	フォーマットされたキャッシュドキュメントを完成させてください。JSON
simaai-sentinel sensors	メトリック名、グループ、単位、閾値、およびコレクターが提供する説明。
simaai-sentinel status	Sentinelのバージョン、キャッシュのタイムスタンプ、最新のサンプル取得時刻/経過時間、履歴サイズ、メトリックの数、および最上位レベルのデーモンエラー。

デフォルト以外のキャッシュを読み書きするには、--cache PATHを使用します。UI/テーブルの更新間隔は、表示にのみ影響します。daemon --interval SECは、システムの通常のキャッシュ更新間隔を変更します。PMBus、温度、およびプロセスコレクターは、それぞれ独自の更新間隔を維持します。

ドキュメントをキャッシュする

simaai-sentinel export は、この最上位レベルの構造を出力します。

フィールド	意味
schema	キャッシュスキーマのバージョン。現在は1です。
version	キャッシュを書き込んだときの、Sentinel パッケージのバージョン。
updated_at	キャッシュペイロードが書き込まれたときのUTC時間。
metrics	デーモンが起動したときに利用可能なすべてのメトリクスの定義。
latest	最新のキャッシュサンプル、またはサンプルが存在する前にnull。
samples	時系列順にリングバッファーの履歴を保持します。
processes	最新のプロセススナップショット。5秒ごとに更新されます。
power	電源コレクターのステータスと、レールごとのカウンター、または、古いまたは互換性のないキャッシュの場合はnull。
errors	最上位レベルのデーモンメッセージ。通常、電源レールに関するエラーは、power.last_error に記録されます。

メトリックの定義

各metricsのエントリには、以下の情報が含まれます。

フィールド	意味
key	Sample.valuesで使用される、安定した機械可読形式の名前。
label	人が読みやすい長い名前。
short	コンパクトな UI/テーブル ラベル。
group	サブシステムカテゴリ。
unit	表示ユニット。
description	収集者が提供した測定結果の概要。
warn	オプションの警告閾値。
critical	オプションの重要閾値。

消費者は、ラベルや配列の位置ではなく、key を使用して、サンプル値を定義に紐付ける必要があります。

サンプル

各サンプルには、以下のものが含まれています。

• timestamp：UTC タイムスタンプ（データの収集/キャッシュ日時）。
• values：メトリックキーと数値、またはnullとの対応関係。

null は、コレクターが有限の値を生成しなかったことを意味します。これをゼロとして解釈してはなりません。サブシステムが構成されていない場合、キーが存在しないこともあります。たとえば、/media/nvme がデーモン起動時にマウントされなかった場合などです。

処理記録

各プロセスのレコードには、pid、name、cpu_pct、rss_mb、およびオプションのcpu_coreが含まれます。計算および選択の制限については、システムパネルを参照してください。

電源状態

powerオブジェクトには、以下のものが含まれます。

フィールド	意味
profile	検出されたレールプロファイルは、modalix_somやmodalix_dvtなどです。
sample_interval_ms	PMBus のサンプリング間隔を設定しました。
duration_seconds	電力の蓄積を開始してからの経過時間。
valid_samples	少なくとも1つのレールで正常にパスした場合。
failed_samples	いずれのレールも正常に通過しませんでした。
last_sample_valid	最新のPMBusパスで、少なくとも1つのレールが読み取られたかどうか。
last_error	最新の実行で失敗したレールに関する、エラーメッセージをまとめたもの、またはnull。
rails	レールごとのラベル、メトリックキー、前回成功時のワット数、成功したサンプルの数、およびエラーの数。

これらのフィールドを自動比較に使用する前に、Power panelを確認してください。部分的なレール読み取りは、全体の比較可能性に影響を与えます。

原子性と保持性

デーモンは一時ファイルを書き込み、その内容をフラッシュし、キャッシュ上にその名前を変更します。そのため、読み取り側は、以前の完全なペイロードまたは新しい完全なペイロードのいずれかを確認できます。キャッシュは、現在の状態と短い履歴を示すレポートであり、永続的な監査ログではありません。永続的な証拠が必要な場合は、外部にエクスポートしてください。