Trace Azure Functions with OpenTelemetry .NET

To ingest gRPC via the Dynatrace Trace API, you need to use an OpenTelemetry collector between Dynatrace and the exporter.

If you use environment variables for setup, you need to set the following value:

• For OTEL_EXPORTER_OTLP_PROTOCOL: grpc

Configure the OpenTelemetry Collector

To ingest gRPC via the Dynatrace Trace API, you need to use an OpenTelemetry collector between Dynatrace and the exporter.

The OpenTelemetry Collector is available as a Docker image. To use this collector to export trace data to Dynatrace, you need to customize the configuration using the OpenTelemetry OTLP exporter.

Here is a sample configuration file:

yamlcopydownload
receivers:
  otlp:
    protocols:
      grpc:
exporters:
  otlphttp:
    endpoint: "https://<YOUR-TENANT-ID>.live.dynatrace.com/api/v2/otlp"
    headers: {"Authorization": "Api-Token <YOUR-DYNATRACE-API-TOKEN>"}
service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [otlphttp]

For further details on configuration, see Send OpenTelemetry trace data to Dynatrace.

To ingest HTTP via the Dynatrace Trace API, you need to configure the exporter. The exporter will then directly send traces to the configured endpoint.

If you use environment variables for setup, you need to set the following values:

• For OTEL_EXPORTER_OTLP_PROTOCOL: http/protobuf

• For OTEL_EXPORTER_OTLP_ENDPOINT: the URL for export endpoint

  Notes:

  • If you set the endpoint URL via environment variables, the export endpoints for traces and metrics are automatically appended by v1/traces for traces and v1/metrics for metrics. For example, if the endpoint is set to https://<YOUR-TENANT-ID>.live.dynatrace.com/api/v2/otlp, traces will be exported to https://<YOUR-TENANT-ID>.live.dynatrace.com/api/v2/otlp/v1/traces.
  • If you set the endpoint explicitly in code, it will be used as is.

  For details, see Endpoint URLs for OTLP/HTTP.

• For OTEL_EXPORTER_OTLP_HEADERS: the authorization API token value in the following format: Authorization=Api-Token <TOKEN>.

Note: If you don't set the Protocol property of the OtlpExporterOptions class via environment variables or in code, it will be initialized as OtlpExportProtocol.Grpc by default.

c#copydownload
public class Startup : FunctionsStartup
{
    public override void Configure(IFunctionsHostBuilder builder)
    {
        string activitySource = "[activitySource]";
        string serviceName = "[serviceName]";
        string collectorUrl = "[collectorUrl]"  // Points to the running collector, configured before.

        builder.Services.AddSingleton((builder) =>
        {
            return Sdk.CreateTracerProviderBuilder()
                .SetSampler(new AlwaysOnSampler())
                .AddSource(activitySource)
                .SetResourceBuilder(ResourceBuilder.CreateDefault().AddService(serviceName))
                .AddHttpClientInstrumentation(op =>
                {
                    // Exclude frequent calls generated by Azure Application Insights
                    op.Filter = (req) => !req.RequestUri.AbsoluteUri.Contains("visualstudio");
                })
                .AddOtlpExporter(otlpOptions =>
                {
                    otlpOptions.Endpoint = new Uri(collectorUrl);
                })
                .Build();
        });
    }
}

The code sample using HTTP exporter is similar to the gRPC exporter sample; the only difference is in the configuration of OtlpExporterOptions:

c#copydownload
return Sdk.CreateTracerProviderBuilder()
     // ...
     // ... other initialization code (see the code snippet for the gRPC case)
     // ...
    .AddOtlpExporter(otlpOptions =>
    {
        otlpOptions.Protocol = OtlpExportProtocol.HttpProtobuf;
        otlpOptions.Headers = "Authorization=Api-Token <TOKEN>";

        //Use an explicitly set endpoint for export
        //or an endpoint configured via environment variable.
        otlpOptions.Endpoint = new Uri("https://<YOUR-TENANT-ID>.live.dynatrace.com/api/v2/otlp");
    })
    .Build();

If the configuration is done via environment variables, the code for adding an OTLP/HTTP exporter is even simpler:

c#copydownload
return Sdk.CreateTracerProviderBuilder()
     // ...
     // ... other initialization code (see the code snippet for the gRPC case)
     // ...
    .AddOtlpExporter()
    .Build();