Example project that shows how to use armeria and zipkin together
Switch branches/tags
Nothing to show
Clone or download
trustin Update dependencies (#5)
- Armeria 0.70.0 -> 0.75.0
- Brave 5.1.5 -> 5.5.0
Latest commit 70ab31a Nov 6, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/main Update Armeria from 0.69.0 to 0.70.0 (#4) Aug 28, 2018
.gitignore initial commit May 23, 2018
LICENSE initial commit May 23, 2018
README.md initial commit May 23, 2018
pom.xml Update dependencies (#5) Nov 6, 2018


Basic example showing distributed tracing across Armeria apps

This is an example app where two Armeria (Java) services collaborate on an http request. Notably, timing of these requests are recorded into Zipkin, a distributed tracing system. This allows you to see the how long the whole operation took, as well how much time was spent in each service.

Here's an example of what it looks like zipkin screen shot

Implementation Overview

Web requests are served by Armeria services, which trace requests by using the Zipkin plugin.

These traces are sent out of process over http to Zipkin.

This example intentionally avoids advanced topics like async and load balancing, eventhough Armeria supports them.

Running the example

This example has two services: frontend and backend. They both report trace data to zipkin. To setup the demo, you need to start Frontend, Backend and Zipkin.

Once the services are started, open http://localhost:8081/

Next, you can view traces that went through the backend via http://localhost:9411/?serviceName=backend

  • This is a locally run zipkin service which keeps traces in memory

Starting the Services

In a separate tab or window, start each of armeria.Frontend and armeria.Backend:

$ mvn compile exec:java -Dexec.mainClass=armeria.Frontend
$ mvn compile exec:java -Dexec.mainClass=armeria.Backend

Next, run Zipkin, which stores and queries traces reported by the above services.

curl -sSL https://zipkin.io/quickstart.sh | bash -s
java -jar zipkin.jar