此crate提供了一个用于高性能事件跟踪的库，该库被Rust编译器的非稳定功能 -Z self-profile 使用。

跟踪会话的输出将是一个包含事件流和字符串表的 .mm_profdata 文件，该字符串表允许解码事件流中的 StringId。

编写事件跟踪文件

编写事件跟踪文件的主要入口点是 Profiler 结构。

要创建一个 Profiler，请调用 [Profiler::new()] 函数，并提供一个 Path，其中包含跟踪文件的目录和文件名。或者，调用 [Profiler::with_counter()] 函数，选择分析器将用于事件的 Counter（而 [Profiler::new()] 默认为 wall-time）。

有关可用的计数器的更多信息，请参阅 counters 模块文档。

要记录事件，请调用 [Profiler::record_instant_event()] 方法，传递一些参数

• event_kind：一个将任意类别分配给事件的 StringId
• event_id：一个指定事件名称的 StringId
• thread_id：记录此事件的线程的 u32 ID

此外，事件还可以通过 [Profiler::start_recording_interval_event()] 方法记录。此方法记录一个“开始”事件，并返回一个将在其释放时自动记录相应“结束”事件的 TimingGuard 对象。

要创建一个 StringId，调用以下字符串分配方法之一

• [Profiler::alloc_string()]：分配一个字符串并返回指向它的 StringId