OpenTelemetry .NET

The .NET OpenTelemetry client.

Supported .NET Versions

Packages shipped from this repository generally support all the officially
supported versions of .NET
Core, and .NET
Framework except for
.NET Framework 3.5 SP1. Any exceptions to this are noted in the individual
README.md files.

Getting Started

If you are new here, please see getting started docs for
logs,
metrics, and
trace.

This repository includes multiple installable components, available on
NuGet. Each component has its
individual README.md file, which covers the instruction on how to install and
how to get started. To find all the available components, please take a look at
the src folder.

Here are the most commonly used components:

• OpenTelemetry .NET API
• OpenTelemetry .NET SDK

Here are the instrumentation
libraries:

• ASP.NET
• ASP.NET Core
• gRPC client
• HTTP clients
• Redis client
• SQL client

Here are the exporter
libraries:

• Console
• In-memory
• Jaeger
• OTLP
  (OpenTelemetry Protocol)
• Prometheus
• Zipkin

See the OpenTelemetry registry for
more exporters.

Customization

OpenTelemetry .NET is designed to be customizable and extensible. Here are the
most common customization and extension scenarios:

• Building a custom instrumentation
  library
• Building a custom log
  exporter/processor/sampler
• Building a custom trace
  exporter/processor/sampler

Contributing

See CONTRIBUTING.md

We meet weekly on Tuesdays, and the time of the meeting alternates between 11AM
PT and 4PM PT. The meeting is subject to change depending on contributors'
availability. Check the OpenTelemetry community
calendar
for specific dates.

Meetings take place via Zoom video conference.

Meeting notes are available as a public Google
doc.
For edit access, get in touch on
Gitter.

Approvers
(@open-telemetry/dotnet-approvers):

• Bruno Garcia, Sentry
• Eddy Nakamura, Microsoft
• Paulo Janotti, Splunk
• Reiley Yang, Microsoft

Find more about the approver role in community
repository.

Maintainers
(@open-telemetry/dotnet-maintainers):

• Alan West, New Relic
• Cijo Thomas, Microsoft
• Mike Goldsmith, Honeycomb
• Mikel Blanchard, CoStar Group
• Sergey Kanzhelev, Google

Find more about the maintainer role in community
repository.

Thanks to all the people who have contributed

Release Schedule

OpenTelemetry .NET is under active development.

The library is not yet generally available, and releases aren't guaranteed to
conform to a specific version of the specification. Future releases will not
attempt to maintain backwards compatibility with previous releases. Each alpha
and beta release includes significant changes to the API and SDK packages,
making them incompatible with each other.

See the release
notes for
existing releases.

See the project
milestones
for details on upcoming releases. The dates and features described in issues
and milestones are estimates, and subject to change.

Daily builds from this repo are published to MyGet, and can be installed from
this source.