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 slack mail to the mail list (dev@skywalking.apache.org), we will invite you in.
• For Chinese speaker, send [CN] Request to join SkyWalking slack mail to the mail list (dev@skywalking.apache.org), we will invite you in.

License

Apache 2.0 License.