From 6e8c6befa8179a051e8e1dc166d2b944d0fe888f Mon Sep 17 00:00:00 2001
From: Robert Cao <11479329+robcao@users.noreply.github.com>
Date: Tue, 3 Sep 2024 13:31:16 -0500
Subject: [PATCH] Add OpenTelemetry Sample (#78)
---
Directory.Build.props | 6 +-
README.md | 1 +
TemporalioSamples.sln | 20 +++-
src/Mutex/Program.cs | 8 +-
src/OpenTelemetry/Common/Activities.cs | 15 +++
.../Common/MyWorkflow.workflow.cs | 24 ++++
.../CoreSdkForwarding/Program.cs | 95 ++++++++++++++++
src/OpenTelemetry/CoreSdkForwarding/README.md | 41 +++++++
...les.OpenTelemetry.CoreSdkForwarding.csproj | 15 +++
.../CoreSdkForwarding/metrics-screenshot.png | Bin 0 -> 76465 bytes
.../CoreSdkForwarding/tracing-screenshot.png | Bin 0 -> 81073 bytes
src/OpenTelemetry/DotNetMetrics/Program.cs | 103 ++++++++++++++++++
src/OpenTelemetry/DotNetMetrics/README.md | 45 ++++++++
...Samples.OpenTelemetry.DotNetMetrics.csproj | 15 +++
.../client-metrics-screenshot.png | Bin 0 -> 74715 bytes
.../DotNetMetrics/tracing-screenshot.png | Bin 0 -> 81073 bytes
.../worker-metrics-screenshot.png | Bin 0 -> 87278 bytes
src/OpenTelemetry/README.md | 10 ++
src/OpenTelemetry/docker-compose.yaml | 8 ++
19 files changed, 397 insertions(+), 9 deletions(-)
create mode 100644 src/OpenTelemetry/Common/Activities.cs
create mode 100644 src/OpenTelemetry/Common/MyWorkflow.workflow.cs
create mode 100644 src/OpenTelemetry/CoreSdkForwarding/Program.cs
create mode 100644 src/OpenTelemetry/CoreSdkForwarding/README.md
create mode 100644 src/OpenTelemetry/CoreSdkForwarding/TemporalioSamples.OpenTelemetry.CoreSdkForwarding.csproj
create mode 100644 src/OpenTelemetry/CoreSdkForwarding/metrics-screenshot.png
create mode 100644 src/OpenTelemetry/CoreSdkForwarding/tracing-screenshot.png
create mode 100644 src/OpenTelemetry/DotNetMetrics/Program.cs
create mode 100644 src/OpenTelemetry/DotNetMetrics/README.md
create mode 100644 src/OpenTelemetry/DotNetMetrics/TemporalioSamples.OpenTelemetry.DotNetMetrics.csproj
create mode 100644 src/OpenTelemetry/DotNetMetrics/client-metrics-screenshot.png
create mode 100644 src/OpenTelemetry/DotNetMetrics/tracing-screenshot.png
create mode 100644 src/OpenTelemetry/DotNetMetrics/worker-metrics-screenshot.png
create mode 100644 src/OpenTelemetry/README.md
create mode 100644 src/OpenTelemetry/docker-compose.yaml
diff --git a/Directory.Build.props b/Directory.Build.props
index 853aa58..2bd770e 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -30,9 +30,9 @@
-
-
-
+
+
+
\ No newline at end of file
diff --git a/README.md b/README.md
index 5411f17..8e1d072 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@ Prerequisites:
* [DependencyInjection](src/DependencyInjection) - How to inject dependencies in activities and use generic hosts for workers
* [Encryption](src/Encryption) - End-to-end encryption with Temporal payload codecs.
* [Mutex](src/Mutex) - How to implement a mutex as a workflow. Demonstrates how to avoid race conditions or parallel mutually exclusive operations on the same resource.
+* [OpenTelemetry](src/OpenTelemetry) - Demonstrates how to set up OpenTelemetry tracing and metrics for both the client and worker, using both the .NET metrics API and internal forwarding from the Core SDK.
* [Patching](src/Patching) - Alter workflows safely with Patch and DeprecatePatch.
* [Polling](src/Polling) - Recommended implementation of an activity that needs to periodically poll an external resource waiting its successful completion.
* [SafeMessageHandlers](src/SafeMessageHandlers) - Use `Semaphore` to ensure operations are atomically processed in a workflow.
diff --git a/TemporalioSamples.sln b/TemporalioSamples.sln
index 0f5bfbb..a1a1c4f 100644
--- a/TemporalioSamples.sln
+++ b/TemporalioSamples.sln
@@ -51,9 +51,13 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TemporalioSamples.Mutex", "
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TemporalioSamples.Saga", "src\Saga\TemporalioSamples.Saga.csproj", "{B79F07F7-3429-4C58-84C3-08587F748B2D}"
EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TemporalioSamples.WorkflowUpdate", "src\WorkflowUpdate\TemporalioSamples.WorkflowUpdate.csproj", "{B3DB7B8C-7BD3-4A53-A809-AB6279B1A630}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TemporalioSamples.WorkflowUpdate", "src\WorkflowUpdate\TemporalioSamples.WorkflowUpdate.csproj", "{B3DB7B8C-7BD3-4A53-A809-AB6279B1A630}"
EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TemporalioSamples.ContextPropagation", "src\ContextPropagation\TemporalioSamples.ContextPropagation.csproj", "{7B797D20-485F-441D-8E71-AF7E315FA9CF}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TemporalioSamples.ContextPropagation", "src\ContextPropagation\TemporalioSamples.ContextPropagation.csproj", "{7B797D20-485F-441D-8E71-AF7E315FA9CF}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TemporalioSamples.OpenTelemetry.DotNetMetrics", "src\OpenTelemetry\DotNetMetrics\TemporalioSamples.OpenTelemetry.DotNetMetrics.csproj", "{6E32CC8F-7008-42A5-96A7-F182B9A6DC03}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TemporalioSamples.OpenTelemetry.CoreSdkForwarding", "src\OpenTelemetry\CoreSdkForwarding\TemporalioSamples.OpenTelemetry.CoreSdkForwarding.csproj", "{785AA9A8-C440-4A62-B778-FD52423A6EDF}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TemporalioSamples.SafeMessageHandlers", "src\SafeMessageHandlers\TemporalioSamples.SafeMessageHandlers.csproj", "{FAF5984A-5B1C-4686-B056-A4F2AC0E8EB7}"
EndProject
@@ -165,6 +169,18 @@ Global
{7B797D20-485F-441D-8E71-AF7E315FA9CF}.Debug|Any CPU.Build.0 = Debug|Any CPU
{7B797D20-485F-441D-8E71-AF7E315FA9CF}.Release|Any CPU.ActiveCfg = Release|Any CPU
{7B797D20-485F-441D-8E71-AF7E315FA9CF}.Release|Any CPU.Build.0 = Release|Any CPU
+ {CDFAD7B0-FC43-4ECD-9E36-1023322294C9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {CDFAD7B0-FC43-4ECD-9E36-1023322294C9}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {CDFAD7B0-FC43-4ECD-9E36-1023322294C9}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {CDFAD7B0-FC43-4ECD-9E36-1023322294C9}.Release|Any CPU.Build.0 = Release|Any CPU
+ {6E32CC8F-7008-42A5-96A7-F182B9A6DC03}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {6E32CC8F-7008-42A5-96A7-F182B9A6DC03}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {6E32CC8F-7008-42A5-96A7-F182B9A6DC03}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {6E32CC8F-7008-42A5-96A7-F182B9A6DC03}.Release|Any CPU.Build.0 = Release|Any CPU
+ {785AA9A8-C440-4A62-B778-FD52423A6EDF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {785AA9A8-C440-4A62-B778-FD52423A6EDF}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {785AA9A8-C440-4A62-B778-FD52423A6EDF}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {785AA9A8-C440-4A62-B778-FD52423A6EDF}.Release|Any CPU.Build.0 = Release|Any CPU
{FAF5984A-5B1C-4686-B056-A4F2AC0E8EB7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{FAF5984A-5B1C-4686-B056-A4F2AC0E8EB7}.Debug|Any CPU.Build.0 = Debug|Any CPU
{FAF5984A-5B1C-4686-B056-A4F2AC0E8EB7}.Release|Any CPU.ActiveCfg = Release|Any CPU
diff --git a/src/Mutex/Program.cs b/src/Mutex/Program.cs
index 5938215..3a3878f 100644
--- a/src/Mutex/Program.cs
+++ b/src/Mutex/Program.cs
@@ -39,13 +39,13 @@ async Task RunWorkerAsync()
}
}
-async Task ExecuteWorkflowsWithMutex(string resourceId)
+async Task ExecuteWorkflowsWithMutexAsync(string resourceId)
{
- await Task.WhenAll(Execute(), Execute());
+ await Task.WhenAll(ExecuteAsync(), ExecuteAsync());
return;
- async Task Execute()
+ async Task ExecuteAsync()
{
var workflowId = "test-" + Guid.NewGuid();
Console.WriteLine($"Starting test workflow with id '{workflowId}'. Connecting to lock workflow '{resourceId}'");
@@ -68,7 +68,7 @@ async Task Execute()
await RunWorkerAsync();
break;
case "workflow":
- await ExecuteWorkflowsWithMutex(args.ElementAtOrDefault(1) ?? "locked-resource-id");
+ await ExecuteWorkflowsWithMutexAsync(args.ElementAtOrDefault(1) ?? "locked-resource-id");
break;
default:
throw new ArgumentException("Must pass 'worker' or 'workflow' as the first argument");
diff --git a/src/OpenTelemetry/Common/Activities.cs b/src/OpenTelemetry/Common/Activities.cs
new file mode 100644
index 0000000..7ed9c36
--- /dev/null
+++ b/src/OpenTelemetry/Common/Activities.cs
@@ -0,0 +1,15 @@
+using Microsoft.Extensions.Logging;
+using Temporalio.Activities;
+
+namespace TemporalioSamples.OpenTelemetry.Common;
+
+public static class Activities
+{
+ [Activity]
+ public static void MyActivity(string input)
+ {
+ ActivityExecutionContext.Current.Logger.LogInformation("Executing activity for OpenTelemetry sample.");
+
+ ActivityExecutionContext.Current.MetricMeter.CreateCounter("my-activity-counter", description: "Counter used to instrument an activity.").Add(123);
+ }
+}
diff --git a/src/OpenTelemetry/Common/MyWorkflow.workflow.cs b/src/OpenTelemetry/Common/MyWorkflow.workflow.cs
new file mode 100644
index 0000000..62c7ea1
--- /dev/null
+++ b/src/OpenTelemetry/Common/MyWorkflow.workflow.cs
@@ -0,0 +1,24 @@
+namespace TemporalioSamples.OpenTelemetry.Common;
+
+using Microsoft.Extensions.Logging;
+using Temporalio.Workflows;
+
+[Workflow]
+public class MyWorkflow
+{
+ [WorkflowRun]
+ public async Task RunAsync()
+ {
+ Workflow.Logger.LogInformation("Running workflow {WorkflowId}.", Workflow.Info.WorkflowId);
+
+ Workflow.MetricMeter.CreateCounter("my-workflow-counter", description: "Replay-safe counter for instrumentation inside a workflow.").Add(123);
+ await Workflow.ExecuteActivityAsync(
+ () => Activities.MyActivity("input"),
+ new()
+ {
+ StartToCloseTimeout = TimeSpan.FromMinutes(5),
+ });
+
+ return "complete!";
+ }
+}
\ No newline at end of file
diff --git a/src/OpenTelemetry/CoreSdkForwarding/Program.cs b/src/OpenTelemetry/CoreSdkForwarding/Program.cs
new file mode 100644
index 0000000..6166ce4
--- /dev/null
+++ b/src/OpenTelemetry/CoreSdkForwarding/Program.cs
@@ -0,0 +1,95 @@
+using Microsoft.Extensions.Logging;
+using OpenTelemetry;
+using OpenTelemetry.Metrics;
+using OpenTelemetry.Resources;
+using OpenTelemetry.Trace;
+using Temporalio.Client;
+using Temporalio.Extensions.OpenTelemetry;
+using Temporalio.Runtime;
+using Temporalio.Worker;
+using TemporalioSamples.OpenTelemetry.Common;
+
+var assemblyName = typeof(TemporalClient).Assembly.GetName();
+
+var instanceId = args.ElementAtOrDefault(0) ?? throw new ArgumentException("Must pass 'worker' or 'workflow' as the single argument");
+
+var resourceBuilder = ResourceBuilder.
+ CreateDefault().
+ AddService("TemporalioSamples.OpenTelemetry", serviceInstanceId: instanceId);
+
+using var tracerProvider = Sdk.
+ CreateTracerProviderBuilder().
+ SetResourceBuilder(resourceBuilder).
+ AddSource(TracingInterceptor.ClientSource.Name, TracingInterceptor.WorkflowsSource.Name, TracingInterceptor.ActivitiesSource.Name).
+ AddOtlpExporter().
+ Build();
+
+// Create a client to localhost on default namespace
+var client = await TemporalClient.ConnectAsync(new("localhost:7233")
+{
+ LoggerFactory = LoggerFactory.Create(builder =>
+ builder.
+ AddSimpleConsole(options => options.TimestampFormat = "[HH:mm:ss] ").
+ SetMinimumLevel(LogLevel.Information)),
+ Interceptors = new[] { new TracingInterceptor() },
+ Runtime = new TemporalRuntime(new TemporalRuntimeOptions()
+ {
+ Telemetry = new TelemetryOptions()
+ {
+ Metrics = new MetricsOptions()
+ {
+ OpenTelemetry = new OpenTelemetryOptions()
+ {
+ Url = new Uri("http://localhost:4317"),
+ },
+ },
+ },
+ }),
+});
+
+async Task RunWorkerAsync()
+{
+ // Cancellation token cancelled on ctrl+c
+ using var tokenSource = new CancellationTokenSource();
+ Console.CancelKeyPress += (_, eventArgs) =>
+ {
+ tokenSource.Cancel();
+ eventArgs.Cancel = true;
+ };
+
+ // Run worker until cancelled
+ Console.WriteLine("Running worker");
+ using var worker = new TemporalWorker(
+ client,
+ new TemporalWorkerOptions(taskQueue: "opentelemetry-sample-core-sdk-forwarding").
+ AddWorkflow().
+ AddActivity(Activities.MyActivity));
+ try
+ {
+ await worker.ExecuteAsync(tokenSource.Token);
+ }
+ catch (OperationCanceledException)
+ {
+ Console.WriteLine("Worker cancelled");
+ }
+}
+
+async Task ExecuteWorkflowAsync()
+{
+ Console.WriteLine("Executing workflow");
+ await client.ExecuteWorkflowAsync(
+ (MyWorkflow wf) => wf.RunAsync(),
+ new(id: "opentelemetry-sample-core-sdk-workflow-id", taskQueue: "opentelemetry-sample-core-sdk-forwarding"));
+}
+
+switch (args.ElementAtOrDefault(0))
+{
+ case "worker":
+ await RunWorkerAsync();
+ break;
+ case "workflow":
+ await ExecuteWorkflowAsync();
+ break;
+ default:
+ throw new ArgumentException("Must pass 'worker' or 'workflow' as the single argument");
+}
\ No newline at end of file
diff --git a/src/OpenTelemetry/CoreSdkForwarding/README.md b/src/OpenTelemetry/CoreSdkForwarding/README.md
new file mode 100644
index 0000000..c7286af
--- /dev/null
+++ b/src/OpenTelemetry/CoreSdkForwarding/README.md
@@ -0,0 +1,41 @@
+# OpenTelemetry - .Core SDK Forwarding
+
+This sample shows how to configure the SDK to forward metrics from the Core SDK.
+
+The main advantage over using .NET metrics is simplicity.
+
+This sample also shows how to configure custom metrics from both an activity and a workflow in a replay-safe manner.
+
+To run, first see [README.md](../../../README.md) for prerequisites.
+
+Then, run the following from [one directory up ](../docker-compose.yaml) to start the .NET Aspire Dashboard which will collect telemetry. The dashboard UI is available at http://localhost:18888.
+
+ docker compose up
+
+Then, run the following from this directory in a separate terminal to start the worker:
+
+ dotnet run worker
+
+Then in another terminal, run the workflow from this directory:
+
+ dotnet run workflow
+
+The workflow will complete.
+
+## Traces
+
+Traces can be viewed at http://localhost:18888/traces.
+
+You can select either `worker` or `workflow` for traces; both should show the same trace. The workflow should appear and when clicked, may look something like:
+
+
+
+## Metrics
+
+Metrics can be viewed by clicking the metrics tab on the dashboard.
+
+Select `temporal-core-sdk`.
+
+All metrics emitted by the Core SDK will be shown. It may look something like:
+
+
diff --git a/src/OpenTelemetry/CoreSdkForwarding/TemporalioSamples.OpenTelemetry.CoreSdkForwarding.csproj b/src/OpenTelemetry/CoreSdkForwarding/TemporalioSamples.OpenTelemetry.CoreSdkForwarding.csproj
new file mode 100644
index 0000000..88089f4
--- /dev/null
+++ b/src/OpenTelemetry/CoreSdkForwarding/TemporalioSamples.OpenTelemetry.CoreSdkForwarding.csproj
@@ -0,0 +1,15 @@
+
+
+
+ Exe
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src/OpenTelemetry/CoreSdkForwarding/metrics-screenshot.png b/src/OpenTelemetry/CoreSdkForwarding/metrics-screenshot.png
new file mode 100644
index 0000000000000000000000000000000000000000..279d02566fc879c91ae19de26a08897af2a3c50e
GIT binary patch
literal 76465
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