The .NET/.NET Core instrument agent for Apache SkyWalking
SkyAPM C#/.NET instrument agent
SkyAPM-dotnet is a community, open-source C#/.NET auto-instrumentation agent for the .NET ecosystem. It provides distributed tracing, application topology, and metrics for ASP.NET Core and .NET applications, and reports the collected telemetry to an Apache SkyWalking backend over the sw8 / v8 protocol. It is an independent project and is not affiliated with or endorsed by the Apache Software Foundation.
📖 Documentation
Full documentation lives at skyapm.github.io/SkyAPM-dotnet — getting started, installation & activation, the complete configuration reference (EN / 中文), transports (gRPC / Kafka), the supported-component list, plugins, logging, the CLI, and troubleshooting.
CI Build Status
NuGet Packages
| Package Name | NuGet | Downloads |
|---|---|---|
| SkyAPM.Agent.AspNetCore |  |
 |
| SkyAPM.Agent.GeneralHost |  |
 |
Quick start
Supported runtimes: net8.0 and net10.0.
dotnet add package SkyApm.Agent.AspNetCore
export ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyApm.Agent.AspNetCore
export SKYWALKING__SERVICENAME=my_service
dotnet run
See Getting Started for the full walkthrough, and the Configuration reference for every option.
Contributing
See Contributing to SkyAPM-dotnet.
Contact Us
- Submit an issue on this repository for questions about the .NET agent.
For questions about the SkyWalking protocol or its backend/UI, use the official Apache SkyWalking channels (these are not suitable for the .NET agent):
- Submit an official Apache SkyWalking issue.
- Mail list: dev@skywalking.apache.org. Mail to
dev-subscribe@skywalking.apache.org, follow the reply to subscribe the mail list. - Send
Request to join SkyWalking slackmail to the mail list (dev@skywalking.apache.org), we will invite you in. - For Chinese speaker, send
[CN] Request to join SkyWalking slackmail to the mail list (dev@skywalking.apache.org), we will invite you in.