{"id":13805885,"url":"https://github.com/smoketurner/dropwizard-zipkin","last_synced_at":"2025-05-13T21:31:46.218Z","repository":{"id":3902134,"uuid":"51269282","full_name":"smoketurner/dropwizard-zipkin","owner":"smoketurner","description":"Dropwizard Zipkin Bundle","archived":true,"fork":false,"pushed_at":"2023-03-27T01:56:36.000Z","size":3331,"stargazers_count":50,"open_issues_count":2,"forks_count":25,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-06-21T18:09:19.220Z","etag":null,"topics":["distributed-tracing","dropwizard","dropwizard-zipkin","instrumentation","java","tracing","zipkin","zipkin-brave"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smoketurner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null},"funding":{"github":"jplock","patreon":"jplock","open_collective":null,"ko_fi":null,"tidelift":null,"custom":null}},"created_at":"2016-02-07T22:19:54.000Z","updated_at":"2023-04-02T15:09:00.000Z","dependencies_parsed_at":"2023-02-19T03:45:59.919Z","dependency_job_id":"ef5090d9-bfc4-4780-89ac-44f40181b006","html_url":"https://github.com/smoketurner/dropwizard-zipkin","commit_stats":null,"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smoketurner%2Fdropwizard-zipkin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smoketurner%2Fdropwizard-zipkin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smoketurner%2Fdropwizard-zipkin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smoketurner%2Fdropwizard-zipkin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smoketurner","download_url":"https://codeload.github.com/smoketurner/dropwizard-zipkin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213870459,"owners_count":15650178,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["distributed-tracing","dropwizard","dropwizard-zipkin","instrumentation","java","tracing","zipkin","zipkin-brave"],"created_at":"2024-08-04T01:01:05.942Z","updated_at":"2024-08-04T01:05:26.275Z","avatar_url":"https://github.com/smoketurner.png","language":"Java","funding_links":["https://github.com/sponsors/jplock","https://patreon.com/jplock","https://www.patreon.com/bePatron?u=9567343"],"categories":["Open Source"],"sub_categories":["Eclipse"],"readme":"Dropwizard Zipkin Bundle\n========================\n[![Build Status](https://travis-ci.org/smoketurner/dropwizard-zipkin.svg?branch=master)](https://travis-ci.org/smoketurner/dropwizard-zipkin)\n[![Maven Central](https://img.shields.io/maven-central/v/com.smoketurner.dropwizard/dropwizard-zipkin.svg?style=flat-square)](https://maven-badges.herokuapp.com/maven-central/com.smoketurner.dropwizard/dropwizard-zipkin/)\n[![GitHub license](https://img.shields.io/github/license/smoketurner/dropwizard-zipkin.svg?style=flat-square)](https://github.com/smoketurner/dropwizard-zipkin/tree/master)\n[![Become a Patron](https://img.shields.io/badge/Patron-Patreon-red.svg)](https://www.patreon.com/bePatron?u=9567343)\n\nA bundle for submitting tracing data to [Zipkin](http://zipkin.io) from Dropwizard applications. Internally, this library uses [Brave](https://github.com/openzipkin/brave) to interface a Zipkin collector.\n\nDependency Info\n---------------\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.smoketurner.dropwizard\u003c/groupId\u003e\n    \u003cartifactId\u003ezipkin-core\u003c/artifactId\u003e\n    \u003cversion\u003e2.0.7-1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nBeginning with v1.2.2-4, if you are using the Kafka sender, you must explicitly add the `kafka-clients` dependency into your `pom.xml` as it has been excluded from the `zipkin-core` module.\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.apache.kafka\u003c/groupId\u003e\n    \u003cartifactId\u003ekafka-clients\u003c/artifactId\u003e\n    \u003cversion\u003e2.2.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nUsage\n-----\nAdd a `ZipkinBundle` to your [Application](https://javadoc.io/doc/io.dropwizard/dropwizard-project/latest/io/dropwizard/Application.html) class.\n\n```java\nprivate ZipkinBundle\u003cHelloWorldConfiguration\u003e zipkinBundle;\n\n@Override\npublic void initialize(Bootstrap\u003cHelloWorldConfiguration\u003e bootstrap) {\n  zipkinBundle = new ZipkinBundle\u003cHelloWorldConfiguration\u003e(getName()) {\n    @Override\n    public ZipkinFactory getZipkinFactory(HelloWorldConfiguration configuration) {\n      return configuration.getZipkinFactory();\n    }\n  };\n  bootstrap.addBundle(zipkinBundle);\n}\n\n@Override\npublic void run(HelloWorldConfiguration configuration, Environment environment) throws Exception {\n  final Optional\u003cHttpTracing\u003e tracing = zipkinBundle.getHttpTracing();\n}\n```\n\nConfiguration\n-------------\nFor configuring the Zipkin connection, there is a `ZipkinFactory`:\n\n```yaml\nzipkin:\n\n  # Required properties\n  # Whether tracing is enabled or not (defaults to true)\n  enabled: true\n  # Listening IP address of the service\n  serviceHost: 192.168.1.100\n  # Listening port of the service\n  servicePort: 8080\n\n  # Optional properties\n  # Span collector to use (console, http, kafka or empty)\n  collector: http\n  # If using the http collector, provide the baseUrl\n  baseUrl: http://127.0.0.1:9411/\n  # If using the http collector, timeout out when connecting (defaults to 10s)\n  connectTimeout: 10s\n  # If using the http collector, timeout out when reading the response (defaults to 60s)\n  readTimeout: 60s\n  # If using the kafka collector, provide the Kafka bootstrap servers\n  bootstrapServers: 127.0.0.1:9092;10.0.1.1:9092\n```\n\nExample Application\n-------------------\nThis bundle includes a modified version of the `HelloWorldApplication` from Dropwizard's [Getting Started](https://www.dropwizard.io/en/latest/getting-started.html) documentation.\n\nYou can execute this application by first starting Zipkin on your local machine then running:\n\n```\n./mvnw clean package\njava -jar zipkin-example/target/zipkin-example-*-SNAPSHOT.jar server zipkin-example/hello-world.yml\n```\n\nThis will start the application on port `8080` (admin port `8180`). This application demonstrations the following Zipkin integration points:\n\n- You can use the included `ZipkinClientBuilder` to construct an instrumented `JerseyClient`'s that will send span traces to Zipkin\n- The service will send request and response traces to Zipkin\n\nSupport\n-------\nPlease file bug reports and feature requests in [GitHub issues](https://github.com/smoketurner/dropwizard-zipkin/issues).\n\nLicense\n-------\nCopyright (c) 2020 Smoke Turner, LLC\n\nThis library is licensed under the Apache License, Version 2.0.\n\nSee http://www.apache.org/licenses/LICENSE-2.0.html or the [LICENSE](LICENSE) file in this repository for the full license text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmoketurner%2Fdropwizard-zipkin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmoketurner%2Fdropwizard-zipkin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmoketurner%2Fdropwizard-zipkin/lists"}