Day 3 - 日志、指标与诊断包

建议用时：150-210 分钟

你将学会什么

现场报错时拿不到调试器。诊断包必须包含版本、配置摘要、日志、系统信息和通信统计，但不能泄漏密码。今天的 3 个例子都要亲手敲，不能只复制，也不能只看运行结果。

标为 Program.cs 的最小例子可以放进控制台练习项目；标为 Service、ViewModel、XAML 或 SQL 文件的例子，要在本周项目中按前一天已经建立的模型继续敲。文件名和上下文不同，不要把所有片段塞进同一个 Program.cs。

这是 Week 21 的第 3 天。先使用前面已经掌握的 C#、异步、异常、接口和 MVVM，只增加今天这一层上位机能力。

现场报错时拿不到调试器。诊断包必须包含版本、配置摘要、日志、系统信息和通信统计，但不能泄漏密码。

学习时固定按这个顺序：


先看数据是什么
-> 再看最小代码
-> 对照运行结果
-> 修改一个参数
-> 故意制造错误
-> 最后组合进上位机项目

文件：Program.cs


logger.LogWarning(ex,
    "设备读取失败 Device={DeviceId} Driver={Driver} Attempt={Attempt}",
    device.Id, device.Driver, attempt);

运行结果或界面效果：


日志字段可搜索和统计

必须改一次： 不要记录密码和完整密钥。

文件：Program.cs


public record HealthSnapshot(
    string Version, TimeSpan Uptime, int OnlineDevices,
    int OfflineDevices, long DroppedSamples, int QueueLength);

运行结果或界面效果：


诊断页显示版本、运行时间和采集健康

必须改一次： 增加数据库大小和磁盘剩余。

文件：diagnostic-package.txt


diagnostics-20260713/
  app-info.json
  health.json
  config-redacted.json
  logs/
  database-statistics.txt

运行结果或界面效果：


诊断信息集中且配置已脱敏

必须改一次： 压缩前扫描 Password、Token、ApiKey。

修错顺序固定为：先看第一条异常和行号，再看输入数据，再看原始字节或状态，最后才怀疑框架。

答案不能只背一句话。回到三个例子，用代码中的变量、方法和输出逐项说明。能脱离页面说清楚，才算真的理解。