The .NET Core instrument agent for Apache SkyWalking
Switch branches/tags
Clone or download
Latest commit d503cb8 Nov 15, 2018
Permalink
Failed to load latest commit information.
.github Add GitHub template (#27) Apr 23, 2018
build [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018
cli/SkyWalking.DotNet.CLI Hotfix/dotnet store (#88) Oct 8, 2018
docs Update Supported-list.md (#65) Jul 3, 2018
protos @ 04e6eca Fix proto link (#12) Feb 27, 2018
sample [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018
src fix TraceSegmentRef code error (#105) Nov 15, 2018
test/SkyWalking.Core.Tests Provide automatic-agent (#85) Sep 28, 2018
.gitignore Fix proto link (#12) Feb 27, 2018
.gitmodules Replace physical proto folder by git submodule link (#8) Feb 23, 2018
CONTIBUTING.md Update README.md Apr 18, 2018
LICENSE Initial commit Feb 6, 2018
NuGet.config [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018
README.md Update README.md (#90) Oct 9, 2018
appveyor.yml [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018
build.cake Update appveyor-ci config (#6) Feb 17, 2018
build.ps1 Update appveyor-ci config (#6) Feb 17, 2018
generate_protos.bat [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018
generate_protos_linux.sh [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018
generate_protos_macos.sh [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018
skywalking-netcore.sln [SkyWalking DotNet CLI]Manage the SkyWalking .NET Core Agent in your … Oct 8, 2018

README.md

SkyWalking C#/.NET instrument agent

Sky Walking logo

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

Twitter Follow

Build status

Supported

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 Collector

Requirements

  • SkyWalking Collector 5.0.0-beta or higher. See SkyWalking backend deploy docs.

Install SkyWalking .NET Core Agent

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

// install SkyWalking DotNet CLI
dotnet tool install -g SkyWalking.DotNet.CLI

On windows, run as Administrator

dotnet skywalking install

On macOS/Linux

sudo dotnet skywalking install

How to use

Set the ASPNETCORE_HOSTINGSTARTUPASSEMBLIES and DOTNET_ADDITIONAL_DEPS environment variables to support the activation of the SkyWalking .NET Core Agent.

  • Add the assembly name of SkyWalking.Agent.AspNetCore to the ASPNETCORE_HOSTINGSTARTUPASSEMBLIES environment variable.
  • On Windows, set the DOTNET_ADDITIONAL_DEPS environment variable to %PROGRAMFILES%\dotnet\x64\additionalDeps\skywalking.agent.aspnetcore. On macOS/Linux, set the DOTNET_ADDITIONAL_DEPS environment variable to /usr/local/share/dotnet/x64/additionalDeps/skywalking.agent.aspnetcore.

Examples

  • On windows
dotnet new mvc -n sampleapp
cd sampleapp

// enable SkyWalking.Agent.AspNetCore
set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyWalking.Agent.AspNetCore
set DOTNET_ADDITIONAL_DEPS=%PROGRAMFILES%\dotnet\x64\additionalDeps\skywalking.agent.aspnetcore

// set Application_Code
set SKYWALKING__APPLICATIONCODE=sample_app

dotnet run
  • On macOS/Linux
dotnet new mvc -n sampleapp
cd sampleapp

// enable SkyWalking.Agent.AspNetCore
export ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyWalking.Agent.AspNetCore
export DOTNET_ADDITIONAL_DEPS=/usr/local/share/dotnet/x64/additionalDeps/skywalking.agent.aspnetcore

// set Application_Code
export SKYWALKING__APPLICATIONCODE=sample_app

dotnet run

Configuration

Use dotnet skywalking config [your_application_code] [your_collector_server] to generate config file. Example

dotnet skywalking config sample_app 192.168.0.1:11800

Contributing

This section is in progress here: Contributing to skywalking-netcore

Contact Us

  • Submit an issue
  • Gitter English
  • QQ Group(cn): 392443393

License

Apache 2.0 License.