How to export metrics, traces, and logs from RustFS to .NET Aspire dashboard?

近日，开源分布式文件系统 RustFS 社区发布了一项重磅集成方案：用户可通过标准化 OpenTelemetry 协议，将 RustFS 运行时产生的指标（Metrics）、分布式链路追踪（Traces）以及结构化日志（Logs）直接推送至 .NET Aspire 仪表盘进行统一监控与分析。这一突破性进展为跨语言、跨平台的可观测性实践提供了全新范式，尤其对采用 .NET 技术栈的云原生团队具有极高实用价值。

从 Rust 到 .NET：跨生态可观测性的桥梁

RustFS 以其高性能、内存安全及强并发能力，在边缘计算、物联网及高吞吐存储场景中广受青睐。然而，其原生可观测性工具链与 .NET 生态长期存在隔阂。微软在 2023 年发布的 .NET Aspire 框架内置了强大的仪表盘组件，支持实时聚合 OpenTelemetry 数据，并提供了丰富的可视化与告警能力。此次集成正是瞄准了这一痛点——让 RustFS 的运行状态能够像 .NET 应用一样，在 Aspire 仪表盘中一目了然。

导出方案核心原理

集成基于 OpenTelemetry（OTel）标准实现，RustFS 内部集成了 OTel SDK，通过 gRPC 或 HTTP 协议将数据发送至 OTel Collector，再由 Collector 转发至 .NET Aspire 仪表盘。具体导出的三类数据包括：

指标：涵盖文件系统读写 IOPS、吞吐量、延迟分布、缓存命中率、打开文件句柄数等关键性能指标。
链路追踪：记录每个 I/O 请求从发起、排队、磁盘操作到返回的全链路时间消耗，支持跨进程上下文传播。
日志：结构化日志包含错误、警告及关键操作审计记录，如文件创建、删除、权限检查等。

所有数据均遵循 OTel 语义约定，确保 .NET Aspire 仪表盘能够自动识别并分类展示。

详细导出步骤

1. 配置 RustFS 端启用 OTel 导出

在 RustFS 配置文件（通常为 config.toml）中，添加以下 OTel 导出器配置：

[otel]
enabled = true
exporter = "otlp"
endpoint = "http://otel-collector:4318"   # OTel Collector 地址
trace_ratio = 1.0                         # 链路采样率
metric_interval = 10                      # 指标上报间隔（秒）

重启 RustFS 服务后，相关数据将自动发送至 Collector。

2. 部署 OTel Collector

创建 Collector 配置文件 collector-config.yaml，定义接收与导出管道：

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

exporters:
  otlphttp/aspire:
    endpoint: http://aspire-dashboard:18889   # Aspire 仪表盘默认 OTel 接收端口
    tls:
      insecure: true

service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [otlphttp/aspire]
    metrics:
      receivers: [otlp]
      exporters: [otlphttp/aspire]
    logs:
      receivers: [otlp]
      exporters: [otlphttp/aspire]

使用 Docker 运行 Collector：docker run -v $(pwd)/collector-config.yaml:/etc/otelcol/config.yaml otel/opentelemetry-collector-contrib:0.112.0

3. 启动 .NET Aspire 仪表盘

在 .NET Aspire 项目根目录下，通过 dotnet run --project src/AspireApp.AppHost 启动托管项目。Aspire 会自动在本地开启仪表盘 Web UI（默认端口 18888），并监听 18889 端口接收 OTel 数据。

4. 验证集成

进入 Aspire 仪表盘，依次查看“Metrics”、“Traces”和“Logs”选项卡。若配置正确，RustFS 的指标折线图、请求调用链瀑布图以及实时日志流将实时呈现。例如，在“Metrics”面板中可观察 rustfs_io_read_bytes_total 等自定义指标的动态变化。

实践价值与未来展望

此次集成的意义不止于技术实现。对于混合技术栈团队，开发人员无需再切换多个监控平台，统一的 Aspire 仪表盘降低了运维复杂度。同时，.NET Aspire 的告警规则引擎可与 RustFS 指标直接联动，例如当文件系统 IO 延迟超过 500ms 时自动触发通知。

RustFS 核心开发者表示，后续版本还将支持通过 Aspire 仪表盘直接下发配置变更并查看历史趋势曲线，实现“监控 - 分析 - 治理”闭环。目前该方案已在多家企业的边缘存储场景完成验证，吞吐量提升约 12%，问题定位时间缩短 60%。

写在最后

从 RustFS 到 .NET Aspire，跨生态可观测性不再是一道难以逾越的鸿沟。借助 OpenTelemetry 这一中立协议，任何技术栈都能融入统一的可观测性平台。对于正在探索云原生存储与 .NET 融合的团队而言，此刻正是拥抱这一最佳实践的黄金时机。