Repository: camel Updated Branches: refs/heads/master e4ae4fb2f -> 7a26b5bae
CAMEL-9759: camel-zipkin - Instrument Camel. Work in progress. Project: http://git-wip-us.apache.org/repos/asf/camel/repo Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/7a26b5ba Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/7a26b5ba Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/7a26b5ba Branch: refs/heads/master Commit: 7a26b5baeaae808113abfc96077cc862e9c5d010 Parents: da6102a Author: Claus Ibsen <davscl...@apache.org> Authored: Wed Mar 30 11:11:55 2016 +0200 Committer: Claus Ibsen <davscl...@apache.org> Committed: Wed Mar 30 11:12:28 2016 +0200 ---------------------------------------------------------------------- examples/camel-example-zipkin/README.md | 59 ++++++++++++++++++++ .../sample/camel/ZipkinCamelApplication.java | 5 +- 2 files changed, 63 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/camel/blob/7a26b5ba/examples/camel-example-zipkin/README.md ---------------------------------------------------------------------- diff --git a/examples/camel-example-zipkin/README.md b/examples/camel-example-zipkin/README.md new file mode 100644 index 0000000..11320b2 --- /dev/null +++ b/examples/camel-example-zipkin/README.md @@ -0,0 +1,59 @@ +# Zipkin Example + +### Introduction + +This example shows how to use Camel with Zipkin to trace/timing all incoming and outgoing Camel messages. + +The example requires a running Zipkin Server. + +The example includes two routes. The client route uses a timer to send a message to the server route. +The server route then replies back to the client. + +### Configuration + +The example is configured in the `src/main/resources/application.properties` file. + +Here you need to configure the hostname and port number for the Zipkin Server. + +### Build + +You will need to compile this example first: + +```sh +$ mvn compile +``` + +### Zipkin web console + +You should be able to visualize the traces and timings from this example using the Zipkin Web Console. +The service name is named `hello`. + + +### Installing Zipkin Server using Docker + +If you want to try Zipkin locally then you quickly try that using Docker. + +There is a [quickstart guide at zipkin](http://zipkin.io/pages/quickstart.html) that has further instructions. +Remember to configure the IP address and port number in the `application.properties` file. + +You can find the IP using `docker-machine ls` + +### Run + +To run the example, type: + +```sh +$ mvn spring-boot:run +``` + +To stop the example hit <kbd>ctrl</kbd>+<kbd>c</kbd>. + +### Forum, Help, etc + +If you hit an problems please let us know on the Camel Forums +<http://camel.apache.org/discussion-forums.html> + +Please help us make Apache Camel better - we appreciate any feedback you may +have. Enjoy! + +The Camel riders! http://git-wip-us.apache.org/repos/asf/camel/blob/7a26b5ba/examples/camel-example-zipkin/src/main/java/sample/camel/ZipkinCamelApplication.java ---------------------------------------------------------------------- diff --git a/examples/camel-example-zipkin/src/main/java/sample/camel/ZipkinCamelApplication.java b/examples/camel-example-zipkin/src/main/java/sample/camel/ZipkinCamelApplication.java index 89be8fc..0b7bbb2 100644 --- a/examples/camel-example-zipkin/src/main/java/sample/camel/ZipkinCamelApplication.java +++ b/examples/camel-example-zipkin/src/main/java/sample/camel/ZipkinCamelApplication.java @@ -22,7 +22,10 @@ import org.springframework.boot.autoconfigure.SpringBootApplication; //CHECKSTYLE:OFF /** - * A sample Spring Boot application that starts the Camel routes. + * A Spring Boot application that starts the Camel Zipkin application. + * <p/> + * Notice we use the `@CamelZipkin` annotation to enable Camel with Zipkin. + * The configuration of Zipkin is in the <tt>application.properties</tt> file. */ @SpringBootApplication @CamelZipkin