Arkanis.Common.Observability 1.0.0-dev.1

This is a prerelease version of Arkanis.Common.Observability.
dotnet add package Arkanis.Common.Observability --version 1.0.0-dev.1
                    
NuGet\Install-Package Arkanis.Common.Observability -Version 1.0.0-dev.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Arkanis.Common.Observability" Version="1.0.0-dev.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Arkanis.Common.Observability" Version="1.0.0-dev.1" />
                    
Directory.Packages.props
<PackageReference Include="Arkanis.Common.Observability" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Arkanis.Common.Observability --version 1.0.0-dev.1
                    
#r "nuget: Arkanis.Common.Observability, 1.0.0-dev.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Arkanis.Common.Observability@1.0.0-dev.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Arkanis.Common.Observability&version=1.0.0-dev.1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Arkanis.Common.Observability&version=1.0.0-dev.1&prerelease
                    
Install as a Cake Tool

Arkanis.Common.Observability

Shared metrics, telemetry, and logging constructs for Arkanis services and libraries. This package provides typed names for telemetry sources, metric meters, low-cardinality metric tags, structured log properties, logging events, and shared OpenTelemetry configuration parsing without configuring any hosting or exporter pipeline.

Installation

dotnet add package Arkanis.Common.Observability

Usage

using Arkanis.Common.Observability;

var sources = new TelemetrySourceNameCollection
{
    "Arkanis.Example.Workflows",
};

var meters = new MetricMeterNameCollection
{
    "Arkanis.Example",
};

var metricTags = new MetricTagNameCollection
{
    "operation",
    "result",
};

var logProperties = new LoggingPropertyNameCollection
{
    "OperationName",
    "ResourceName",
};

EventId eventId = new LoggingEventId(1000, "ExampleStarted");

var protocol = OpenTelemetryProtocolParser.Parse("http/protobuf");

Metric tags should stay low-cardinality. Put operation IDs, correlation IDs, account IDs, user IDs, guild IDs, request IDs, and other high-cardinality values on activities, baggage, logging scopes, or structured log properties instead.

Scope

This package intentionally does not register OpenTelemetry, logging providers, exporters, or meters. The OTLP protocol parser is a shared configuration helper only. Applications and service-default packages own runtime configuration.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Arkanis.Common.Observability:

Package Downloads
Arkanis.Common.Aspire.ServiceDefaults

Reusable Aspire-style service defaults for OpenTelemetry, service discovery, HTTP resilience, and health endpoints.

Arkanis.Common.Observability.Serilog

Shared Serilog bootstrap and host-registration defaults for Arkanis services and libraries.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-dev.1 47 7/9/2026