RealtimeTrendChart 是可重用的 .NET Framework 4.7.2 WinForms 即時多系列走勢圖元件,不依賴任何第三方圖表套件。
- 多個 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調整。
- UserControl,顯示各系列的目前值、平均、最高、最低與發生時間。
- 透過
Attach(chart)/Detach()與RealtimeTrendChartControl連結,可嵌入任何 Form 或 UserControl。 - 統計更新間隔可透過
UpdateIntervalMs調整(預設 1000 ms)。
- 開箱即用的完整監控 Form:左側走勢圖 + 右側統計面板。
- 透過
RegisterProvider(IMetricProvider)注入自訂指標。 - 提供
SamplingFailed事件,讓呼叫端自行記錄錯誤。 TrendMonitorForm.ShowMonitor(owner)以 Singleton 方式顯示視窗。
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=falsevar 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");// 在任意執行緒記錄(視窗未開啟時自動忽略)
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()。