2.7.2. JBoss EAP 中的 MicroProfile OpenTracing
您可以使用 microprofile-opentracing-smallrye 子系统来配置 Jakarta EE 应用的分布式追踪。此子系统使用 SmallRye OpenTracing 组件为 JBoss EAP 提供 MicroProfile OpenTracing 功能。
MicroProfile OpenTracing 2.0 支持应用的追踪请求。您可以使用管理 CLI 或管理控制台 JBoss EAP 管理 API,为 Jakarta EE 中常用的组件配置默认的 Jaeger Java 客户端跟踪器,以及一组检测库。
部署到 JBoss EAP 服务器的每个单独的 WAR 都会自动拥有自己的 跟踪器 实例。EAR 中的每个 WAR 都被视为单独的 WAR,每个 WAR 都有自己的 Tracer 实例。默认情况下,用于 Jaeger Client 的服务名称派生自部署名称,通常是 WAR 文件名。
在 microprofile-opentracing-smallrye 子系统中,您可以通过设置系统属性或环境变量来配置 Jaeger Java 客户端。
使用系统属性和环境变量配置 Jeager 客户端跟踪器作为技术预览提供。附属于 Jeager 客户端跟踪器的系统属性和环境变量可能会在以后的版本中有所改变,并相互不兼容。
默认情况下,Java Jaeger Client for Java 的 probabilistic 抽样策略被设置为 0.001,这意味着只对大约一千个 trace 进行抽样。若要对每个请求进行示例,请将系统属性 JAEGER_SAMPLER_TYPE 设置为 const,将 JAEGER_SAMPLER_PARAM 设置为 1。
其它资源
- 有关 SmallRye OpenTracing 功能的更多信息,请参阅 SmallRye OpenTracing 组件。
- 有关默认 tracer 的更多信息,请参阅 Jaeger Java 客户端。
-
有关
Tracer接口的更多信息,请参阅Tracerjavadoc。 - 有关覆盖默认追踪器和追踪 Jakarta 上下文和依赖注入 Bean 的更多信息,请参阅《 开发指南 》 中使用 Eclipse MicroProfile OpenTracing to Trace 请求。
- 有关配置 Jaeger 客户端的更多信息,请参阅 Jaeger 文档。
- 如需有关有效系统属性的更多信息,请参阅 Jaeger 文档中的 通过环境配置。