PyO3 OpenTelemetry

背景

这是什么

pyo3_opentelemetry 提供了一个宏，可以简单方便地给你的 PyO3 绑定进行配置，以便轻松地将 OpenTelemetry 上下文从 Python 调用者传递到 Rust 库。使用 #[pypropagate] 属性，Rust 函数将自动配置，以便在 FFI 边界共享全局 Python OpenTelemetry 上下文。

这不是什么

• （目前）不支持从 Rust 将 OpenTelemetry 上下文传播到 Python。
• 这不会“神奇地”配置 Rust 代码。如果没有 #[pypropagate] 属性，Rust 代码将不受影响，并且不会附加 Python OpenTelemetry 上下文。
• 这不会促进 OpenTelemetry span 的处理或收集；你仍然需要在 Python 和 Rust 中分别初始化和刷新跟踪提供程序和订阅者。有关更多信息，请参阅 Python 和 Rust 的相应 OpenTelemetry 文档。

用法

有关完整的示例，请参阅此 crate 仓库中的 examples/pyo3-opentelemetry-lib/src/lib.rs。

从 Rust

use pyo3_opentelemetry::prelude::*;
use pyo3::prelude::*;
use tracing::instrument;

#[pypropagate]
#[pyfunction]
#[instrument]
fn my_function() {
  println!("span \"my_function\" is active and will share the Python OpenTelemetry context");
}

#[pymodule]
fn my_module(_py: Python, m: &PyModule) -> PyResult<()> {
   m.add_function(wrap_pyfunction!(my_function, m)?)?;
   Ok(())
}

这些功能不需要对 Python 代码进行任何更改，但是必须安装 opentelemetry-api。