ccfos/huatuo

[功能建议]: 网络发送方向（TX）各阶段延迟检测

Open

#323 opened on Jul 7, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Go (86 forks)github user discovery
enhancementgood first issuenetwork

Repository metrics

Stars
 (1,002 stars)
PR merge metrics
 (PR metrics pending)

Description

背景

目前 huatuo 已经支持了收包延迟（RX）检测，但发送方向（TX）的延迟检测尚为空白。TX 路径的性能问题同样会影响业务质量。

需求描述

实现 TX 方向的延迟追踪 BPF 程序，覆盖关键内核路径：

  1. tcp_sendmsg — TCP 发送入口
  2. qdisc — 队列规则层
  3. dev_queue_xmit — 设备驱动队列
  4. nic_xmit — 网卡实际发送

技术要求

  • 定义与 RX 延迟对齐的事件结构体（perf_event_t），保持一致性
  • 复用现有的 toolstream + storage 流水线，减少重复建设
  • 在 Prometheus metrics 中暴露 TX 延迟指标
  • 提供对应的 Grafana 面板

验收标准

  • TX 路径各阶段延迟可采集并展示
  • 事件结构与 RX 格式兼容
  • Prometheus 指标正常暴露
  • Grafana 面板可用

意向参与贡献

  • 我有意向参与具体功能的开发实现并将代码贡献回到上游社区

Contributor guide

Research direction
Study the existing RX delay BPF implementation in the huatuo codebase, then replicate the pattern for TX by attaching BPF programs to tcp sendmsg, qdisc, dev queue xmit, and nic xmit. Ensure event structure compatibility and integrate with toolstream and Prometheus metrics.
Tech stack
go
Domain
observability
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Mostly clear
Prerequisites
GoeBPFLinux kernel networking
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
40