139 lines
6.3 KiB
Markdown
139 lines
6.3 KiB
Markdown
# OpenTelemetry .NET
|
|
|
|
[](https://gitter.im/open-telemetry/opentelemetry-dotnet)
|
|
[](https://github.com/open-telemetry/opentelemetry-dotnet/actions)
|
|
[](https://github.com/open-telemetry/opentelemetry-dotnet/releases/)
|
|
[](https://www.nuget.org/profiles/OpenTelemetry)
|
|
[](https://www.nuget.org/profiles/OpenTelemetry)
|
|
|
|
The .NET [OpenTelemetry](https://opentelemetry.io/) client.
|
|
|
|
## Supported .NET Versions
|
|
|
|
Packages shipped from this repository generally support all the officially
|
|
supported versions of [.NET
|
|
Core](https://dotnet.microsoft.com/download/dotnet-core), and [.NET
|
|
Framework](https://dotnet.microsoft.com/download/dotnet-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 [get started in 5
|
|
minutes](./docs/trace/getting-started/README.md).
|
|
|
|
This repository includes multiple installable components, available on
|
|
[NuGet](https://www.nuget.org/profiles/OpenTelemetry). 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](./src/OpenTelemetry.Api/README.md)
|
|
* [OpenTelemetry .NET SDK](./src/OpenTelemetry/README.md)
|
|
|
|
Here are the [instrumentation
|
|
libraries](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/glossary.md#instrumentation-library):
|
|
|
|
* [ASP.NET](./src/OpenTelemetry.Instrumentation.AspNet/README.md)
|
|
* [ASP.NET Core](./src/OpenTelemetry.Instrumentation.AspNetCore/README.md)
|
|
* [gRPC client](./src/OpenTelemetry.Instrumentation.GrpcNetClient/README.md)
|
|
* [HTTP clients](./src/OpenTelemetry.Instrumentation.Http/README.md)
|
|
* [Redis client](./src/OpenTelemetry.Instrumentation.StackExchangeRedis/README.md)
|
|
* [SQL client](./src/OpenTelemetry.Instrumentation.SqlClient/README.md)
|
|
|
|
Here are the [exporter
|
|
libraries](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/glossary.md#exporter-library):
|
|
|
|
* [Console](./src/OpenTelemetry.Exporter.Console/README.md)
|
|
* [In-memory](./src/OpenTelemetry.Exporter.InMemory/README.md)
|
|
* [Jaeger](./src/OpenTelemetry.Exporter.Jaeger/README.md)
|
|
* [OTLP](./src/OpenTelemetry.Exporter.OpenTelemetryProtocol/README.md)
|
|
(OpenTelemetry Protocol)
|
|
* [Prometheus](./src/OpenTelemetry.Exporter.Prometheus/README.md)
|
|
* [Zipkin](./src/OpenTelemetry.Exporter.Zipkin/README.md)
|
|
|
|
See the [OpenTelemetry registry](https://opentelemetry.io/registry/?s=net) 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](./docs/trace/extending-the-sdk/README.md#instrumentation-library)
|
|
* [Building a custom log
|
|
exporter/processor/sampler](./docs/logs/extending-the-sdk/README.md)
|
|
* [Building a custom trace
|
|
exporter/processor/sampler](./docs/trace/extending-the-sdk/README.md)
|
|
* [Correlating logs with traces](./docs/logs/correlation/README.md)
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](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](https://calendar.google.com/calendar/embed?src=google.com_b79e3e90j7bbsa2n2p5an5lf60%40group.calendar.google.com)
|
|
for specific dates.
|
|
|
|
Meetings take place via [Zoom video conference](https://zoom.us/j/8287234601).
|
|
|
|
Meeting notes are available as a public [Google
|
|
doc](https://docs.google.com/document/d/1yjjD6aBcLxlRazYrawukDgrhZMObwHARJbB9glWdHj8/edit?usp=sharing).
|
|
For edit access, get in touch on
|
|
[Gitter](https://gitter.im/open-telemetry/opentelemetry-dotnet).
|
|
|
|
Approvers
|
|
([@open-telemetry/dotnet-approvers](https://github.com/orgs/open-telemetry/teams/dotnet-approvers)):
|
|
|
|
* [Bruno Garcia](https://github.com/bruno-garcia), Sentry
|
|
* [Eddy Nakamura](https://github.com/eddynaka), Microsoft
|
|
* [Paulo Janotti](https://github.com/pjanotti), Splunk
|
|
* [Reiley Yang](https://github.com/reyang), Microsoft
|
|
|
|
*Find more about the approver role in [community
|
|
repository](https://github.com/open-telemetry/community/blob/master/community-membership.md#approver).*
|
|
|
|
Maintainers
|
|
([@open-telemetry/dotnet-maintainers](https://github.com/orgs/open-telemetry/teams/dotnet-maintainers)):
|
|
|
|
* [Cijo Thomas](https://github.com/cijothomas), Microsoft
|
|
* [Mike Goldsmith](https://github.com/MikeGoldsmith), Honeycomb
|
|
* [Mikel Blanchard](https://github.com/CodeBlanch), CoStar Group
|
|
* [Sergey Kanzhelev](https://github.com/SergeyKanzhelev), Google
|
|
|
|
*Find more about the maintainer role in [community
|
|
repository](https://github.com/open-telemetry/community/blob/master/community-membership.md#maintainer).*
|
|
|
|
### Thanks to all the people who have contributed
|
|
|
|
[](https://github.com/open-telemetry/opentelemetry-dotnet/graphs/contributors)
|
|
|
|
## 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](https://github.com/open-telemetry/opentelemetry-dotnet/releases) for
|
|
existing releases.
|
|
|
|
See the [project
|
|
milestones](https://github.com/open-telemetry/opentelemetry-dotnet/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](https://www.myget.org/F/opentelemetry/api/v3/index.json).
|