Prepares X-Ray UDP Exporter v1.0.0 release (#217)

Author: jj22ee

.github/workflows/release-udp-exporter.yml

@@ -95,7 +95,7 @@ jobs:
       - name: Create Release Notes
         run: |
           @"
-          # AWS Distro for OpenTelemetry X-Ray UDP Exporter v${{ github.event.inputs.version }}-${{ steps.commit.outputs.sha_short }}
+          # AWS Distro for OpenTelemetry X-Ray UDP Exporter v${{ github.event.inputs.version }}
 
           ## Overview
           This release contains the AWS Distro for OpenTelemetry X-Ray UDP Exporter for .NET.
@@ -130,7 +130,7 @@ jobs:
         run: |
           gh release create `
             --target "$env:GITHUB_REF_NAME" `
-            --title "ADOT OTLP UDP Exporter v${{ github.event.inputs.version }}-${{ steps.commit.outputs.sha_short }}" `
+            --title "Release ADOT X-Ray UDP Exporter v${{ github.event.inputs.version }}" `
             --notes-file release_notes.md `
             --draft `
             "Exporter.Xray.Udp-${{ github.event.inputs.version }}" `

exporters/AWS.Distro.OpenTelemetry.Exporter.Xray.Udp/AWS.Distro.OpenTelemetry.Exporter.Xray.Udp.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <Version>0.1.0</Version>
+    <Version>1.0.0</Version>
     <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
     <TargetFrameworks>net8.0</TargetFrameworks>
     <TargetFrameworks Condition="$(OS) == 'Windows_NT'">$(TargetFrameworks);net462</TargetFrameworks>
@@ -22,6 +22,19 @@
     <PackageReference Include="Microsoft.Extensions.Logging" Version="9.0.0" />
   </ItemGroup>
 
+  <PropertyGroup Condition=" '$(_IsPacking)' == 'true' ">
+    <!-- NuGet packages -->
+    <IsPackable>true</IsPackable>
+    <PackageProjectUrl>https://github.com/aws-observability/aws-otel-dotnet-instrumentation/</PackageProjectUrl>
+    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
+    <PackageReadmeFile>docs/readme.md</PackageReadmeFile>
+    <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
+    <PackageReleaseNotes>See release notes at https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases</PackageReleaseNotes>
+    <PackageTags>OpenTelemetry;OTEL;tracing;Lambda;AWS</PackageTags>
+    <RepositoryType>git</RepositoryType>
+    <RepositoryUrl>https://github.com/aws-observability/aws-otel-dotnet-instrumentation.git</RepositoryUrl>
+  </PropertyGroup>
+
   <!-- Items that are only added when building the NuGet package -->
   <ItemGroup Condition=" '$(_IsPacking)' == 'true' ">
     <None Include="nuget-readme.md" Pack="true" PackagePath="\docs\readme.md" />

exporters/AWS.Distro.OpenTelemetry.Exporter.Xray.Udp/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Release History: AWS.Distro.OpenTelemetry.Exporter.Xray.Udp
+
+### v1.0.0 / 2025-05-15
+
+* Initial release

exporters/AWS.Distro.OpenTelemetry.Exporter.Xray.Udp/nuget-readme.md

@@ -1,43 +1,33 @@
 # AWS Distro for OpenTelemetry X-Ray UDP Exporter
-The AWS Distro for OpenTelemetry X-Ray UDP Exporter allows you to send OpenTelemetry traces to the AWS X-Ray daemon over UDP.
+The AWS Distro for OpenTelemetry X-Ray UDP Exporter allows you to send OpenTelemetry traces to the AWS X-Ray Daemon endpoint in Lambda environments over UDP.
 
 ## Installation
 ```console
 dotnet add package AWS.Distro.OpenTelemetry.Exporter.Xray.Udp
 ```
 
 ## Prerequisites
-- .NET 6.0 or higher
+- .NET 8.0 or higher
 
 ## Usage Example
-```c
-var resourceBuilder = ResourceBuilder.CreateDefault().AddTelemetrySdk();
+```c#
+    // AWS_LAMBDA_FUNCTION_NAME Environment Variable will be defined in AWS Lambda Environment
+    private static String serviceName = Environment.GetEnvironmentVariable("AWS_LAMBDA_FUNCTION_NAME");
+    private static ResourceBuilder resourceBuilder = ResourceBuilder
+        .CreateDefault()
+        .AddService(serviceName);
 
-Sdk.CreateTracerProviderBuilder()
-    .AddSource("dotnet-sample-app")
-    .SetResourceBuilder(resourceBuilder)
-    .AddAspNetCoreInstrumentation()
-    .AddHttpClientInstrumentation()
-    // Add the X-Ray UDP Exporter
-    .AddXrayUdpExporter(resourceBuilder.Build(), "localhost:2000")
-    .Build();
-```
-
-## ASP.NET Core Integration
-```c
-// In Program.cs
-builder.Services.AddOpenTelemetry()
-    .WithTracing(builder =>
-     {
-         var resourceBuilder = ResourceBuilder.CreateDefault()
-         .AddService("my-service")
-         .AddTelemetrySdk();
-
-         builder
-         .SetResourceBuilder(resourceBuilder)
-         .AddAspNetCoreInstrumentation()
-         .AddXrayUdpExporter(resourceBuilder.Build(), "localhost:2000");
-     });
+    TracerProvider tracerProvider = Sdk.CreateTracerProviderBuilder()
+        .AddAWSLambdaConfigurations()
+        .SetSampler(new ParentBasedSampler(new AlwaysOnSampler()))
+        .AddAWSInstrumentation()
+        .AddProcessor(
+            new SimpleActivityExportProcessor(
+                // Add the X-Ray UDP Exporter
+                new XrayUdpExporter(resourceBuilder.Build())
+            )
+        )
+        .Build();
 ```
 
 ## License