skyapm-dotnet - SkyAPM.Agent.AspNet 1.3.0

SkyAPM ASP.NET Agent.

PM> Install-Package SkyAPM.Agent.AspNet -Version 1.3.0 -Source https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

Copy to clipboard

> nuget.exe install SkyAPM.Agent.AspNet -Version 1.3.0 -Source https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

Copy to clipboard

> dotnet add package SkyAPM.Agent.AspNet --version 1.3.0 --source https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

Copy to clipboard
<PackageReference Include="SkyAPM.Agent.AspNet" Version="1.3.0" />
Copy to clipboard
source https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

nuget SkyAPM.Agent.AspNet  ~> 1.3.0
Copy to clipboard

> choco install SkyAPM.Agent.AspNet --version 1.3.0 --source https://www.myget.org/F/skyapm-dotnet/api/v2

Copy to clipboard
Import-Module PowerShellGet
Register-PSRepository -Name "skyapm-dotnet" -SourceLocation "https://www.myget.org/F/skyapm-dotnet/api/v2"
Install-Module -Name "SkyAPM.Agent.AspNet" -RequiredVersion "1.3.0" -Repository "skyapm-dotnet" 
Copy to clipboard

SkyAPM C#/.NET instrument agent

Sky Walking logo

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.

issues pulls releases Gitter Twitter Follow

CI Build Status

Platform Build Server Master Status
AppVeyor Windows/Linux Build status

Nuget Packages

Package Name NuGet MyGet Downloads
SkyAPM.Agent.AspNetCore nuget myget stats
SkyAPM.Agent.AspNet nuget myget
SkyAPM.Agent.GeneralHost nuget myget

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

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 Backend And UI

Requirements

Start with v1.0.0, SkyAPM .NET Core Agent only supports SkyWalking 8.0 or higher. The SkyWalking doc is here.

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.

  • .NETFramework 4.6.1
    • CommonServiceLocator (>= 2.0.5)
    • Microsoft.Extensions.Configuration (>= 3.1.0)
    • Microsoft.Extensions.DependencyInjection (>= 3.1.0)
    • Microsoft.Web.Infrastructure (>= 1.0.0)
    • SkyAPM.Core (>= 1.3.0)
    • SkyAPM.Transport.Grpc (>= 1.3.0)
    • SkyAPM.Utilities.Configuration (>= 1.3.0)
    • SkyAPM.Utilities.DependencyInjection (>= 1.3.0)
    • SkyAPM.Utilities.Logging (>= 1.3.0)
  • .NETFramework 4.6.2
    • CommonServiceLocator (>= 2.0.5)
    • Microsoft.Extensions.Configuration (>= 3.1.0)
    • Microsoft.Extensions.DependencyInjection (>= 3.1.0)
    • Microsoft.Web.Infrastructure (>= 1.0.0)
    • SkyAPM.Core (>= 1.3.0)
    • SkyAPM.Transport.Grpc (>= 1.3.0)
    • SkyAPM.Utilities.Configuration (>= 1.3.0)
    • SkyAPM.Utilities.DependencyInjection (>= 1.3.0)
    • SkyAPM.Utilities.Logging (>= 1.3.0)
  • .NETFramework 4.7
    • CommonServiceLocator (>= 2.0.5)
    • Microsoft.Extensions.Configuration (>= 3.1.0)
    • Microsoft.Extensions.DependencyInjection (>= 3.1.0)
    • Microsoft.Web.Infrastructure (>= 1.0.0)
    • SkyAPM.Core (>= 1.3.0)
    • SkyAPM.Transport.Grpc (>= 1.3.0)
    • SkyAPM.Utilities.Configuration (>= 1.3.0)
    • SkyAPM.Utilities.DependencyInjection (>= 1.3.0)
    • SkyAPM.Utilities.Logging (>= 1.3.0)
  • .NETFramework 4.7.1
    • CommonServiceLocator (>= 2.0.5)
    • Microsoft.Extensions.Configuration (>= 3.1.0)
    • Microsoft.Extensions.DependencyInjection (>= 3.1.0)
    • Microsoft.Web.Infrastructure (>= 1.0.0)
    • SkyAPM.Core (>= 1.3.0)
    • SkyAPM.Transport.Grpc (>= 1.3.0)
    • SkyAPM.Utilities.Configuration (>= 1.3.0)
    • SkyAPM.Utilities.DependencyInjection (>= 1.3.0)
    • SkyAPM.Utilities.Logging (>= 1.3.0)
  • .NETFramework 4.6.1: 4.6.1.0
  • .NETFramework 4.6.2: 4.6.2.0
  • .NETFramework 4.7: 4.7.0.0
  • .NETFramework 4.7.1: 4.7.1.0

Owners

liuhaoyang

Authors

SkyAPM Team

Project URL

https://github.com/SkyAPM/SkyAPM-dotnet

License

Apache-2.0

