From 0d5d8c812d793718f78a1f7e6363bc356630cb71 Mon Sep 17 00:00:00 2001 From: Patrik Beqo Date: Mon, 2 Nov 2026 15:32:31 -0500 Subject: [PATCH] Add OpenTelemetry v2 samples --- README.md | 2 + opentelemetry-v2/README.md | 11 +++ opentelemetry-v2/build.gradle | 31 +++++++ opentelemetry-v2/docker-compose.yaml | 6 ++ .../logs/GreetingActivities.java | 8 ++ .../logs/GreetingActivitiesImpl.java | 14 +++ .../logs/GreetingWorkflow.java | 10 +++ .../logs/GreetingWorkflowImpl.java | 21 +++++ .../opentelemetryv2/logs/LogsWorker.java | 84 ++++++++++++++++++ .../samples/opentelemetryv2/logs/README.md | 42 +++++++++ .../metrics/GreetingActivities.java | 8 ++ .../metrics/GreetingActivitiesImpl.java | 16 ++++ .../metrics/GreetingWorkflow.java | 10 +++ .../metrics/GreetingWorkflowImpl.java | 26 ++++++ .../metrics/MetricsWorker.java | 84 ++++++++++++++++++ .../samples/opentelemetryv2/metrics/README.md | 38 ++++++++ .../traces/GreetingActivities.java | 8 ++ .../traces/GreetingActivitiesImpl.java | 20 +++++ .../traces/GreetingWorkflow.java | 10 +++ .../traces/GreetingWorkflowImpl.java | 30 +++++++ .../samples/opentelemetryv2/traces/README.md | 41 +++++++++ .../opentelemetryv2/traces/TracesWorker.java | 70 +++++++++++++++ .../samples/opentelemetryv2/traces/result.png | Bin 0 -> 104207 bytes .../src/main/resources/logback.xml | 21 +++++ settings.gradle | 1 + 25 files changed, 612 insertions(+) create mode 100644 opentelemetry-v2/README.md create mode 100644 opentelemetry-v2/build.gradle create mode 100644 opentelemetry-v2/docker-compose.yaml create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivities.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivitiesImpl.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflow.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflowImpl.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/LogsWorker.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/README.md create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivities.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivitiesImpl.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflow.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflowImpl.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/MetricsWorker.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/README.md create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivities.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivitiesImpl.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflow.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflowImpl.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/README.md create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/TracesWorker.java create mode 100644 opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/result.png create mode 100644 opentelemetry-v2/src/main/resources/logback.xml diff --git a/README.md b/README.md index b70a9098..ca979617 100644 --- a/README.md +++ b/README.md @@ -162,6 +162,8 @@ Load client configuration from TOML files with programmatic overrides. - [**Set up OpenTracing and/or OpenTelemetry with Jaeger**](/core/src/main/java/io/temporal/samples/tracing): Demonstrates how to set up OpenTracing and/or OpenTelemetry and view traces using Jaeger. +- [**OpenTelemetry v2**](/opentelemetry-v2): Demonstrates replay-safe instrumentation with the experimental `temporal-opentelemetry-v2` plugin. + #### Encryption Support - [**Encrypted Payloads**](/core/src/main/java/io/temporal/samples/encryptedpayloads): Demonstrates how to use simple codec to encrypt and decrypt payloads. diff --git a/opentelemetry-v2/README.md b/opentelemetry-v2/README.md new file mode 100644 index 00000000..d2dfae47 --- /dev/null +++ b/opentelemetry-v2/README.md @@ -0,0 +1,11 @@ +# OpenTelemetry v2 + +These samples use the +[OpenTelemetry v2 plugin](https://github.com/temporalio/sdk-java/tree/master/contrib/temporal-opentelemetry-v2) +for replay-safe instrumentation. + +## Samples + +- [Traces](src/main/java/io/temporal/samples/opentelemetryv2/traces) +- [Metrics](src/main/java/io/temporal/samples/opentelemetryv2/metrics) +- [Logs](src/main/java/io/temporal/samples/opentelemetryv2/logs) diff --git a/opentelemetry-v2/build.gradle b/opentelemetry-v2/build.gradle new file mode 100644 index 00000000..d20c7c75 --- /dev/null +++ b/opentelemetry-v2/build.gradle @@ -0,0 +1,31 @@ +repositories { + // temporal-opentelemetry-v2 is not released yet. Publish it with + // ./gradlew publishToMavenLocal from sdk-java. + mavenLocal() +} + +ext { + temporalOtelV2Version = '1.41.0-SNAPSHOT' +} + +dependencies { + implementation "io.temporal:temporal-sdk:$temporalOtelV2Version" + implementation "io.temporal:temporal-envconfig:$temporalOtelV2Version" + implementation "io.temporal:temporal-opentelemetry-v2:$temporalOtelV2Version" + implementation "io.opentelemetry:opentelemetry-exporter-otlp" + implementation "io.opentelemetry:opentelemetry-exporter-prometheus:1.66.0-alpha" + implementation "io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:2.32.0-alpha" + implementation "io.opentelemetry:opentelemetry-exporter-logging" + implementation "io.opentelemetry.instrumentation:opentelemetry-logback-appender-1.0:2.32.0-alpha" + implementation group: 'ch.qos.logback', name: 'logback-classic', version: '1.5.6' + + dependencies { + errorproneJavac('com.google.errorprone:javac:9+181-r4173-1') + errorprone('com.google.errorprone:error_prone_core:2.28.0') + } +} + +task execute(type: JavaExec) { + mainClass = findProperty("mainClass") ?: "" + classpath = sourceSets.main.runtimeClasspath +} diff --git a/opentelemetry-v2/docker-compose.yaml b/opentelemetry-v2/docker-compose.yaml new file mode 100644 index 00000000..8f9f5ec8 --- /dev/null +++ b/opentelemetry-v2/docker-compose.yaml @@ -0,0 +1,6 @@ +services: + jaeger: + image: jaegertracing/jaeger:2.20.0 + ports: + - "127.0.0.1:4317:4317" + - "127.0.0.1:16686:16686" diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivities.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivities.java new file mode 100644 index 00000000..c81bbf97 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivities.java @@ -0,0 +1,8 @@ +package io.temporal.samples.opentelemetryv2.logs; + +import io.temporal.activity.ActivityInterface; + +@ActivityInterface +public interface GreetingActivities { + String composeGreeting(String name); +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivitiesImpl.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivitiesImpl.java new file mode 100644 index 00000000..868dde60 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingActivitiesImpl.java @@ -0,0 +1,14 @@ +package io.temporal.samples.opentelemetryv2.logs; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class GreetingActivitiesImpl implements GreetingActivities { + private static final Logger logger = LoggerFactory.getLogger(GreetingActivitiesImpl.class); + + @Override + public String composeGreeting(String name) { + logger.info("Formatting greeting for {}", name); + return "Hello, " + name + "!"; + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflow.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflow.java new file mode 100644 index 00000000..5eb14203 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflow.java @@ -0,0 +1,10 @@ +package io.temporal.samples.opentelemetryv2.logs; + +import io.temporal.workflow.WorkflowInterface; +import io.temporal.workflow.WorkflowMethod; + +@WorkflowInterface +public interface GreetingWorkflow { + @WorkflowMethod + String greet(String name); +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflowImpl.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflowImpl.java new file mode 100644 index 00000000..a86468b0 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/GreetingWorkflowImpl.java @@ -0,0 +1,21 @@ +package io.temporal.samples.opentelemetryv2.logs; + +import io.temporal.activity.ActivityOptions; +import io.temporal.workflow.Workflow; +import java.time.Duration; +import org.slf4j.Logger; + +public class GreetingWorkflowImpl implements GreetingWorkflow { + private static final Logger logger = Workflow.getLogger(GreetingWorkflowImpl.class); + + private final GreetingActivities activities = + Workflow.newActivityStub( + GreetingActivities.class, + ActivityOptions.newBuilder().setStartToCloseTimeout(Duration.ofSeconds(10)).build()); + + @Override + public String greet(String name) { + logger.info("Requesting greeting for {}", name); + return activities.composeGreeting(name); + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/LogsWorker.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/LogsWorker.java new file mode 100644 index 00000000..7da4a78c --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/LogsWorker.java @@ -0,0 +1,84 @@ +package io.temporal.samples.opentelemetryv2.logs; + +import io.opentelemetry.api.GlobalOpenTelemetry; +import io.opentelemetry.exporter.logging.SystemOutLogRecordExporter; +import io.opentelemetry.exporter.otlp.trace.OtlpGrpcSpanExporter; +import io.opentelemetry.instrumentation.logback.appender.v1_0.OpenTelemetryAppender; +import io.opentelemetry.sdk.logs.SdkLoggerProvider; +import io.opentelemetry.sdk.logs.export.BatchLogRecordProcessor; +import io.opentelemetry.sdk.resources.Resource; +import io.opentelemetry.sdk.trace.SdkTracerProvider; +import io.opentelemetry.sdk.trace.export.BatchSpanProcessor; +import io.temporal.client.WorkflowClient; +import io.temporal.envconfig.ClientConfigProfile; +import io.temporal.opentelemetry.v2.OpenTelemetryPlugin; +import io.temporal.opentelemetry.v2.ReplaySafeOpenTelemetry; +import io.temporal.serviceclient.WorkflowServiceStubs; +import io.temporal.serviceclient.WorkflowServiceStubsOptions; +import io.temporal.worker.Worker; +import io.temporal.worker.WorkerFactory; +import java.io.IOException; + +public class LogsWorker { + static final String TASK_QUEUE = "logs"; + private static final String SERVICE_NAME = "temporal-otel-v2-logs-worker"; + + public static void main(String[] args) throws IOException { + Resource resource = Resource.getDefault().toBuilder().put("service.name", SERVICE_NAME).build(); + + // Log records are printed to the console with the trace and span IDs of the span that was + // current when they were logged. Spans also go to Jaeger, where you can look up a trace ID. + // Batch processors perform exporter I/O outside the Workflow thread. + ReplaySafeOpenTelemetry openTelemetry = + ReplaySafeOpenTelemetry.newBuilder() + .setTracerProviderBuilder( + SdkTracerProvider.builder() + .addSpanProcessor( + BatchSpanProcessor.builder( + OtlpGrpcSpanExporter.builder() + .setEndpoint("http://127.0.0.1:4317") + .build()) + .build()) + .setResource(resource)) + .setLoggerProviderBuilder( + SdkLoggerProvider.builder() + .addLogRecordProcessor( + BatchLogRecordProcessor.builder(SystemOutLogRecordExporter.create()) + .build()) + .setResource(resource)) + .build(); + GlobalOpenTelemetry.set(openTelemetry); + + // Sends SLF4J logs from this package to OpenTelemetry. See logback.xml. + OpenTelemetryAppender.install(openTelemetry); + + OpenTelemetryPlugin plugin = + OpenTelemetryPlugin.newBuilder() + // Adds Temporal SDK operation spans. Log records take the trace and span IDs of the + // span that is current when they are logged. + .setAddTemporalSpans(true) + .build(); + + ClientConfigProfile profile = ClientConfigProfile.load(); + WorkflowServiceStubs service = + WorkflowServiceStubs.newServiceStubs( + WorkflowServiceStubsOptions.newBuilder(profile.toWorkflowServiceStubsOptions()) + .setPlugins(plugin) + .build()); + WorkflowClient client = WorkflowClient.newInstance(service, profile.toWorkflowClientOptions()); + + WorkerFactory factory = WorkerFactory.newInstance(client); + Worker worker = factory.newWorker(TASK_QUEUE); + worker.registerWorkflowImplementationTypes(GreetingWorkflowImpl.class); + worker.registerActivitiesImplementations(new GreetingActivitiesImpl()); + + Runtime.getRuntime() + .addShutdownHook( + new Thread( + () -> { + factory.shutdown(); + openTelemetry.close(); + })); + factory.start(); + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/README.md b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/README.md new file mode 100644 index 00000000..d1913552 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/logs/README.md @@ -0,0 +1,42 @@ +## Logs + +This sample instruments a Workflow and an Activity to emit logs. Each log +record carries the trace ID and span ID of the span it was logged in. + +It turns on Temporal SDK operation spans with `setAddTemporalSpans(true)` in +[`LogsWorker.java`](LogsWorker.java), so the logs have spans to join. + +### Run the sample + +1. Run a [Temporal Service](../../../../../../../../../README.md#running-samples). + +2. Start the Worker: + +```bash +./gradlew -q :opentelemetry-v2:execute -PmainClass=io.temporal.samples.opentelemetryv2.logs.LogsWorker +``` + +3. In another terminal, start the Workflow: + +```bash +temporal workflow execute \ + --task-queue logs \ + --type GreetingWorkflow \ + --input '"Temporal"' +``` + +4. The Worker prints each log record with its trace ID and span ID: + +```text +INFO 'Requesting greeting for Temporal' : ed5a47978eb89fb2f492172747a5ede9 996ada643cb7ee95 [scopeInfo: io.temporal.samples.opentelemetryv2.logs.GreetingWorkflowImpl:] {} +INFO 'Formatting greeting for Temporal' : ed5a47978eb89fb2f492172747a5ede9 17d77396b969503a [scopeInfo: io.temporal.samples.opentelemetryv2.logs.GreetingActivitiesImpl:] {} +``` + + The IDs are different on every run. Within a run, both records share one + trace ID, and each has its own span ID. + + The Worker also exports spans to Jaeger. If Jaeger is running, as in the + [traces sample](../traces), search for your trace ID in the + [Jaeger UI](http://127.0.0.1:16686). The Workflow log's span ID matches the + `RunWorkflow:GreetingWorkflow` span, and the Activity log's span ID matches + the `RunActivity:ComposeGreeting` span. diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivities.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivities.java new file mode 100644 index 00000000..02092ccf --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivities.java @@ -0,0 +1,8 @@ +package io.temporal.samples.opentelemetryv2.metrics; + +import io.temporal.activity.ActivityInterface; + +@ActivityInterface +public interface GreetingActivities { + String composeGreeting(String name); +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivitiesImpl.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivitiesImpl.java new file mode 100644 index 00000000..b3a36ebe --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingActivitiesImpl.java @@ -0,0 +1,16 @@ +package io.temporal.samples.opentelemetryv2.metrics; + +import io.opentelemetry.api.GlobalOpenTelemetry; + +public class GreetingActivitiesImpl implements GreetingActivities { + @Override + public String composeGreeting(String name) { + GlobalOpenTelemetry.getMeter(GreetingWorkflowImpl.INSTRUMENTATION_NAME) + .counterBuilder("greeting.activity.runs") + .setDescription("Number of times the greeting Activity has run") + .setUnit("{run}") + .build() + .add(1); + return "Hello, " + name + "!"; + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflow.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflow.java new file mode 100644 index 00000000..fc377fbc --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflow.java @@ -0,0 +1,10 @@ +package io.temporal.samples.opentelemetryv2.metrics; + +import io.temporal.workflow.WorkflowInterface; +import io.temporal.workflow.WorkflowMethod; + +@WorkflowInterface +public interface GreetingWorkflow { + @WorkflowMethod + String greet(String name); +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflowImpl.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflowImpl.java new file mode 100644 index 00000000..48f50252 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/GreetingWorkflowImpl.java @@ -0,0 +1,26 @@ +package io.temporal.samples.opentelemetryv2.metrics; + +import io.opentelemetry.api.GlobalOpenTelemetry; +import io.temporal.activity.ActivityOptions; +import io.temporal.workflow.Workflow; +import java.time.Duration; + +public class GreetingWorkflowImpl implements GreetingWorkflow { + static final String INSTRUMENTATION_NAME = "io.temporal.samples.opentelemetryv2.metrics"; + + private final GreetingActivities activities = + Workflow.newActivityStub( + GreetingActivities.class, + ActivityOptions.newBuilder().setStartToCloseTimeout(Duration.ofSeconds(10)).build()); + + @Override + public String greet(String name) { + GlobalOpenTelemetry.getMeter(INSTRUMENTATION_NAME) + .counterBuilder("greeting.workflow.runs") + .setDescription("Number of times the greeting Workflow has run") + .setUnit("{run}") + .build() + .add(1); + return activities.composeGreeting(name); + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/MetricsWorker.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/MetricsWorker.java new file mode 100644 index 00000000..b0861c3c --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/MetricsWorker.java @@ -0,0 +1,84 @@ +package io.temporal.samples.opentelemetryv2.metrics; + +import com.uber.m3.tally.RootScopeBuilder; +import com.uber.m3.tally.Scope; +import com.uber.m3.tally.ScopeCloseException; +import io.micrometer.core.instrument.MeterRegistry; +import io.opentelemetry.api.GlobalOpenTelemetry; +import io.opentelemetry.exporter.prometheus.PrometheusHttpServer; +import io.opentelemetry.instrumentation.micrometer.v1_5.OpenTelemetryMeterRegistry; +import io.opentelemetry.sdk.metrics.SdkMeterProvider; +import io.opentelemetry.sdk.resources.Resource; +import io.temporal.client.WorkflowClient; +import io.temporal.common.reporter.MicrometerClientStatsReporter; +import io.temporal.envconfig.ClientConfigProfile; +import io.temporal.opentelemetry.v2.ReplaySafeOpenTelemetry; +import io.temporal.serviceclient.WorkflowServiceStubs; +import io.temporal.serviceclient.WorkflowServiceStubsOptions; +import io.temporal.worker.Worker; +import io.temporal.worker.WorkerFactory; +import java.io.IOException; +import java.util.concurrent.TimeUnit; + +public class MetricsWorker { + static final String TASK_QUEUE = "metrics"; + private static final String SERVICE_NAME = "temporal-otel-v2-metrics-worker"; + + public static void main(String[] args) throws IOException { + // Serves recorded metrics in Prometheus format at http://127.0.0.1:9090/metrics. + PrometheusHttpServer prometheus = + PrometheusHttpServer.builder().setHost("127.0.0.1").setPort(9090).build(); + + // Meters from this global drop recordings made while a Workflow replays. + ReplaySafeOpenTelemetry openTelemetry = + ReplaySafeOpenTelemetry.newBuilder() + .setMeterProviderBuilder( + SdkMeterProvider.builder() + .registerMetricReader(prometheus) + .setResource( + Resource.getDefault().toBuilder() + .put("service.name", SERVICE_NAME) + .build())) + .build(); + GlobalOpenTelemetry.set(openTelemetry); + + // The SDK reports its own metrics through Tally. Micrometer bridges them into OpenTelemetry, + // so they are served next to the custom counters. + MeterRegistry registry = OpenTelemetryMeterRegistry.builder(openTelemetry).build(); + Scope scope = + new RootScopeBuilder() + .reporter(new MicrometerClientStatsReporter(registry)) + .reportEvery(com.uber.m3.util.Duration.ofSeconds(1)); + + ClientConfigProfile profile = ClientConfigProfile.load(); + WorkflowServiceStubs service = + WorkflowServiceStubs.newServiceStubs( + WorkflowServiceStubsOptions.newBuilder(profile.toWorkflowServiceStubsOptions()) + // Exports Temporal SDK metrics, such as temporal_workflow_completed. + // Comment out this line to turn them off and keep only the custom counters. + .setMetricsScope(scope) + .build()); + WorkflowClient client = WorkflowClient.newInstance(service, profile.toWorkflowClientOptions()); + + WorkerFactory factory = WorkerFactory.newInstance(client); + Worker worker = factory.newWorker(TASK_QUEUE); + worker.registerWorkflowImplementationTypes(GreetingWorkflowImpl.class); + worker.registerActivitiesImplementations(new GreetingActivitiesImpl()); + + Runtime.getRuntime() + .addShutdownHook( + new Thread( + () -> { + factory.shutdown(); + factory.awaitTermination(10, TimeUnit.SECONDS); + // Closing the scope sends its last report before OpenTelemetry closes. + try { + scope.close(); + } catch (ScopeCloseException e) { + throw new RuntimeException(e); + } + openTelemetry.close(); + })); + factory.start(); + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/README.md b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/README.md new file mode 100644 index 00000000..ed4c4aaf --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/metrics/README.md @@ -0,0 +1,38 @@ +## Metrics + +This sample instruments a Workflow and an Activity to emit metrics. + +By default, it also exports Temporal SDK metrics with `setMetricsScope(scope)` +in [`MetricsWorker.java`](MetricsWorker.java). Comment out that line to turn +them off and keep only the custom counters. + + +### Run the sample + +1. Run a [Temporal Service](../../../../../../../../../README.md#running-samples). + +2. Start the Worker: + +```bash +./gradlew -q :opentelemetry-v2:execute -PmainClass=io.temporal.samples.opentelemetryv2.metrics.MetricsWorker +``` + +3. In another terminal, start the Workflow: + +```bash +temporal workflow execute \ + --task-queue metrics \ + --type GreetingWorkflow \ + --input '"Temporal"' +``` + +4. Open the [metrics endpoint](http://127.0.0.1:9090/metrics). It shows the + custom `greeting_workflow_runs_total` and `greeting_activity_runs_total` + counters. With SDK metrics on, it also shows Temporal SDK metrics, such as + `temporal_workflow_completed_total` and + `temporal_activity_execution_latency_seconds`. + +```text +greeting_activity_runs_total{otel_scope_name="io.temporal.samples.opentelemetryv2.metrics"} 1.0 +greeting_workflow_runs_total{otel_scope_name="io.temporal.samples.opentelemetryv2.metrics"} 1.0 +``` diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivities.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivities.java new file mode 100644 index 00000000..ad094038 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivities.java @@ -0,0 +1,8 @@ +package io.temporal.samples.opentelemetryv2.traces; + +import io.temporal.activity.ActivityInterface; + +@ActivityInterface +public interface GreetingActivities { + String composeGreeting(String name); +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivitiesImpl.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivitiesImpl.java new file mode 100644 index 00000000..b356ee09 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingActivitiesImpl.java @@ -0,0 +1,20 @@ +package io.temporal.samples.opentelemetryv2.traces; + +import io.opentelemetry.api.GlobalOpenTelemetry; +import io.opentelemetry.api.trace.Span; +import io.opentelemetry.context.Scope; + +public class GreetingActivitiesImpl implements GreetingActivities { + @Override + public String composeGreeting(String name) { + Span span = + GlobalOpenTelemetry.getTracer(GreetingWorkflowImpl.INSTRUMENTATION_NAME) + .spanBuilder("format-greeting") + .startSpan(); + try (Scope ignored = span.makeCurrent()) { + return "Hello, " + name + "!"; + } finally { + span.end(); + } + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflow.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflow.java new file mode 100644 index 00000000..3323cc91 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflow.java @@ -0,0 +1,10 @@ +package io.temporal.samples.opentelemetryv2.traces; + +import io.temporal.workflow.WorkflowInterface; +import io.temporal.workflow.WorkflowMethod; + +@WorkflowInterface +public interface GreetingWorkflow { + @WorkflowMethod + String greet(String name); +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflowImpl.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflowImpl.java new file mode 100644 index 00000000..320d4e53 --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/GreetingWorkflowImpl.java @@ -0,0 +1,30 @@ +package io.temporal.samples.opentelemetryv2.traces; + +import io.opentelemetry.api.GlobalOpenTelemetry; +import io.opentelemetry.api.trace.Span; +import io.opentelemetry.context.Scope; +import io.temporal.activity.ActivityOptions; +import io.temporal.workflow.Workflow; +import java.time.Duration; + +public class GreetingWorkflowImpl implements GreetingWorkflow { + static final String INSTRUMENTATION_NAME = "io.temporal.samples.opentelemetryv2.traces"; + + private final GreetingActivities activities = + Workflow.newActivityStub( + GreetingActivities.class, + ActivityOptions.newBuilder().setStartToCloseTimeout(Duration.ofSeconds(10)).build()); + + @Override + public String greet(String name) { + Span span = + GlobalOpenTelemetry.getTracer(INSTRUMENTATION_NAME) + .spanBuilder("request-greeting") + .startSpan(); + try (Scope ignored = span.makeCurrent()) { + return activities.composeGreeting(name); + } finally { + span.end(); + } + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/README.md b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/README.md new file mode 100644 index 00000000..4d692b6e --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/README.md @@ -0,0 +1,41 @@ +## Traces + +This sample instruments a Workflow and an Activity to emit traces. + +By default, it also turns on Temporal SDK operation spans with +`setAddTemporalSpans(true)` in +[`TracesWorker.java`](TracesWorker.java). Comment out that line to turn them +off and keep only the custom spans. + +### Run the sample + +1. Run a [Temporal Service](../../../../../../../../../README.md#running-samples). + +2. Start Jaeger from the repository root: + +```bash +docker compose -f opentelemetry-v2/docker-compose.yaml up -d +``` + +3. Start the Worker: + +```bash +./gradlew -q :opentelemetry-v2:execute -PmainClass=io.temporal.samples.opentelemetryv2.traces.TracesWorker +``` + +4. In another terminal, start the Workflow: + +```bash +temporal workflow execute \ + --task-queue traces \ + --type GreetingWorkflow \ + --input '"Temporal"' +``` + +5. Inspect the `temporal-otel-v2-traces-worker` service in the + [Jaeger UI](http://127.0.0.1:16686). The trace shows the custom + `request-greeting` and `format-greeting` spans. With Temporal spans on, it + also shows `RunWorkflow:GreetingWorkflow`, `StartActivity:ComposeGreeting`, + and `RunActivity:ComposeGreeting`. + + ![Jaeger trace with custom and Temporal SDK operation spans](result.png) diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/TracesWorker.java b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/TracesWorker.java new file mode 100644 index 00000000..4e088dce --- /dev/null +++ b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/TracesWorker.java @@ -0,0 +1,70 @@ +package io.temporal.samples.opentelemetryv2.traces; + +import io.opentelemetry.api.GlobalOpenTelemetry; +import io.opentelemetry.exporter.otlp.trace.OtlpGrpcSpanExporter; +import io.opentelemetry.sdk.resources.Resource; +import io.opentelemetry.sdk.trace.SdkTracerProvider; +import io.opentelemetry.sdk.trace.export.BatchSpanProcessor; +import io.temporal.client.WorkflowClient; +import io.temporal.envconfig.ClientConfigProfile; +import io.temporal.opentelemetry.v2.OpenTelemetryPlugin; +import io.temporal.opentelemetry.v2.ReplaySafeOpenTelemetry; +import io.temporal.serviceclient.WorkflowServiceStubs; +import io.temporal.serviceclient.WorkflowServiceStubsOptions; +import io.temporal.worker.Worker; +import io.temporal.worker.WorkerFactory; +import java.io.IOException; + +public class TracesWorker { + static final String TASK_QUEUE = "traces"; + private static final String SERVICE_NAME = "temporal-otel-v2-traces-worker"; + + public static void main(String[] args) throws IOException { + OtlpGrpcSpanExporter exporter = + OtlpGrpcSpanExporter.builder().setEndpoint("http://127.0.0.1:4317").build(); + + // The plugin requires a replay-safe OpenTelemetry instance registered as the global. + ReplaySafeOpenTelemetry openTelemetry = + ReplaySafeOpenTelemetry.newBuilder() + .setTracerProviderBuilder( + SdkTracerProvider.builder() + // BatchSpanProcessor performs exporter I/O outside the Workflow thread. + .addSpanProcessor(BatchSpanProcessor.builder(exporter).build()) + .setResource( + Resource.getDefault().toBuilder() + .put("service.name", SERVICE_NAME) + .build())) + .build(); + GlobalOpenTelemetry.set(openTelemetry); + + OpenTelemetryPlugin plugin = + OpenTelemetryPlugin.newBuilder() + // Adds Temporal SDK operation spans, such as RunWorkflow and RunActivity. + // Comment out this line to turn them off and keep only the custom spans. + .setAddTemporalSpans(true) + .build(); + + // Service stubs that carry the plugin pass it to their client and Workers. + ClientConfigProfile profile = ClientConfigProfile.load(); + WorkflowServiceStubs service = + WorkflowServiceStubs.newServiceStubs( + WorkflowServiceStubsOptions.newBuilder(profile.toWorkflowServiceStubsOptions()) + .setPlugins(plugin) + .build()); + WorkflowClient client = WorkflowClient.newInstance(service, profile.toWorkflowClientOptions()); + + WorkerFactory factory = WorkerFactory.newInstance(client); + Worker worker = factory.newWorker(TASK_QUEUE); + worker.registerWorkflowImplementationTypes(GreetingWorkflowImpl.class); + worker.registerActivitiesImplementations(new GreetingActivitiesImpl()); + + Runtime.getRuntime() + .addShutdownHook( + new Thread( + () -> { + factory.shutdown(); + openTelemetry.close(); + })); + factory.start(); + } +} diff --git a/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/result.png b/opentelemetry-v2/src/main/java/io/temporal/samples/opentelemetryv2/traces/result.png new file mode 100644 index 0000000000000000000000000000000000000000..f5f65ce473b15665f9c29ed99d4aba08766afb37 GIT binary patch literal 104207 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%0DmSoMuEv{z1Mi3TWh(X4?{L+xm2#L?W$?k5^@4y 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 literal 0 HcmV?d00001 diff --git a/opentelemetry-v2/src/main/resources/logback.xml b/opentelemetry-v2/src/main/resources/logback.xml new file mode 100644 index 00000000..531d63fd --- /dev/null +++ b/opentelemetry-v2/src/main/resources/logback.xml @@ -0,0 +1,21 @@ + + + + %d{HH:mm:ss.SSS} %-5level [%thread] %logger{36} - %msg%n + + + + + + + + + + + + + + + + diff --git a/settings.gradle b/settings.gradle index e66f00a2..2f590735 100644 --- a/settings.gradle +++ b/settings.gradle @@ -10,3 +10,4 @@ include 'springboot-basic' include 'lambda-worker:starter' include 'lambda-worker:worker' include 'gcp:cloud-run' +include 'opentelemetry-v2'