Rust Tracing 入门

2024-04-23 14:12
文章标签 rust 入门 tracing

本文主要是介绍Rust Tracing 入门,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

Tracing 是一个强大的工具,开发人员可以使用它来了解代码的行为、识别性能瓶颈和调试问题。 Rust 是一种以其性能和安全保证而闻名的语言,在它的世界中,跟踪在确保应用程序平稳高效运行方面发挥着至关重要的作用。

在本文中探讨Tracing 的概念、它在 Rust 生态系统中的重要性,以及如何利用它来改进 Rust 应用程序。无论您是希望深入研究性能优化的经验丰富的 Rustace 爱好者,还是有兴趣了解更多调试工具的语言新手,本指南都旨在为您提供在 Rust 中有效使用Tracing 所需的知识。

理解Tracing

在我们深入研究 Rust 中的Tracing细节之前,了解什么是Tracing以及为什么它是开发人员的重要工具非常重要。

在软件开发的背景下,Tracing是一种用于监视程序执行的方法。它涉及记录有关程序执行的信息,例如函数调用、变量值,甚至整个调用堆栈。然后可以分析这些信息(通常称为“Trace data”),以深入了解程序的行为。

Tracing在调试和性能优化中起着关键作用。通过提供程序执行的详细视图,Tracing使开发人员能够识别瓶颈、发现低效率并了解错误的根本原因。这使其成为提高代码性能和可靠性的宝贵工具。


接下来将探讨如何在 Rust 应用程序中使用Tracing。


在 Rust 中,Tracing是通过一个名为 tracing的crate 强大库来实现的。该包提供了一个框架,用于检测 Rust 程序以收集结构化的、基于事件的诊断信息。与传统日志记录不同, Tracing旨在了解系统中一个事件或一系列事件的上下文,使其成为诊断复杂系统的强大工具。


要开始在 Rust 中使用Tracing,您首先需要将 tracing 箱添加到您的项目中。这可以通过将以下行添加到您的 Cargo.toml 文件中来完成:

[dependencies]
tracing = "0.1"


将 tracing 包添加到您的项目后,您可以通过将以下行添加到主 Rust 文件来开始使用它:

use tracing::{info, trace, warn, error};


tracing 包为不同级别的诊断信息提供了多个宏,包括 info! 、 trace! 、 warn! 和 error!


在 Rust 项目中实现Tracing

现在我们已经在项目中添加了 tracing ,让我们深入了解如何在 Rust 项目中实现Tracing。

use tracing::{info, trace, warn, error};fn main() {tracing::subscriber::set_global_default(tracing_subscriber::FmtSubscriber::new()).expect("setting default subscriber failed");let number = 5;info!("The number is {}", number);let result = compute(number);info!("The result is {}", result);
}fn compute(n: i32) -> i32 {trace!("Computing the value...");if n > 10 {warn!("The number is greater than 10");} else if n < 1 {error!("The number is less than 1");}n * 2
}


在上面的代码中,我们首先为跟踪事件设置一个默认订阅者。然后,我们使用 info! 宏在信息级别记录事件。在 compute 函数中,我们使用 trace! 、 warn! 和 error! 宏根据 n 。


这是一个简单的示例,但它说明了 tracing 包的基本用法。您可以根据需要向代码中添加更复杂的跟踪逻辑。


在下一节中,我们将讨论如何分析程序生成的跟踪数据。

分析Trace数据


在 Rust 应用程序中实现Tracing并生成trace数据后,下一步就是分析这些数据以深入了解应用程序的行为。
分析trace数据涉及检查记录的事件并使用它们来了解程序的执行流程。这可以帮助您识别模式、发现异常并了解应用程序的性能特征。
有多种工具可用于分析 Rust 中的trace数据。最流行的之一是 tracing-subscriber ,它提供了用于实现和配置订阅者的实用程序。


以下是如何使用 tracing-subscriber 分析trace数据的基本示例:

use tracing_subscriber::FmtSubscriber;fn main() {let subscriber = FmtSubscriber::builder().with_max_level(tracing::Level::TRACE).finish();tracing::subscriber::set_global_default(subscriber).expect("setting default subscriber failed");// Your application code goes here...
}


在此示例中,我们创建一个 FmtSubscriber 并将其设置为全局默认值。 with_max_level 函数用于设置订阅者将记录的事件的最大级别。在本例中,我们将记录所有事件直至 TRACE 级别。


收集跟踪数据后,您可以使用各种工具对其进行可视化和解释。这可以帮助您了解应用程序的性能特征、识别瓶颈并发现潜在问题。


在下一节中,我们将探索 Rust 中的一些高级跟踪技术。


先进的trace技术

随着您对 Rust 中的基本跟踪越来越熟悉,您可能会发现自己需要更高级的技术来诊断复杂问题或优化性能。 Rust 生态系统提供了多种用于高级跟踪的强大工具和库。


其中一个工具是 tracing-futures ,它是 tracing 包的扩展,它为使用诊断信息检测 Future 提供支持。这在异步 Rust 程序中特别有用,其中理解 Future 的行为对于调试和性能优化至关重要。


另一个有用的工具是 tracing-serde ,它提供了 Serializer 实现来序列化 tracing 的 Id 、 Metadata 、 Event 、 Record 和 Span 类型作为 Serde Serializable 类型。当您需要序列化跟踪数据以进行分析或传输时,这非常有用。

以下是如何在 Rust 项目中使用 tracing-futures 和 tracing-serde 的示例:

use tracing::{info, Instrument};
use tracing_futures::WithSubscriber;
use tracing_serde::AsSerde;#[tokio::main]
async fn main() {let subscriber = tracing_subscriber::fmt().json() // Output events as JSON.with_env_filter("my_crate=info") // Set log filter.finish();let _guard = tracing::subscriber::set_default(subscriber);let future = async {info!("This is an async block");// Your async code here...};future.instrument(tracing::info_span!("my_span")).with_subscriber(subscriber).await;let span = tracing::info_span!("my_span");println!("{}", serde_json::to_string(&span.as_serde()).unwrap());
}


在此示例中,我们首先创建一个以 JSON 形式输出事件的 tracing 订阅者。然后,我们创建一个异步块,并使用 tracing-futures 中的 instrument 函数对其进行测试。 with_subscriber 函数用于将订阅者附加到未来。最后,我们使用 tracing-serde 将跨度序列化为 JSON。


以上只是 Rust 中可用的高级trace用法的几个示例。当您继续探索 Rust 生态系统时,您会发现更多旨在帮助您充分利用跟踪的工具和库。🦀

这篇关于Rust Tracing 入门的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/929012

相关文章

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门(一):登录与退出》 《Spring-Security-入门(二):基于数据库验证》 《Spring-Security-入门(三):密码加密》 《Spring-Security-入门(四):自定义-Filter》 《Spring-Security-入门(五):在 Sprin

数论入门整理(updating)

一、gcd lcm 基础中的基础,一般用来处理计算第一步什么的,分数化简之类。 LL gcd(LL a, LL b) { return b ? gcd(b, a % b) : a; } <pre name="code" class="cpp">LL lcm(LL a, LL b){LL c = gcd(a, b);return a / c * b;} 例题:

Java 创建图形用户界面(GUI)入门指南(Swing库 JFrame 类)概述

概述 基本概念 Java Swing 的架构 Java Swing 是一个为 Java 设计的 GUI 工具包,是 JAVA 基础类的一部分,基于 Java AWT 构建,提供了一系列轻量级、可定制的图形用户界面(GUI)组件。 与 AWT 相比,Swing 提供了许多比 AWT 更好的屏幕显示元素,更加灵活和可定制,具有更好的跨平台性能。 组件和容器 Java Swing 提供了许多

【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant #搭建基本环境 1 背景2 docker下载 hass3 创建容器4 浏览器访问 hass5 手机APP远程访问hass6 更多玩法 1 背景 既然电脑可以IPV6入站,手机流量可以访问IPV6网络的服务,为什么不在电脑搭建Home Assistant(hass),来控制你的设备呢?@智能家居 @万物互联

poj 2104 and hdu 2665 划分树模板入门题

题意: 给一个数组n(1e5)个数,给一个范围(fr, to, k),求这个范围中第k大的数。 解析: 划分树入门。 bing神的模板。 坑爹的地方是把-l 看成了-1........ 一直re。 代码: poj 2104: #include <iostream>#include <cstdio>#include <cstdlib>#include <al

MySQL-CRUD入门1

文章目录 认识配置文件client节点mysql节点mysqld节点 数据的添加(Create)添加一行数据添加多行数据两种添加数据的效率对比 数据的查询(Retrieve)全列查询指定列查询查询中带有表达式关于字面量关于as重命名 临时表引入distinct去重order by 排序关于NULL 认识配置文件 在我们的MySQL服务安装好了之后, 会有一个配置文件, 也就

音视频入门基础:WAV专题(10)——FFmpeg源码中计算WAV音频文件每个packet的pts、dts的实现

一、引言 从文章《音视频入门基础:WAV专题(6)——通过FFprobe显示WAV音频文件每个数据包的信息》中我们可以知道,通过FFprobe命令可以打印WAV音频文件每个packet(也称为数据包或多媒体包)的信息,这些信息包含该packet的pts、dts: 打印出来的“pts”实际是AVPacket结构体中的成员变量pts,是以AVStream->time_base为单位的显

C语言指针入门 《C语言非常道》

C语言指针入门 《C语言非常道》 作为一个程序员,我接触 C 语言有十年了。有的朋友让我推荐 C 语言的参考书,我不敢乱推荐,尤其是国内作者写的书,往往七拼八凑,漏洞百出。 但是,李忠老师的《C语言非常道》值得一读。对了,李老师有个官网,网址是: 李忠老师官网 最棒的是,有配套的教学视频,可以试看。 试看点这里 接下来言归正传,讲解指针。以下内容很多都参考了李忠老师的《C语言非

【Rust练习】12.枚举

练习题来自:https://practice-zh.course.rs/compound-types/enum.html 1 // 修复错误enum Number {Zero,One,Two,}enum Number1 {Zero = 0,One,Two,}// C语言风格的枚举定义enum Number2 {Zero = 0.0,One = 1.0,Two = 2.0,}fn m

MySQL入门到精通

一、创建数据库 CREATE DATABASE 数据库名称; 如果数据库存在,则会提示报错。 二、选择数据库 USE 数据库名称; 三、创建数据表 CREATE TABLE 数据表名称; 四、MySQL数据类型 MySQL支持多种类型,大致可以分为三类:数值、日期/时间和字符串类型 4.1 数值类型 数值类型 类型大小用途INT4Bytes整数值FLOAT4By