From 81a07f7ba81d616b2437c636f9aa68a19f859d75 Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Thu, 14 Sep 2023 08:46:26 -0700 Subject: [PATCH 1/7] add blogpost on migrating away from the Jaeger exporter This is to help users that upgrade to v0.85.0 of the OTel Collector. Signed-off-by: Alex Boten --- .../jaeger-exporter-collector-migration.md | 73 +++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 content/en/blog/2023/jaeger-exporter-collector-migration.md diff --git a/content/en/blog/2023/jaeger-exporter-collector-migration.md b/content/en/blog/2023/jaeger-exporter-collector-migration.md new file mode 100644 index 000000000000..4eaa6d0b16c3 --- /dev/null +++ b/content/en/blog/2023/jaeger-exporter-collector-migration.md @@ -0,0 +1,73 @@ +--- +title: Migrating away from the Jaeger exporter in the Collector +linkTitle: Migrating away from the Jaeger exporter in the Collector +date: 2023-09-14 +author: >- + [Alex Boten](https://twitter.com/codeboten) (Lightstep) +cSpell:ignore: +--- + +The +[latest binary](https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.85.0) +release of the OpenTelemetry Collector no longer includes exporters for the +native Jaeger format. This change was prompted because Jaeger has support for +OTLP out of the box. If you are a current user of either the Jaeger or Jaeger +Thrift exporter, you have a couple of options to choose from when upgrading to +the latest Collector. + +## Switch to OTLP exporter + +The recommended option is to switch to the OpenTelemetry Protocol exporter. This +exporter is included in all the official distributions supported by the +community. To switch, you'll need to update the collector configuration. Find +the following Jaeger exporter configuration: + +```yaml +exporters: + jaeger: + endpoint: https://jaeger.example.com:14250 + +service: + pipelines: + exporters: [jaeger] +``` + +And replace it with the OTLP configuration: + +```yaml +exporters: + otlp/jaeger: # Jaeger supports OTLP directly + endpoint: https://jaeger.example.com:4317 + +service: + pipelines: + exporters: [otlp/jaeger] +``` + +Depending on your version of Jaeger, you may need to set the following +environment variable `COLLECTOR_OTLP_ENABLED=true`. + +## Build a custom Collector + +If switching to the OTLP exporter isn't an option, an alternative is to build a +custom Collector that includes the Jaeger exporter. The process to build is +documented [here](https://opentelemetry.io/docs/collector/custom-collector/). +Your manifest file will need to include the following line to add the Jaeger +exporter: + +```yaml +exporters: + - gomod: go.opentelemetry.io/collector/exporter/jaegerexporter v0.85.0 + - gomod: + go.opentelemetry.io/collector/exporter/jaegerthrifthttpexporter v0.85.0 +``` + +Further example of manifest files for existing Collector distributions can be +found in the +[opentelemetry-collector-releases](https://github.com/open-telemetry/opentelemetry-collector-releases/blob/main/distributions/otelcol) +repository. + +If either of these options do not work for your use-case, please reach out to +the #otel-collector community via [CNCF Slack](https://slack.cncf.io) or open an +issue in the +[repository](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues). From 0a62a7061b2ce2ff133c1d315013e80f0aacb969 Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Thu, 14 Sep 2023 09:37:19 -0700 Subject: [PATCH 2/7] Apply suggestions from code review Co-authored-by: Severin Neumann Co-authored-by: Pablo Baeyens --- .../en/blog/2023/jaeger-exporter-collector-migration.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/blog/2023/jaeger-exporter-collector-migration.md b/content/en/blog/2023/jaeger-exporter-collector-migration.md index 4eaa6d0b16c3..76cc46899941 100644 --- a/content/en/blog/2023/jaeger-exporter-collector-migration.md +++ b/content/en/blog/2023/jaeger-exporter-collector-migration.md @@ -1,6 +1,6 @@ --- title: Migrating away from the Jaeger exporter in the Collector -linkTitle: Migrating away from the Jaeger exporter in the Collector +linkTitle: Jaeger Collector Exporter Migration date: 2023-09-14 author: >- [Alex Boten](https://twitter.com/codeboten) (Lightstep) @@ -36,7 +36,7 @@ And replace it with the OTLP configuration: ```yaml exporters: - otlp/jaeger: # Jaeger supports OTLP directly + otlp/jaeger: # Jaeger supports OTLP directly. The default port for OTLP/gRPC is 4317 endpoint: https://jaeger.example.com:4317 service: @@ -68,6 +68,6 @@ found in the repository. If either of these options do not work for your use-case, please reach out to -the #otel-collector community via [CNCF Slack](https://slack.cncf.io) or open an +the [#otel-collector](https://cloud-native.slack.com/archives/C01N6P7KR6W) community via [CNCF Slack](https://slack.cncf.io) or open an issue in the -[repository](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues). +[repository](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/new/choose). From 5e9dc28e80a62d2c92527b815e2f6f8f7ff376e4 Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Thu, 14 Sep 2023 09:37:47 -0700 Subject: [PATCH 3/7] Update content/en/blog/2023/jaeger-exporter-collector-migration.md --- content/en/blog/2023/jaeger-exporter-collector-migration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/blog/2023/jaeger-exporter-collector-migration.md b/content/en/blog/2023/jaeger-exporter-collector-migration.md index 76cc46899941..358b90603d89 100644 --- a/content/en/blog/2023/jaeger-exporter-collector-migration.md +++ b/content/en/blog/2023/jaeger-exporter-collector-migration.md @@ -3,7 +3,7 @@ title: Migrating away from the Jaeger exporter in the Collector linkTitle: Jaeger Collector Exporter Migration date: 2023-09-14 author: >- - [Alex Boten](https://twitter.com/codeboten) (Lightstep) + [Alex Boten](https://github.com/codeboten) (Lightstep) cSpell:ignore: --- From 1881ae06937cbcd95bc09b1b48541e0f4e333d8f Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Thu, 14 Sep 2023 13:14:35 -0700 Subject: [PATCH 4/7] Update content/en/blog/2023/jaeger-exporter-collector-migration.md --- content/en/blog/2023/jaeger-exporter-collector-migration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/blog/2023/jaeger-exporter-collector-migration.md b/content/en/blog/2023/jaeger-exporter-collector-migration.md index 358b90603d89..7aaa63d7c1c3 100644 --- a/content/en/blog/2023/jaeger-exporter-collector-migration.md +++ b/content/en/blog/2023/jaeger-exporter-collector-migration.md @@ -44,8 +44,8 @@ service: exporters: [otlp/jaeger] ``` -Depending on your version of Jaeger, you may need to set the following -environment variable `COLLECTOR_OTLP_ENABLED=true`. +Versions of Jaeger until v1.46.0, need the following environment +variable set `COLLECTOR_OTLP_ENABLED=true`. ## Build a custom Collector From da63622bc97e583dd2f3c6a9083e4a09416b24d3 Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Fri, 15 Sep 2023 13:50:21 -0700 Subject: [PATCH 5/7] Update content/en/blog/2023/jaeger-exporter-collector-migration.md Co-authored-by: Pablo Baeyens --- .../blog/2023/jaeger-exporter-collector-migration.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/en/blog/2023/jaeger-exporter-collector-migration.md b/content/en/blog/2023/jaeger-exporter-collector-migration.md index 7aaa63d7c1c3..23a1dc4e9704 100644 --- a/content/en/blog/2023/jaeger-exporter-collector-migration.md +++ b/content/en/blog/2023/jaeger-exporter-collector-migration.md @@ -4,7 +4,7 @@ linkTitle: Jaeger Collector Exporter Migration date: 2023-09-14 author: >- [Alex Boten](https://github.com/codeboten) (Lightstep) -cSpell:ignore: +cSpell:ignore: Boten gomod jaegerexporter jaegerthrifthttpexporter --- The @@ -44,8 +44,8 @@ service: exporters: [otlp/jaeger] ``` -Versions of Jaeger until v1.46.0, need the following environment -variable set `COLLECTOR_OTLP_ENABLED=true`. +Versions of Jaeger until v1.46.0, need the following environment variable set +`COLLECTOR_OTLP_ENABLED=true`. ## Build a custom Collector @@ -68,6 +68,6 @@ found in the repository. If either of these options do not work for your use-case, please reach out to -the [#otel-collector](https://cloud-native.slack.com/archives/C01N6P7KR6W) community via [CNCF Slack](https://slack.cncf.io) or open an -issue in the +the [#otel-collector](https://cloud-native.slack.com/archives/C01N6P7KR6W) +community via [CNCF Slack](https://slack.cncf.io) or open an issue in the [repository](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/new/choose). From 4040ead9ce0d4cb0df6b751693e725a8872786ef Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Mon, 18 Sep 2023 14:47:34 -0700 Subject: [PATCH 6/7] fix link Signed-off-by: Alex Boten --- content/en/blog/2023/jaeger-exporter-collector-migration.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/content/en/blog/2023/jaeger-exporter-collector-migration.md b/content/en/blog/2023/jaeger-exporter-collector-migration.md index 23a1dc4e9704..f92534b47565 100644 --- a/content/en/blog/2023/jaeger-exporter-collector-migration.md +++ b/content/en/blog/2023/jaeger-exporter-collector-migration.md @@ -51,9 +51,8 @@ Versions of Jaeger until v1.46.0, need the following environment variable set If switching to the OTLP exporter isn't an option, an alternative is to build a custom Collector that includes the Jaeger exporter. The process to build is -documented [here](https://opentelemetry.io/docs/collector/custom-collector/). -Your manifest file will need to include the following line to add the Jaeger -exporter: +documented [here](/docs/collector/custom-collector/). Your manifest file +will need to include the following line to add the Jaeger exporter: ```yaml exporters: From fbefa9ffd34f902397f0f1881d0aeeccb0678f49 Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Mon, 18 Sep 2023 15:55:29 -0700 Subject: [PATCH 7/7] fix format Signed-off-by: Alex Boten --- content/en/blog/2023/jaeger-exporter-collector-migration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/blog/2023/jaeger-exporter-collector-migration.md b/content/en/blog/2023/jaeger-exporter-collector-migration.md index f92534b47565..5257c6c3c4bd 100644 --- a/content/en/blog/2023/jaeger-exporter-collector-migration.md +++ b/content/en/blog/2023/jaeger-exporter-collector-migration.md @@ -51,8 +51,8 @@ Versions of Jaeger until v1.46.0, need the following environment variable set If switching to the OTLP exporter isn't an option, an alternative is to build a custom Collector that includes the Jaeger exporter. The process to build is -documented [here](/docs/collector/custom-collector/). Your manifest file -will need to include the following line to add the Jaeger exporter: +documented [here](/docs/collector/custom-collector/). Your manifest file will +need to include the following line to add the Jaeger exporter: ```yaml exporters: