MultiplayerOpentelemetryTest 1.0.16

Multiplayer Opentelemetry .Net

============================================================================

Introduction

The multiplayer-opentelemetry module integrates OpenTelemetry with the Multiplayer platform to enable seamless trace collection and analysis. This library helps developers monitor, debug, and document application performance with detailed trace data. It supports flexible trace ID generation, sampling strategies.

Installation

To install the multiplayer-opentelemetry module, use the following command:

dotnet add package MultiplayerOpentelemetry

Multiplayer Http Trace Exporter

using Multiplayer.OpenTelemetry.Exporter;
using Multiplayer.OpenTelemetry.Trace;

const string MULTIPLAYER_OTLP_KEY = "<multiplayer-key>";
// ...
builder.Services.AddOpenTelemetry().WithTracing(tracing => {
    tracing.AddProcessor(
        new SimpleActivityExportProcessor(
            new MultiplayerOtlpHttpTracesExporter(
                MULTIPLAYER_OTLP_KEY
            )
        )
    );
});

Multiplayer Http Log Exporter

using Multiplayer.OpenTelemetry.Exporter;
using Multiplayer.OpenTelemetry.Trace;

const string MULTIPLAYER_OTLP_KEY = "<multiplayer-key>";
// ...
builder.Services.AddOpenTelemetry().WithLogging(logs => {
    logs.AddProcessor(
        new BatchLogRecordExportProcessor(
            new MultiplayerOtlpHttpLogsExporter(MULTIPLAYER_OTLP_KEY)
        )
    );
});

Multiplayer Grpc Trace Exporter

using Multiplayer.OpenTelemetry.Exporter;
using Multiplayer.OpenTelemetry.Trace;

const string MULTIPLAYER_OTLP_KEY = "<multiplayer-key>";
// ...
builder.Services.AddOpenTelemetry().WithTracing(tracing => {
    tracing.AddProcessor(
        new SimpleActivityExportProcessor(
            new MultiplayerOtlpGrpcTracesExporter(
                MULTIPLAYER_OTLP_KEY
            )
        )
    );
});

Multiplayer Grpc Log Exporter

using Multiplayer.OpenTelemetry.Exporter;
using Multiplayer.OpenTelemetry.Trace;

const string MULTIPLAYER_OTLP_KEY = "<multiplayer-key>";
// ...
builder.Services.AddOpenTelemetry().WithLogging(logs => {
    logs.AddProcessor(
        new BatchLogRecordExportProcessor(
            new MultiplayerOtlpGrpcLogsExporter(MULTIPLAYER_OTLP_KEY)
        )
    );
});

Multiplayer trace Id generator

using Multiplayer.OpenTelemetry.Exporter;
using Multiplayer.OpenTelemetry.Trace;

// NOTE: this will set 3% of the traces for auto documentation
MultiplayerTraceIdConfiguration.ConfigureMultiplayerTraceIdGenerator(0.03);

// or

Activity.TraceIdGenerator = new Func<ActivityTraceId>(() => MultiplayerTraceIdGenerator.GenerateMultiplayerTraceId(docSpanSampler));

Multiplayer trace id ratio based sampler

using Multiplayer.OpenTelemetry.Exporter;
using Multiplayer.OpenTelemetry.Trace;

// ...

// NOTE: this config will send 5% of all traces
builder.Services.AddOpenTelemetry().WithTracing(tracing => {
    tracing.SetSampler(new MultiplayerTraceIdRatioBasedSampler(0.05));
});