58. 使用 Annotations 管理 Spans

您可以使用各种注释管理 spans。

58.1 基本原理

使用 annotations 管理 spans 有很多很好的理由，包括：

58.2 创造新的 Spans

如果您不想手动创建本地 spans，则可以使用@NewSpan annotation。此外，我们提供@SpanTag annotation 以自动方式添加标签。

现在我们可以考虑一些使用示例。

@NewSpan
void testMethod();

在没有任何参数的情况下注释该方法会导致 creating 一个新的 span，其 name 等于带注释的方法 name。

@NewSpan("customNameOnTestMethod4")
void testMethod4();

如果在 annotation 中提供 value(直接或通过设置name参数)，则创建的 span 将提供的 value 作为 name。

// method declaration
@NewSpan(name = "customNameOnTestMethod5")
void testMethod5(@SpanTag("testTag") String param);

// and method execution
this.testBean.testMethod5("test");

您可以将 name 和标记结合使用。让我们关注后者。在这种情况下，带注释的方法的参数 runtime value 的 value 将成为标记的 value。在我们的 sample 中，标签 key 是testTag，标签 value 是test。

@NewSpan(name = "customNameOnTestMethod3")
@Override
public void testMethod3() {
}

您可以将@NewSpan annotation 放在 class 和接口上。如果覆盖接口的方法并为@NewSpan annotation 提供不同的 value，则最具体的一个获胜(在这种情况下设置为customNameOnTestMethod3)。

58.3 继续 Spans

如果要向现有的 span 添加标签和 annotations，可以使用@ContinueSpan annotation，如下面的示例所示：

// method declaration
@ContinueSpan(log = "testMethod11")
void testMethod11(@SpanTag("testTag11") String param);

// method execution
this.testBean.testMethod11("test");
this.testBean.testMethod13();

(注意，与@NewSpan annotation 相比，您还可以使用log parameter.)添加日志

这样，span 继续下去：

58.4 高级标签设置

有三种不同的方法可以向 span 添加标签。所有这些都由SpanTag annotation 控制。优先顺序如下：

58.4.1 自定义提取器

以下方法的标记的 value 由TagValueResolver接口的 implementation 计算。它的 class name 必须作为resolver属性的 value 传递。

请考虑以下带注释的方法：

@NewSpan
public void getAnnotationForTagValueResolver(@SpanTag(key = "test", resolver = TagValueResolver.class) String test) {
}

现在进一步考虑以下TagValueResolver bean implementation：

@Bean(name = "myCustomTagValueResolver")
public TagValueResolver tagValueResolver() {
	return parameter -> "Value from myCustomTagValueResolver";
}

前面两个示例导致将标签 value 设置为等于Value from myCustomTagValueResolver。

58.4.2 解析 Value 的表达式

请考虑以下带注释的方法：

@NewSpan
public void getAnnotationForTagValueExpression(@SpanTag(key = "test", expression = "'hello' + ' characters'") String test) {
}

没有TagValueExpressionResolver的自定义_impleration 导致 SPEL 表达式的 evaluation，并且 span 上设置了 value 为4 characters的标记。如果要使用其他一些表达式解析机制，可以创建自己的 bean 实现 bean。

58.4.3 使用 toString()方法

请考虑以下带注释的方法：

@NewSpan
public void getAnnotationForArgumentToString(@SpanTag("test") Long param) {
}

使用_val运行上述方法会导致设置 String value 为"15"的标记。

首页