# tools_halo_trace

**Repository Path**: flysinking/tools_halo_trace

## Basic Information

- **Project Name**: tools_halo_trace
- **Description**: HaloOS实时性分析工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 10
- **Created**: 2025-05-14
- **Last Updated**: 2025-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tools_halo_trace代码仓库说明

## 1. 代码仓库简介
tools_halo_trace仓库中实现了一个基于Python语言的综合性实时性分析工具，它支持包含以太网在内的多种硬件接口协议，实现了基于高性能报文格式与OS之间的通讯，支持控制命令交互和报文收集等功能；通过数据处理和事件链合并等操作，可以将收集上的原始报文bin文件转换为[Perfetto](https://perfetto.dev/)（开源的平台级跟踪分析工具）原生支持的pftrace格式文件，并可通过[Perfetto UI](https://ui.perfetto.dev/)进行可视化展示；此外，它还提供了多种用于指标计算的API

## 2. 代码目录
tools_halo_trace源代码在haloosspace/tools/halo_trace目录下，目录结构如下图所示：
```
halo_trace
├── README.md               # 该代码仓库的介绍(即本文)
├── ftrace_manager.py       # ftrace文本生成和解析
├── perfetto_trace_pb2.py   # 由protoc生成，关于protobuf数据的python接口
├── pftrace_manager.py      # 根据VCOS trace报文，生成protobuf数据文件
├── trace_data.py           # 定义trace相关的数据类
├── trace_parser.py         # 定义trace报文解析方法
├── trace_processor.py      # trace工具的执行入口文件
├── trace_util.py           # 定义trace的通用方法和API
└── utils.py                # 定义非trace的通用方法
```

## 3. 仓库使用入门
工具使用详情见 [实时性分析工具开发者手册](https://gitee.com/haloos/vcos/blob/master/user_manual/studio/real_time_analysis_tool_user_manual.md)