SkyAPM C#/.NET instrument agent

Apache SkyWalking is an APM designed for microservices, cloud native and container-based (Docker, K8s, Mesos) architectures. SkyAPM-dotnet provides the native support agent in C# and .NETStandard platform, with the helps from Apache SkyWalking committer team.

CI Build Status

Platform	Build Server	Master Status
AppVeyor	Windows/Linux

Nuget Packages

Package Name	NuGet	MyGet	Downloads
SkyAPM.Agent.AspNetCore
SkyAPM.Agent.AspNet
SkyAPM.Agent.GeneralHost

MyGet feed URL https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

Supported

This project currently supports apps targeting netcoreapp2.0/netframework4.6.1 or higher.
Supported middlewares, frameworks and libraries.

Features

A quick list of SkyWalking .NET Core Agent's capabilities

Application Topology
Distributed Tracing
ASP.NET Core Diagnostics
HttpClient Diagnostics
EntityFrameworkCore Diagnostics

Getting Started

Deploy SkyWalking Backend And UI

Requirements

Start with v1.0.0, SkyAPM .NET Core Agent will only support SkyWalking 8.0 or higher. The SkyWalking deployment doc is here. If you are new user, recommand you to read the whole official documents
If you are using Skywalking 7.0 or lower, you should use the SkyAPM .NET Core Agent v0.9.0 packages.

Install SkyWalking .NET Core Agent

You can run the following command to install the SkyWalking .NET Core Agent in your project.

dotnet add package SkyAPM.Agent.AspNetCore

How to use

Set the ASPNETCORE_HOSTINGSTARTUPASSEMBLIES environment variable to support the activation of the SkyAPM .NET Core Agent.

Add the assembly name of SkyAPM.Agent.AspNetCore to the ASPNETCORE_HOSTINGSTARTUPASSEMBLIES environment variable.

Examples

On windows

dotnet new mvc -n sampleapp
cd sampleapp
dotnet add package SkyAPM.Agent.AspNetCore
set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore
set SKYWALKING__SERVICENAME=sample_app
dotnet run

On macOS/Linux

dotnet new mvc -n sampleapp
cd sampleapp
dotnet add package SkyAPM.Agent.AspNetCore
export ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore
export SKYWALKING__SERVICENAME=sample_app
dotnet run

Configuration

Install SkyAPM.DotNet.CLI

dotnet tool install -g SkyAPM.DotNet.CLI

Use dotnet skyapm config [your_service_name] [your_servers] to generate config file.

dotnet skyapm config sample_app 192.168.0.1:11800

Roadmap

What are we going to do next?

Contributing

This section is in progress here: Contributing to SkyAPM-dotnet

Contact Us

Submit an issue

If you have issues about SkyWalking protocol, its official backend, ask questions at their Apache official channels. All following channels are not suitable for .net agent, but good if you are facing backend/UI issues.

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.
Join skywalking channel at Apache Slack. If the link is not working, find the latest one at Apache INFRA WIKI.
QQ Group: 392443393(2000/2000, not available), 901167865(available)

License

Apache 2.0 License.

zeaposs/SkyAPM-dotnet