Skip to content
This repository has been archived by the owner on Jul 1, 2022. It is now read-only.

Commit

Permalink
Rename to io.jaegertracing (#375)
Browse files Browse the repository at this point in the history
* Rename package to io.opentracing

    * Rename package to io.opentracing
    * Remove instrumentations
    * Remove jaeger-b3 module, as it is only wrapper of core classes
    * Bump IDL with io.jaegertracing package

Signed-off-by: Pavol Loffay <[email protected]>

* Fix review comments

Signed-off-by: Pavol Loffay <[email protected]>
  • Loading branch information
pavolloffay authored Apr 10, 2018
1 parent e9c42ba commit 2fa8f3e
Show file tree
Hide file tree
Showing 221 changed files with 746 additions and 4,882 deletions.
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
gen-java/
jaeger-core/src/main/resources/com/uber/jaeger/jaeger.properties
jaeger-core/src/main/resources/io/jaegertracing/jaeger.properties

### Eclipse ###

Expand Down
35 changes: 11 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,14 @@

# Jaeger's Tracing Instrumentation Library for Java

* Intended to be used with [Jaeger](https://github.com/uber/jaeger) backend, but can also be configured to send traces to Zipkin.
* Intended to be used with [Jaeger](https://github.com/jaegertracing/jaeger) backend, but can also be configured to send traces to Zipkin.
* Implement [Java OpenTracing API](https://github.com/opentracing/opentracing-java).
* Supports Java 1.6 and above

#### Package rename to io.jaegertracing
Groupid `com.uber.jaeger` has been deprecated and moved to a different [repository](https://github.com/jaegertracing/legacy-client-java).
Please switch to `io.jaegertracing`. Old groupid will be maintained only for bug fixes.

# Contributing and Developing

Please see [CONTRIBUTING.md](CONTRIBUTING.md).
Expand All @@ -15,20 +19,17 @@ Please see [CONTRIBUTING.md](CONTRIBUTING.md).
Click through for more detailed docs on specific modules.

* [jaeger-core](./jaeger-core): the core implementation of the OpenTracing API
* [jaeger-context](./jaeger-context): in-process context propagation

## Add-on Modules

* [jaeger-dropwizard](./jaeger-dropwizard): a feature to initialize Jaeger from [Dropwizard](http://www.dropwizard.io/) apps (including binding to stats/metrics)
* [jaeger-apachehttpclient](./jaeger-apachehttpclient): instrumentation for apache http clients
* [jaeger-jaxrs2](./jaeger-jaxrs2): instrumentation for JAXRS2 filters
* [jaeger-zipkin](./jaeger-zipkin): compatibility layer for using Jaeger tracer as Zipkin-compatible implementation
* [jaeger-micrometer](./jaeger-micrometer): a metrics provider, to report internal Jaeger metrics to third-party backends, such as Prometheus
* [jaeger-tracerresolver](./jaeger-tracerresolver): a tracer resolver for Jaeger tracer.

## Importing Dependencies
All artifacts are published to Maven Central.
Snapshot artifacts are also published to
[Sonatype](https://oss.sonatype.org/content/repositories/snapshots/com/uber/jaeger/).
[Sonatype](https://oss.sonatype.org/content/repositories/snapshots/io/jaegertracing/).
Follow these [instructions](http://stackoverflow.com/questions/7715321/how-to-download-snapshot-version-from-maven-snapshot-repository)
to add the snapshot repository to your build system.

Expand All @@ -38,7 +39,7 @@ Add the required dependencies to your project. Usually, this would only be the a
For e.g, to depend on the core jaeger library, you'd include the following
```xml
<dependency>
<groupId>com.uber.jaeger</groupId>
<groupId>io.jaegertracing</groupId>
<artifactId>jaeger-core</artifactId>
<version>$jaegerVersion</version>
</dependency>
Expand All @@ -55,7 +56,7 @@ Note that this is only supported for a jaeger version >= 0.15.0
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.uber.jaeger</groupId>
<groupId>io.jaegertracing</groupId>
<artifactId>jaeger-thrift</artifactId>
<classifier>thrift92</classifier>
<version>$jaegerVersion</version>
Expand All @@ -68,20 +69,6 @@ Note that this is only supported for a jaeger version >= 0.15.0

Please see [jaeger-core/README](./jaeger-core/README.md).

## In-process Context Propagation
`jaeger-context` defines
[ThreadLocalTraceContext](./jaeger-context/src/main/java/com/uber/jaeger/context)
implementation of `TraceContext` that can be used for propagating the current tracing `Span`
throughout the application without changing the application's code. However, if the application
is starting new threads or is using thread pools, the thread-local context is not going to be
carried over into the execution in the next thread. To maintain context propagation,
a wrapper `TracedExecutorService` is provided that automatically transfers the context
onto the new threads.

```java
ExecutorService instrumentedExecutorService = TracingUtils.tracedExecutor(wrappedExecutorService);
```

## Testing

When testing tracing instrumentation it is often useful to make sure
Expand Down Expand Up @@ -149,7 +136,7 @@ This allows using Jaeger UI to find the trace by this tag.
[ci]: https://travis-ci.org/jaegertracing/jaeger-client-java
[cov-img]: https://codecov.io/gh/jaegertracing/jaeger-client-java/branch/master/graph/badge.svg
[cov]: https://codecov.io/github/jaegertracing/jaeger-client-java/
[maven-img]: https://img.shields.io/maven-central/v/com.uber.jaeger/jaeger-core.svg?maxAge=2000
[maven]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.uber.jaeger%22
[maven-img]: https://img.shields.io/maven-central/v/io.jaegertracing/jaeger-core.svg?maxAge=2000
[maven]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22io.jaegertracing%22
[fossa-img]: https://app.fossa.io/api/projects/git%2Bgithub.com%2Fjaegertracing%2Fjaeger-client-java.svg?type=shield
[fossa]: https://app.fossa.io/projects/git%2Bgithub.com%2Fjaegertracing%2Fjaeger-client-java?ref=badge_shield
9 changes: 5 additions & 4 deletions build.gradle
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
import java.util.regex.Pattern
import org.gradle.api.tasks.testing.logging.TestLogEvent
import org.gradle.api.tasks.testing.logging.TestExceptionFormat
import org.gradle.api.tasks.testing.logging.TestLogEvent

import java.util.regex.Pattern

plugins {
id "org.jruyi.thrift" version "0.4.0"
Expand Down Expand Up @@ -41,7 +42,7 @@ allprojects {
apply plugin: 'idea' // intellij support
apply plugin: 'jacoco'

group = 'com.uber.jaeger'
group = 'io.jaegertracing'
version = getVersionForBuild()

repositories {
Expand Down Expand Up @@ -78,7 +79,7 @@ subprojects {

if (!version.endsWith("SNAPSHOT")) {
nexusStaging {
packageGroup = "com.uber"
packageGroup = "io.jaegertracing"
username = ossrhUsername
password = ossrhPassword
// Dealing with error "Wrong number of received repositories in state 'open'" (http://bit.ly/2ybracm)
Expand Down
8 changes: 4 additions & 4 deletions gradle/publish.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,12 @@ uploadArchives {
name 'jaeger-client'
packaging 'jar'
description 'Jaeger Java bindings for OpenTracing API'
url 'https://github.com/uber/jaeger-client-java'
url 'https://github.com/jaegertracing/jaeger-client-java'

scm {
connection 'scm:git:[email protected]:uber/jaeger-client-java.git'
developerConnection 'scm:git:[email protected]:uber/jaeger-client-java.git'
url '[email protected]:uber/jaeger-client-java.git'
connection 'scm:git:[email protected]:jaegertracing/jaeger-client-java.git'
developerConnection 'scm:git:[email protected]:jaegertracing/jaeger-client-java.git'
url '[email protected]:jaegertracing/jaeger-client-java.git'
}

licenses {
Expand Down
78 changes: 0 additions & 78 deletions jaeger-apachehttpclient/README.md

This file was deleted.

23 changes: 0 additions & 23 deletions jaeger-apachehttpclient/build.gradle

This file was deleted.

This file was deleted.

This file was deleted.

Loading

0 comments on commit 2fa8f3e

Please sign in to comment.