Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RealtimeTrendChart

RealtimeTrendChart 是可重用的 .NET Framework 4.7.2 WinForms 即時多系列走勢圖元件,不依賴任何第三方圖表套件。

包含元件

走勢圖核心(RealtimeTrendChartControl)

  • 多個 Series 以核取方塊顯示或隱藏。
  • 不同顏色折線、時間 X 軸、自動縮放 Y 軸。
  • Overlay 疊圖、DualAxis 雙 Y 軸及依 AxisGroup 分區的 Stacked 模式。
  • 滑鼠 crosshair 與同時間多系列數值提示。
  • 執行緒安全、固定容量 Ring Buffer。
  • 依畫面像素降採樣,避免歷史資料量直接放大重畫成本。
  • 背景 Provider 取樣與 UI 重畫節流。
  • CPU、Private Memory、Working Set、Managed Memory、Threads、Handles Provider。
  • 內建暫停、清除、1~60 分鐘範圍、CSV 匯出及 PNG 快照工具列。
  • Series checkbox 面板預設為兩列高度,寬度不足時自動換行;可透過 SeriesSelectorHeight 調整。

統計面板(TrendStatisticsPanel)

  • UserControl,顯示各系列的目前值、平均、最高、最低與發生時間。
  • 透過 Attach(chart) / Detach() 與 RealtimeTrendChartControl 連結,可嵌入任何 Form 或 UserControl。
  • 統計更新間隔可透過 UpdateIntervalMs 調整(預設 1000 ms)。

監控視窗(TrendMonitorForm)

  • 開箱即用的完整監控 Form:左側走勢圖 + 右側統計面板。
  • 透過 RegisterProvider(IMetricProvider) 注入自訂指標。
  • 提供 SamplingFailed 事件,讓呼叫端自行記錄錯誤。
  • TrendMonitorForm.ShowMonitor(owner) 以 Singleton 方式顯示視窗。

Debug 訊息收集(DebugMonitor / DebugMonitorForm)

  • DebugMonitor:靜態全域收集器,任意執行緒呼叫 Log(feature, category, content) 寫入。
  • DebugMonitorForm:顯示 Debug 訊息的視窗,支援功能/類別篩選、關鍵字搜尋、暫停、清除、匯出 CSV。
  • DebugMonitorForm.ShowMonitor(owner) 以 Singleton 方式顯示;DebugMonitor.IsEnabled 可查詢是否已開啟。
  • DebugMonitor.PendingCount 可做為走勢圖的 Debug Queue 深度指標。

建置

MSBuild .\RealtimeTrendChart.sln /t:Rebuild /p:Configuration=Debug "/p:Platform=Any CPU" /p:UseSharedCompilation=false

使用

僅走勢圖

var chart = new RealtimeTrendChartControl
{
    Dock = DockStyle.Fill,
    VisibleDuration = TimeSpan.FromMinutes(15),
    SamplingInterval = TimeSpan.FromSeconds(1),
    DisplayMode = TrendDisplayMode.Stacked
};
chart.RegisterProvider(new ProcessMetricProvider());
Controls.Add(chart);
chart.Start();

走勢圖 + 右側統計面板

var chart = new RealtimeTrendChartControl { Dock = DockStyle.Fill };
chart.RegisterProvider(new ProcessMetricProvider());

var stats = new TrendStatisticsPanel { Dock = DockStyle.Fill };

var split = new SplitContainer { Dock = DockStyle.Fill, Orientation = Orientation.Vertical, FixedPanel = FixedPanel.Panel2 };
split.Panel1.Controls.Add(chart);
split.Panel2.Controls.Add(stats);
Controls.Add(split);

Shown += (s, e) => { chart.Start(); stats.Attach(chart); };
FormClosed += (s, e) => { stats.Detach(); chart.Stop(); };

一行開啟完整監控視窗

// 最簡用法:Singleton
TrendMonitorForm.ShowMonitor(this);

// 加入自訂 Provider(需自行管理 instance)
var form = new TrendMonitorForm();
form.RegisterProvider(new ProcessMetricProvider());
form.RegisterProvider(new MyCustomProvider());
form.SamplingFailed += (s, e) => Logger.Error(e.Exception);
form.Show(this);

自訂資料來源

chart.AddSeries(new TrendSeriesDefinition
{
    Id = "service.queue",
    DisplayName = "Queue",
    Unit = "items",
    AxisGroup = "queue",
    LineColor = new TrendColor(30, 144, 255)
});

chart.AddPoint("service.queue", DateTime.Now, queueCount);

GetPointsSnapshot(seriesId) 會回傳與內部 Buffer 分離的唯讀快照,適合匯出或測試;呼叫端不能直接取得或修改內部集合。

GetStatisticsSnapshot() 會回傳每個 Series 的目前值、平均值、最高/最低值、對應時間與統計區間;計算時不複製完整 Buffer。

也可以不經過內建工具列直接呼叫:

using (var writer = File.CreateText("trend.csv"))
    chart.ExportCsv(writer);

using (Bitmap image = chart.RenderToBitmap(new Size(1600, 900)))
    image.Save("trend.png");

Debug 訊息收集

// 在任意執行緒記錄(視窗未開啟時自動忽略)
DebugMonitor.Log("訂單", "收到", $"OrderId={id}");

// 開啟 Debug 監控視窗
DebugMonitorForm.ShowMonitor(this);

// 查詢視窗是否已開啟
bool isOpen = DebugMonitor.IsEnabled;

// 將 Debug Queue 深度作為走勢圖指標
chart.AddPoint("debug.queue", DateTime.Now, DebugMonitor.PendingCount);

專案邊界

  • src/RealtimeTrendChart:通用元件,可複製、DLL 引用或包裝成內部 NuGet。
  • samples/RealtimeTrendChart.Demo:獨立示範程式,展示走勢圖與右側統計面板。
  • DTSX 專用 Queue 或行情指標應透過另外的 Adapter/IMetricProvider 接入,不可加入本元件。

生命週期

Control 被 Dispose 時會停止 UI Timer、背景取樣 Timer 並 Dispose 已註冊 Provider。若只暫停收集,呼叫 Stop();要保留資料但暫停刷新則呼叫 Pause()。

TrendStatisticsPanel 被 Dispose 時會自動停止內部 Timer。DebugMonitorForm 關閉時會自動呼叫 DebugMonitor.Detach()。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages