384.10. Example
要启用 camel-zipkin,您需要首先配置
ZipkinTracer zipkin = new ZipkinTracer();
// Configure a reporter, which controls how often spans are sent
// (the dependency is io.zipkin.reporter2:zipkin-sender-okhttp3)
sender = OkHttpSender.create("http://127.0.0.1:9411/api/v2/spans");
zipkin.setSpanReporter(AsyncReporter.create(sender));
// and then add zipkin to the CamelContext
zipkin.init(camelContext);
以上配置将跟踪 Camel 路由中的所有传入和传出消息。
要在 XML 中使用 ZipkinTracer,您只需要定义 scribe 和 zipkin tracer Bean。Camel 将自动发现并使用它们。
<!-- configure how to reporter spans to a Zipkin collector
(the dependency is io.zipkin.reporter2:zipkin-reporter-spring-beans) -->
<bean id="http" class="zipkin2.reporter.beans.AsyncReporterFactoryBean">
<property name="sender">
<bean id="sender" class="zipkin2.reporter.beans.OkHttpSenderFactoryBean">
<property name="endpoint" value="http://localhost:9411/api/v2/spans"/>
</bean>
</property>
<!-- wait up to half a second for any in-flight spans on close -->
<property name="closeTimeout" value="500"/>
</bean>
<!-- setup zipkin tracer -->
<bean id="zipkinTracer" class="org.apache.camel.zipkin.ZipkinTracer">
<property name="serviceName" value="dude"/>
<property name="spanReporter" ref="http"/>
</bean>
384.10.1. ServiceName 复制链接链接已复制到粘贴板!
但是,如果要将 Camel 端点映射到人友好的逻辑名称,您可以添加映射
- ServiceName *
您可以配置所有事件都将回退和使用的全局服务名称,例如:
zipkin.setServiceName("invoices");
这将为所有传入和传出的 zipkin 跟踪使用相同的服务名称。如果您的应用程序使用不同的服务,您应该将它们映射到更精细的客户端/服务器服务映射
384.10.2. 客户端和服务器服务映射 复制链接链接已复制到粘贴板!
- ClientServiceMappings
- ServerServiceMappings
如果您的应用程序托管了其他人可以调用的服务,您可以将 Camel 路由端点映射到服务器服务映射。例如,假设您的 Camel 应用程序具有以下路由:
from("activemq:queue:inbox")
.to("http:someserver/somepath");
您要将其作为服务器服务,您可以添加以下映射:
zipkin.addServerServiceMapping("activemq:queue:inbox", "orders");
然后,当从该 inbox 队列中使用消息时,它将成为带有服务名称"orders"的 zipkin 服务器事件。
现在假设调用 http:someserver/somepath 也是一个服务,您要映射到客户端服务名称,这可以作为以下内容完成:
zipkin.addClientServiceMapping("http:someserver/somepath", "audit");
然后,在同一 Camel 应用程序中将传入和传出端点映射到不同的 zipkin 服务名称。
您可以在服务映射中使用通配符。要将所有传出调用与同一 HTTP 服务器匹配,您可以执行以下操作:
zipkin.addClientServiceMapping("http:someserver*", "audit");