SuperAPI AI 工具集

dotnet-structured-logging

通用与其它

查看项目

更新于 10-16 01:10

技能介绍

用途:该技能聚焦日志发射之后的管道、查询与运维层,用于设计 .NET 分布式系统的日志聚合、结构化查询、采样、PII 脱敏与跨服务关联。

主要能力:

  1. 聚合架构:对比 ELK、Seq、Grafana Loki、Azure Monitor 的接入、存储、查询方式与适用场景;推荐 OTel Collector 作为中心路由,或小规模部署用 Serilog 直连 sink。
  2. 结构化查询:给出 Kibana KQL、Seq 信号表达式、Grafana LogQL、Azure Monitor KQL 的查询示例,按属性、级别、时间范围过滤。
  3. 采样与容量:头采样、尾采样、级别采样、动态采样策略;用 OTel Collector 的 filter/transform 处理器丢弃低级别日志,或用 Serilog.Expressions 过滤。
  4. PII 脱敏:通过 ILogEventEnricher 掩码敏感属性,或在 OTel Collector attributes 处理器中更新/删除字段。
  5. 跨服务关联:基于 W3C traceparent 的 TraceId/SpanId 关联,以及通过 LogContext.PushProperty 或消息头传递自定义业务 CorrelationId。

使用方式:应用通过 OTLP 发送日志,OTLP 端点用环境变量 OTEL_EXPORTER_OTLP_ENDPOINT 配置;在 Collector 中配置 receivers、processors、exporters 与 pipelines;查询时按平台语法检索 TraceId、CorrelationId 等字段。

适用场景:需要统一日志聚合、控制日志量、满足合规脱敏要求、跨服务追踪请求链路的 .NET 系统。

限制:不涵盖日志发射机制(Serilog/NLog/MEL 配置、LoggerMessage、enricher、sink 注册、OTel 日志导出),也不涵盖应用配置、分布式追踪设置与 trace 上下文传播,这些属于其他技能范围。资料未提供具体收费、价格或平台效果信息。