{"id":30015018,"url":"https://github.com/ccfos/huatuo","last_synced_at":"2025-08-11T00:03:09.958Z","repository":{"id":308325472,"uuid":"1031624042","full_name":"ccfos/huatuo","owner":"ccfos","description":"HUATUO（华佗）是由滴滴开源并依托 CCF 开源发展委员会孵化的云原生操作系统可观测性项目，专注于为复杂云原生环境提供操作系统内核级深度观测能力。","archived":false,"fork":false,"pushed_at":"2025-08-05T09:19:46.000Z","size":22543,"stargazers_count":38,"open_issues_count":0,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-05T11:27:37.352Z","etag":null,"topics":["autotracing","ccf","containers","events","k8s","kernel","linux","metrics","observability","profiling","time-series"],"latest_commit_sha":null,"homepage":"https://huatuo.tech/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ccfos.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-04T05:02:21.000Z","updated_at":"2025-08-05T09:32:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"056f4962-c435-4849-b174-4bc2be14860b","html_url":"https://github.com/ccfos/huatuo","commit_stats":null,"previous_names":["ccfos/huatuo"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ccfos/huatuo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccfos%2Fhuatuo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccfos%2Fhuatuo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccfos%2Fhuatuo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccfos%2Fhuatuo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ccfos","download_url":"https://codeload.github.com/ccfos/huatuo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccfos%2Fhuatuo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268953703,"owners_count":24335170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-05T02:00:12.334Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autotracing","ccf","containers","events","k8s","kernel","linux","metrics","observability","profiling","time-series"],"created_at":"2025-08-05T18:43:47.294Z","updated_at":"2025-08-08T22:03:22.667Z","avatar_url":"https://github.com/ccfos.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"简体中文 | [English](./README_EN.md)\n\n![](./docs/huatuo-logo-v3.png)\n\n# 什么是 HUATUO\n**HUATUO（华佗）**是由**滴滴**开源并依托 **CCF 开源发展技术委员会**孵化的云原生操作系统可观测性项目，专注于为复杂云原生环境提供操作系统内核级深度观测能力。该项目基于 [eBPF](https://docs.kernel.org/userspace-api/ebpf/syscall.html) 技术，通过整合 [kprobe](https://www.kernel.org/doc/html/latest/trace/kprobes.html)、 [tracepoint](https://www.kernel.org/doc/html/latest/trace/tracepoints.html)、 [ftrace](https://www.kernel.org/doc/html/latest/trace/ftrace.html)  等内核动态追踪技术，实现了多维度的内核观测能力：**1.** 更精细化的内核子系统埋点指标 Metric **2.** 异常事件驱动的内核运行时上下文捕获 Events **3.** 针对系统突发毛刺的自动追踪 AutoTracing、AutoProfiling。该项目逐步构建了完整的 Linux 内核深度可观测体系架构。目前，HUATUO 已在滴滴生产环境中实现规模化部署，在诸多故障场景中发挥关键作用，有效保障了云原生操作系统的高可用性和性能优化。通过持续的技术演进，希望 HUATUO 能够推动 eBPF 技术在云原生可观测领域向更细粒度、更低开销、更高时效性的方向发展。更多信息访问官网 [https://huatuo.tech](https://huatuo.tech/)。\n\n\n# 核心特性\n- **低损耗内核全景观测**：基于 BPF 技术，保持性能损耗小于1%的基准水位，实现对内存管理、CPU 调度、网络及块 IO 子系统等核心模块的精细化、全维度、全景观测。\n- **异常事件驱动诊断**：构建基于异常事件驱动的运行时上下文捕获机制，聚焦内核异常与慢速路径的精准埋点。当发生缺页异常、调度延迟、锁竞争等关键事件时，自动触发追踪，生成包含寄存器状态、堆栈轨迹及资源占用的诊断信息。\n- **全自动化追踪 AutoTracing**：采用启发式追踪算法，解决云原生复杂场景下的典型性能毛刺故障。针对 CPU idle 掉底，CPU sys 突增，IO 突增，Loadavg 突增等棘手问题，实现自动化快照留存机制和根因诊断。\n- **持续性能剖析 Profiling**：持续对操作系统内核，应用程序进行全方位性能剖析，涉及 CPU、内存、I/O、 锁、以及各种解释性编程语言，力助业务持续的优化迭代更新。该特性在哨兵压测，放火演练，节假日护堤等场景发挥作用。\n- **分布式链路追踪 Tracing**：以网络为中心的面向服务请求的分布式链路追踪，能够清晰的划分系统调用层级关系，节点关联关系，耗时记账等，支持在大规模分布式系统中的跨节点追踪，提供微服务调用的全景视图，保障系统在复杂场景下的稳定性。\n- **开源技术生态融合**：无缝对接主流开源可观测技术栈，如 Prometheus、Grafana、Pyroscope、Elasticsearch等。支持独立物理机和云原生部署，自动感知 K8S 容器资源/标签/注解，自动关联操作系统内核事件指标，消除数据孤岛。通过零侵扰、内核可编程方式兼容主流硬件平台和内核版本，确保其适应性、应用性。\n\n# 软件架构\n![](./docs/image/huatuo-arch.png)\n\n# 快速上手\n\n- **极速体验**\n如果你只关心底层原理，不关心存储、前端展示等，我们提供了编译好的镜像，已包含 HUATUO 底层运行的必要组件，直接运行即可：\n    ```bash\n    $ docker run --privileged --cgroupns=host --network=host -v /sys:/sys -v /run:/run huatuo/huatuo-bamai:latest\n    ```\n\n  在另外一个终端获取指标：\n    ```bash\n    $ curl -s localhost:19704/metrics\n    ```\n\n- **快速搭建**\n  如果你想更进一步了解 HUATUO 运行机制，架构设计等，可在本地很方便地搭建 HUATUO 完整运行的所有组件，我们提供容器镜像以及简单配置，方便用户开发者快速了解 HUATUO。\n    ![](./docs/quick-start-cn.png)\n  \n    \u003cdiv style=\"text-align: center; margin: 8px 0 20px 0; color: #777;\"\u003e\n    \u003csmall\u003e\n    HUATUO 组件运行示意图\u003cbr\u003e\n    \u003c/small\u003e\n    \u003c/div\u003e\n  \n    为快速搭建运行环境，我们提供一键运行的方式，该命令会启动 [elasticsearch](https://www.elastic.co), [prometheus](https://prometheus.io), [grafana](https://grafana.com) 以及 huatuo-bamai 组件。命令执行成功后，打开浏览器访问 [http://localhost:3000](http://localhost:3000) 即可浏览监控大盘。\n  \n    ```bash\n    $ docker compose --project-directory ./build/docker up\n    ```\n\n# 内核版本\n理论支持 4.18 之后的所有版本，主要测试内核、和操作系统发行版如下：\n\n|  HUATUO      |  内核版本 |  操作系统发行版     |\n| :---  |    :----  |  :--- |\n| 1.0      | 4.18.x      | Centos 8.x   |\n| 1.0      | 5.10.x      | OpenEuler 22.03/Anolis OS 8.10  |\n| 1.0      | 6.6.x       | OpenEuler 24.03/Anolis OS 23.3 |\n| 1.0      | 6.8.x       | Ubuntu 24.04 |\n| 1.0      | 6.14.x      | Fedora 42 |\n\n\n# 文档\n\n更多信息访问官网 [https://huatuo.tech](https://huatuo.tech/)\n\n\n# 联系我们\n\n@[hao022](https://github.com/hao022)  \n@[nashuiliang](https://github.com/nashuiliang)  \n@[fanzu8](https://github.com/fanzuba)  \n\n# 开源协议\n该项目采用 Apache License 2.0 协议开源，BPF 代码采用 GPL 协议。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccfos%2Fhuatuo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fccfos%2Fhuatuo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccfos%2Fhuatuo/lists"}