Tags

SkyWalking APM Tracing

Info

48 total downloads
0 downloads for version 1.3.0
Download (41.54 KB)
Found on the current feed only

Package history

Version Size Last updated Downloads Mirrored?
1.4.0-prerelease-146741176 41.78 KB Thu, 26 Aug 2021 09:29:55 GMT 0
1.4.0-prerelease-146123254 41.8 KB Thu, 19 Aug 2021 05:51:05 GMT 0
1.4.0-prerelease-140067005 41.74 KB Thu, 10 Jun 2021 03:33:51 GMT 1
1.3.0 41.54 KB Sat, 15 May 2021 13:57:39 GMT 0
1.3.0-prerelease-139828452 41.75 KB Mon, 07 Jun 2021 09:17:56 GMT 0
1.3.0-prerelease-135868979 41.75 KB Thu, 22 Apr 2021 13:26:34 GMT 0
1.3.0-prerelease-135775092 41.75 KB Wed, 21 Apr 2021 11:21:51 GMT 0
1.3.0-prerelease-135740515 40.6 KB Wed, 21 Apr 2021 01:45:23 GMT 0
1.3.0-prerelease-135405305 40.58 KB Sat, 17 Apr 2021 04:38:37 GMT 0
1.3.0-prerelease-135229613 40.6 KB Thu, 15 Apr 2021 03:50:16 GMT 0
1.3.0-prerelease-135002134 40.6 KB Mon, 12 Apr 2021 12:39:23 GMT 0
1.3.0-prerelease-133496315 40.6 KB Fri, 26 Mar 2021 02:22:08 GMT 0
1.3.0-prerelease-133452705 40.61 KB Thu, 25 Mar 2021 14:15:51 GMT 0
1.3.0-prerelease-133106541 40.6 KB Sun, 21 Mar 2021 14:05:54 GMT 0
1.3.0-prerelease-132744088 40.43 KB Wed, 17 Mar 2021 09:25:17 GMT 0
1.3.0-prerelease-132637152 40.42 KB Tue, 16 Mar 2021 03:42:41 GMT 0
1.2.0 39.96 KB Thu, 28 Jan 2021 02:29:48 GMT 1
1.2.0-prerelease-132630978 40.41 KB Tue, 16 Mar 2021 01:59:51 GMT 0
1.2.0-prerelease-132306462 40.4 KB Fri, 12 Mar 2021 07:51:13 GMT 0
1.2.0-prerelease-128571693 40.16 KB Thu, 28 Jan 2021 02:24:53 GMT 0
1.2.0-prerelease-128525104 40.15 KB Wed, 27 Jan 2021 13:28:48 GMT 0
1.1.0 39.96 KB Wed, 27 Jan 2021 06:51:34 GMT 4
1.1.0-prerelease-127794490 40.15 KB Tue, 19 Jan 2021 02:31:32 GMT 0
1.1.0-prerelease-127757645 40.17 KB Mon, 18 Jan 2021 16:17:47 GMT 0
1.1.0-prerelease-127382003 38.97 KB Thu, 14 Jan 2021 07:56:55 GMT 0
1.1.0-prerelease-127316744 38.98 KB Wed, 13 Jan 2021 13:49:18 GMT 0
1.1.0-prerelease-127191619 35.02 KB Tue, 12 Jan 2021 03:03:38 GMT 0
1.1.0-prerelease-125423619 35.04 KB Tue, 22 Dec 2020 15:56:54 GMT 0
1.1.0-prerelease-124351087 35.04 KB Thu, 10 Dec 2020 06:01:37 GMT 0
1.1.0-prerelease-124166147 35.04 KB Tue, 08 Dec 2020 02:39:04 GMT 0
1.1.0-prerelease-122978883 35.04 KB Tue, 24 Nov 2020 08:51:32 GMT 0
1.1.0-prerelease-122647710 35.02 KB Fri, 20 Nov 2020 12:52:07 GMT 1
1.1.0-prerelease-122624839 35.04 KB Fri, 20 Nov 2020 06:30:47 GMT 0
1.1.0-prerelease-122623114 35.03 KB Fri, 20 Nov 2020 06:01:50 GMT 0
1.1.0-prerelease-122538418 35.02 KB Thu, 19 Nov 2020 06:30:21 GMT 0
1.1.0-prerelease-122458508 35.04 KB Wed, 18 Nov 2020 08:18:28 GMT 0
1.0.0 34.51 KB Mon, 07 Sep 2020 15:04:58 GMT 14
1.0.0-prerelease-122456766 35.01 KB Wed, 18 Nov 2020 07:49:39 GMT 0
1.0.0-prerelease-122355518 35 KB Tue, 17 Nov 2020 03:41:47 GMT 0
1.0.0-prerelease-122355254 35.02 KB Tue, 17 Nov 2020 03:37:37 GMT 0
1.0.0-prerelease-120728802 34.79 KB Thu, 29 Oct 2020 07:49:50 GMT 1
1.0.0-prerelease-120649604 34.8 KB Wed, 28 Oct 2020 09:50:07 GMT 0
1.0.0-prerelease-119785914 34.72 KB Sun, 18 Oct 2020 09:54:59 GMT 0
1.0.0-prerelease-116259961 34.72 KB Mon, 07 Sep 2020 14:29:15 GMT 0
0.9.0 33.74 KB Sun, 30 Jun 2019 16:53:43 GMT 8
0.9.0-prerelease-98779874 35.06 KB Tue, 18 Feb 2020 06:54:32 GMT 1
0.9.0-prerelease-96270513 35.09 KB Mon, 20 Jan 2020 05:51:51 GMT 0
0.9.0-prerelease-96171846 35.09 KB Sun, 19 Jan 2020 02:26:48 GMT 0
0.9.0-prerelease-96005567 35.06 KB Fri, 17 Jan 2020 04:15:45 GMT 0
0.9.0-prerelease-95838124 35.09 KB Wed, 15 Jan 2020 05:45:08 GMT 0
0.9.0-prerelease-95011552 35.07 KB Sun, 05 Jan 2020 16:08:50 GMT 1
0.9.0-prerelease-94527380 35.06 KB Tue, 31 Dec 2019 01:38:59 GMT 1
0.9.0-prerelease-94302854 33.95 KB Sat, 28 Dec 2019 11:16:50 GMT 1
0.9.0-prerelease-94060027 33.94 KB Wed, 25 Dec 2019 15:50:00 GMT 1
0.9.0-prerelease-94059693 33.95 KB Wed, 25 Dec 2019 15:44:26 GMT 1
0.9.0-prerelease-84713935 33.94 KB Sun, 08 Sep 2019 11:41:15 GMT 1
0.9.0-prerelease-79951862 33.94 KB Mon, 15 Jul 2019 08:53:32 GMT 1
0.9.0-prerelease-78802540 33.93 KB Tue, 02 Jul 2019 01:37:54 GMT 0
0.9.0-prerelease-72090085 33.94 KB Mon, 15 Apr 2019 09:04:12 GMT 6
0.9.0-prerelease-71746179 33.95 KB Thu, 11 Apr 2019 09:31:50 GMT 2
0.9.0-prerelease-71654248 33.95 KB Wed, 10 Apr 2019 07:59:28 GMT 0
0.9.0-prerelease-71639546 33.04 KB Wed, 10 Apr 2019 03:54:18 GMT 0
0.9.0-prerelease-71545328 33.02 KB Tue, 09 Apr 2019 01:43:56 GMT 0
0.9.0-prerelease-71476298 33.02 KB Mon, 08 Apr 2019 06:33:31 GMT 0
0.9.0-prerelease-71402895 31.65 KB Sun, 07 Apr 2019 10:10:03 GMT 0
0.9.0-prerelease-71049318 31.66 KB Wed, 03 Apr 2019 07:57:13 GMT 0
0.9.0-prerelease-70962224 31.64 KB Tue, 02 Apr 2019 07:45:31 GMT 0
0.9.0-prerelease-70957867 31.65 KB Tue, 02 Apr 2019 06:32:53 GMT 0
0.9.0-prerelease-70423649 31.65 KB Wed, 27 Mar 2019 02:09:11 GMT 0
0.9.0-prerelease-69919954 31.64 KB Thu, 21 Mar 2019 06:14:13 GMT 0
0.9.0-prerelease-69916244 31.65 KB Thu, 21 Mar 2019 05:12:19 GMT 0
0.9.0-prerelease-68873853 31.66 KB Sat, 09 Mar 2019 03:39:05 GMT 0
0.9.0-prerelease-68298939 31.65 KB Sat, 02 Mar 2019 11:57:11 GMT 0
0.9.0-prerelease-68293695 31.65 KB Sat, 02 Mar 2019 10:29:50 GMT 0
0.9.0-prerelease-67706785 31.64 KB Sat, 23 Feb 2019 15:27:59 GMT 0
0.9.0-prerelease-114958147 34.76 KB Sun, 23 Aug 2020 12:52:10 GMT 0
0.9.0-prerelease-113464289 35.07 KB Thu, 06 Aug 2020 05:54:31 GMT 0
0.8.0 31.36 KB Sat, 16 Feb 2019 13:03:50 GMT 2
0.8.0-prerelease-67181958 31.67 KB Sun, 17 Feb 2019 13:40:51 GMT 0
0.8.0-prerelease-67092043 31.54 KB Sat, 16 Feb 2019 12:42:19 GMT 0
0.8.0-prerelease-67091509 31.55 KB Sat, 16 Feb 2019 12:33:26 GMT 0
0.8.0-prerelease-67087074 31.54 KB Sat, 16 Feb 2019 11:19:28 GMT 0