上位机开发中的日志系统设计与HALCON集成实践

1. 为什么上位机开发必须重视日志功能

在工业自动化领域，上位机系统往往需要7×24小时不间断运行。我们团队曾经历过一个典型案例：某汽车零部件检测线在凌晨3点突然停止工作，由于没有日志记录，工程师花了整整6小时才定位到是一个简单的图像采集卡接触不良。这种教训让我深刻认识到——日志系统不是可有可无的装饰品，而是保障系统可靠性的生命线。

对于C#+HALCON架构的上位机，日志系统需要特别关注三个维度的信息：

• 设备通信状态（PLC、相机等外设）
• 图像处理过程（HALCON算子执行情况）
• 业务逻辑流转（检测结果判定逻辑）

重要提示：日志系统设计必须考虑现场工程师的实际使用场景。在嘈杂的车间环境里，他们更需要能快速定位问题的结构化日志，而不是大段的调试信息。

2. C#日志系统架构设计

2.1 日志分级策略

我们采用五级日志体系，针对不同场景配置不同输出级别：

2.2 日志组件选型对比

经过多个项目验证，推荐以下组合方案：

csharp复制// 使用Serilog作为日志框架
Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Debug()
    .WriteTo.Console(outputTemplate: "{Timestamp:HH:mm:ss} [{Level}] {Message}{NewLine}{Exception}")
    .WriteTo.File("logs/log-.txt", 
        rollingInterval: RollingInterval.Day,
        retainedFileCountLimit: 7)
    .WriteTo.SQLite("logs/log.db") // 便于历史查询
    .CreateLogger();

相比NLog等方案，Serilog的优势在于：

1. 更友好的结构化日志支持
2. 与C#异步任务配合更好
3. 丰富的输出目标（支持ElasticSearch等）

3. HALCON特定日志实现技巧

3.1 算子性能监控

HALCON算子的执行效率直接影响系统吞吐量。我们通过封装实现自动耗时记录：

csharp复制public static HTuple MeasureOperator(Action<HTuple> op, HTuple input)
{
    var sw = Stopwatch.StartNew();
    op(input);
    sw.Stop();
    
    Log.Information("[HALCON] 算子 {Operator} 耗时 {Elapsed}ms", 
        op.Method.Name, 
        sw.ElapsedMilliseconds);
        
    return input;
}

// 使用示例
var image = MeasureOperator(halconOperator, inputImage);

3.2 图像处理过程追踪

对于复杂的视觉算法流程，建议记录关键中间结果：

csharp复制// 在临时目录保存调试图像
if (Log.IsEnabled(LogEventLevel.Debug))
{
    HOperatorSet.WriteImage(intermediateImage, "png", 0, 
        $"debug/{DateTime.Now:yyyyMMddHHmmss}_step1.png");
    Log.Debug("生成中间图像: {ImagePath}", imagePath);
}

现场技巧：配置日志过滤器，当检测到连续5次WARN级别的"匹配分数低"时，自动保存原始图像和ROI区域，方便后续分析。

4. 现场问题诊断实战方案

4.1 错误代码标准化

建立统一的错误码体系，例如：

csharp复制public enum VisionErrorCode
{
    CameraTimeout = 1001,
    CalibrationError = 1002,
    TemplateMatchFail = 2001,
    MeasurementOutlier = 2002
}

// 日志记录时附带错误码
Log.Error("模板匹配失败 (Code:{ErrorCode}) ROI:{ROI} Score:{Score}", 
    VisionErrorCode.TemplateMatchFail,
    roi.ToString(),
    matchScore);

4.2 日志可视化工具链

推荐采用以下工具组合：

1. LogViewer：轻量级本地查看器，支持关键词过滤和时间范围选择
2. Grafana：用于展示长期运行的趋势数据（如相机响应时间变化）
3. 自定义诊断工具：集成HALCON图像回放功能，点击日志条目可直接查看对应时刻的图像

![日志系统架构图]
（示意图：客户端日志 → 本地存储 → 网络传输 → 中央日志服务器 → 可视化界面）

5. 性能优化与注意事项

5.1 避免日志成为性能瓶颈

在高频采集场景下（如1000FPS检测），需特别注意：

1. 使用异步日志写入
2. 控制图像调试日志的采样率
3. 采用内存缓存+批量写入策略

csharp复制// 异步日志配置示例
.WriteTo.Async(a => a.File("logs/async-log-.txt"))

5.2 敏感信息处理

工业现场需注意：

1. 对PLC地址、IP等设备信息进行脱敏
2. 产品图像日志需要获得客户授权
3. 设置日志文件访问权限

csharp复制// 数据脱敏过滤器
public class SensitiveDataFilter : ILogEventFilter
{
    public bool IsEnabled(LogEvent logEvent)
    {
        logEvent.Message = Regex.Replace(logEvent.Message, 
            @"\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}", "***");
        return true;
    }
}

6. 扩展应用场景

6.1 基于日志的预测性维护

通过分析历史日志可以：

1. 预测相机光源寿命（亮度衰减趋势）
2. 判断机械振动导致的位置偏差
3. 发现PLC通信质量的周期性波动

6.2 与MES系统集成

将关键检测日志通过OPC UA或REST API上传至MES，实现：

1. 生产质量实时看板
2. 不良品追溯分析
3. 设备OEE计算

在最近一个电池极片检测项目中，我们通过完善的日志系统将平均故障修复时间(MTTR)从127分钟降低到19分钟。这让我更加确信：好的日志系统不是成本，而是投资。当现场工程师能通过手机APP实时查看设备状态时，整个维护体验会发生质的变化。