skyapm-dotnet - SkyAPM.Agent.GeneralHost 2.2.0-preview-231587543

SkyAPM ASP.NET Core Agent.

PM> Install-Package SkyAPM.Agent.GeneralHost -Version 2.2.0-preview-231587543 -Source https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

Copy to clipboard

> nuget.exe install SkyAPM.Agent.GeneralHost -Version 2.2.0-preview-231587543 -Source https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

Copy to clipboard

> dotnet add package SkyAPM.Agent.GeneralHost --version 2.2.0-preview-231587543 --source https://www.myget.org/F/skyapm-dotnet/api/v3/index.json

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

nuget SkyAPM.Agent.GeneralHost  ~> 2.2.0-preview-231587543
Copy to clipboard

> choco install SkyAPM.Agent.GeneralHost --version 2.2.0-preview-231587543 --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.GeneralHost" -RequiredVersion "2.2.0-preview-231587543" -Repository "skyapm-dotnet" -AllowPreRelease
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 help from the 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.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

For 2.2.x or older, use dotnet skyapm config [your_service_name] [your_servers] to generate config file.

dotnet skyapm config sample_app 192.168.0.1:11800

For 2.3.x or newer, use dotnet skyapm config ${your_service_name} [--reporter=grpc|kafka] [--grpcservers=...] [--kafkaservers=...] to generate config file.

# grpc
dotnet skyapm config sample_app --reporter=grpc --grpcservers=192.168.0.1:11800

# kafka
dotnet skyapm config sample_app --reporter=kafka --kafkaservers=192.168.0.1:9092

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.

  • .NETCoreApp 3.1
    • SkyAPM.Agent.Hosting (>= 2.2.0-preview-231587543)
  • .NETFramework 5.0
    • Microsoft.Extensions.Hosting.Abstractions (>= 5.0.0)
    • SkyAPM.Agent.Hosting (>= 2.2.0-preview-231587543)
  • .NETFramework 6.0
    • Microsoft.Extensions.Hosting.Abstractions (>= 6.0.0)
    • SkyAPM.Agent.Hosting (>= 2.2.0-preview-231587543)
  • .NETFramework 7.0
    • Microsoft.Extensions.Hosting.Abstractions (>= 7.0.0)
    • SkyAPM.Agent.Hosting (>= 2.2.0-preview-231587543)
  • .NETCoreApp 3.1: 3.1.0.0
  • .NETFramework 5.0: 5.0.0.0
  • .NETFramework 6.0: 6.0.0.0
  • .NETFramework 7.0: 7.0.0.0

Owners

liuhaoyang

Authors

SkyAPM Team

Project URL

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

License

Apache-2.0

Tags

SkyWalking APM

Info

308 total downloads
2 downloads for version 2.2.0-preview-231587543
Download (12.49 KB)
Found on the current feed only

Package history

Version Size Last updated Downloads Mirrored?
2.2.0 12.32 KB Sun, 31 Mar 2024 14:20:16 GMT 8
2.2.0-preview-238759916 12.51 KB Fri, 26 Jul 2024 10:20:03 GMT 2
2.2.0-preview-236072483 12.52 KB Tue, 25 Jun 2024 07:49:18 GMT 2
2.2.0-preview-231588135 12.51 KB Sat, 04 May 2024 10:09:18 GMT 2
2.2.0-preview-231587543 12.49 KB Sat, 04 May 2024 09:59:46 GMT 2
2.2.0-preview-230116369 12.51 KB Wed, 17 Apr 2024 09:21:08 GMT 2
2.2.0-preview-228664929 12.51 KB Sun, 31 Mar 2024 14:09:39 GMT 2
2.1.0 9.29 KB Tue, 27 Sep 2022 10:41:30 GMT 3
2.1.0-preview-228190371 12.52 KB Tue, 26 Mar 2024 02:21:03 GMT 4
2.1.0-preview-228189782 12.51 KB Tue, 26 Mar 2024 02:10:41 GMT 4
2.1.0-preview-228189153 12.51 KB Tue, 26 Mar 2024 02:00:39 GMT 4
2.1.0-preview-226923656 12.51 KB Mon, 11 Mar 2024 10:28:30 GMT 3
2.1.0-preview-226915361 12.49 KB Mon, 11 Mar 2024 08:10:32 GMT 3
2.1.0-preview-222188553 12.5 KB Tue, 16 Jan 2024 15:09:56 GMT 3
2.1.0-preview-221787752 12.51 KB Thu, 11 Jan 2024 23:49:27 GMT 3
2.1.0-preview-204706598 12.12 KB Wed, 28 Jun 2023 07:04:25 GMT 3
2.1.0-preview-201780041 12.12 KB Thu, 25 May 2023 10:08:06 GMT 3
2.1.0-preview-195982036 12.13 KB Sun, 19 Mar 2023 07:34:02 GMT 2
2.1.0-preview-195142839 12.13 KB Thu, 09 Mar 2023 14:28:25 GMT 2
2.1.0-preview-195033540 12.11 KB Wed, 08 Mar 2023 08:05:48 GMT 2
2.1.0-preview-194237935 12.12 KB Mon, 27 Feb 2023 03:05:46 GMT 2
2.1.0-preview-193730630 12.11 KB Tue, 21 Feb 2023 06:10:24 GMT 1
2.1.0-preview-193578658 12.12 KB Sun, 19 Feb 2023 11:58:00 GMT 3
2.1.0-preview-193578143 12.12 KB Sun, 19 Feb 2023 11:48:52 GMT 3
2.1.0-preview-192010976 12.1 KB Wed, 01 Feb 2023 08:30:41 GMT 2
2.1.0-preview-180687557 9.44 KB Fri, 23 Sep 2022 07:03:53 GMT 2
2.1.0-preview-180341200 9.43 KB Mon, 19 Sep 2022 06:51:16 GMT 2
2.1.0-preview-180285478 9.43 KB Sun, 18 Sep 2022 15:21:53 GMT 3
2.1.0-preview-180088875 9.43 KB Fri, 16 Sep 2022 08:45:57 GMT 2
2.1.0-preview-180085591 9.44 KB Fri, 16 Sep 2022 07:50:49 GMT 2
2.0.1 9.29 KB Thu, 04 Aug 2022 05:17:08 GMT 4
2.0.1-prerelease-180001227 9.43 KB Thu, 15 Sep 2022 08:25:08 GMT 2
2.0.1-prerelease-179075138 9.44 KB Sun, 04 Sep 2022 15:09:50 GMT 2
2.0.1-prerelease-178103003 9.43 KB Wed, 24 Aug 2022 09:07:55 GMT 3
2.0.1-prerelease-177993941 9.44 KB Tue, 23 Aug 2022 02:50:02 GMT 3
2.0.1-prerelease-177688881 9.43 KB Fri, 19 Aug 2022 14:05:37 GMT 2
2.0.1-prerelease-176714014 9.43 KB Mon, 08 Aug 2022 07:17:41 GMT 3
2.0.1-prerelease-176460972 9.44 KB Fri, 05 Aug 2022 09:00:22 GMT 3
2.0.1-prerelease-176370517 9.44 KB Thu, 04 Aug 2022 07:52:57 GMT 2
2.0.1-prerelease-176360763 9.43 KB Thu, 04 Aug 2022 05:10:25 GMT 2
2.0.1-prerelease-176354457 9.44 KB Thu, 04 Aug 2022 03:25:18 GMT 1
2.0.0 9.27 KB Wed, 11 May 2022 15:25:36 GMT 5
2.0.0-prerelease-172058062 9.42 KB Wed, 15 Jun 2022 09:58:53 GMT 3
2.0.0-prerelease-170868345 9.43 KB Wed, 01 Jun 2022 15:29:55 GMT 3
2.0.0-prerelease-168703945 9.44 KB Sat, 07 May 2022 14:16:25 GMT 3
2.0.0-prerelease-168682844 9.42 KB Sat, 07 May 2022 08:24:47 GMT 2
2.0.0-prerelease-168440647 9.42 KB Wed, 04 May 2022 13:08:46 GMT 2
2.0.0-prerelease-168425800 9.41 KB Wed, 04 May 2022 09:00:47 GMT 2
2.0.0-prerelease-168156862 9.43 KB Sun, 01 May 2022 06:17:50 GMT 2
2.0.0-prerelease-160491146 9.43 KB Tue, 01 Feb 2022 12:56:36 GMT 2
2.0.0-prerelease-159850578 9.42 KB Tue, 25 Jan 2022 03:00:15 GMT 2
2.0.0-prerelease-158228749 9.44 KB Thu, 06 Jan 2022 08:29:35 GMT 2
1.4.0-prerelease-158225235 9.45 KB Thu, 06 Jan 2022 07:30:56 GMT 2
1.4.0-prerelease-158032639 9.44 KB Tue, 04 Jan 2022 02:01:09 GMT 1
1.4.0-prerelease-156870397 6.99 KB Tue, 21 Dec 2021 15:10:56 GMT 2
1.4.0-prerelease-146741176 6.98 KB Thu, 26 Aug 2021 09:29:57 GMT 3
1.4.0-prerelease-146123254 6.98 KB Thu, 19 Aug 2021 05:51:07 GMT 2
1.4.0-prerelease-140067005 6.98 KB Thu, 10 Jun 2021 03:33:54 GMT 2
1.3.0 6.87 KB Sat, 15 May 2021 13:57:42 GMT 3
1.3.0-prerelease-139828452 6.98 KB Mon, 07 Jun 2021 09:18:02 GMT 2
1.3.0-prerelease-135868979 6.99 KB Thu, 22 Apr 2021 13:26:36 GMT 3
1.3.0-prerelease-135775092 6.98 KB Wed, 21 Apr 2021 11:21:54 GMT 4
1.3.0-prerelease-135740515 6.98 KB Wed, 21 Apr 2021 01:45:25 GMT 6
1.3.0-prerelease-135405305 6.98 KB Sat, 17 Apr 2021 04:38:39 GMT 2
1.3.0-prerelease-135229613 6.99 KB Thu, 15 Apr 2021 03:50:18 GMT 3
1.3.0-prerelease-135002134 6.98 KB Mon, 12 Apr 2021 12:39:25 GMT 4
1.3.0-prerelease-133496315 6.99 KB Fri, 26 Mar 2021 02:22:10 GMT 3
1.3.0-prerelease-133452705 6.98 KB Thu, 25 Mar 2021 14:15:54 GMT 2
1.3.0-prerelease-133106541 6.99 KB Sun, 21 Mar 2021 14:05:57 GMT 2
1.3.0-prerelease-132744088 6.98 KB Wed, 17 Mar 2021 09:25:20 GMT 3
1.3.0-prerelease-132637152 6.98 KB Tue, 16 Mar 2021 03:42:44 GMT 2
1.2.0 6.87 KB Thu, 28 Jan 2021 02:29:50 GMT 3
1.2.0-prerelease-132630978 6.98 KB Tue, 16 Mar 2021 01:59:53 GMT 4
1.2.0-prerelease-132306462 6.98 KB Fri, 12 Mar 2021 07:51:16 GMT 3
1.2.0-prerelease-128571693 6.98 KB Thu, 28 Jan 2021 02:24:55 GMT 2
1.2.0-prerelease-128525104 6.99 KB Wed, 27 Jan 2021 13:28:51 GMT 2
1.1.0 6.86 KB Wed, 27 Jan 2021 06:51:37 GMT 4
1.1.0-prerelease-127794490 6.98 KB Tue, 19 Jan 2021 02:31:35 GMT 3
1.1.0-prerelease-127757645 6.98 KB Mon, 18 Jan 2021 16:17:50 GMT 2
1.1.0-prerelease-127382003 6.98 KB Thu, 14 Jan 2021 07:56:57 GMT 2
1.1.0-prerelease-127316744 6.98 KB Wed, 13 Jan 2021 13:49:21 GMT 2
1.1.0-prerelease-127191619 6.98 KB Tue, 12 Jan 2021 03:03:40 GMT 2
1.1.0-prerelease-125423619 6.98 KB Tue, 22 Dec 2020 15:56:57 GMT 2
1.1.0-prerelease-124351087 6.97 KB Thu, 10 Dec 2020 06:01:39 GMT 1
1.1.0-prerelease-124166147 6.98 KB Tue, 08 Dec 2020 02:39:06 GMT 2
1.1.0-prerelease-122978883 6.98 KB Tue, 24 Nov 2020 08:51:37 GMT 1
1.1.0-prerelease-122647710 6.98 KB Fri, 20 Nov 2020 12:52:10 GMT 2
1.1.0-prerelease-122624839 6.98 KB Fri, 20 Nov 2020 06:30:50 GMT 3
1.1.0-prerelease-122623114 6.97 KB Fri, 20 Nov 2020 06:01:52 GMT 2
1.1.0-prerelease-122538418 6.98 KB Thu, 19 Nov 2020 06:30:24 GMT 2
1.1.0-prerelease-122458508 6.99 KB Wed, 18 Nov 2020 08:18:30 GMT 2
1.0.0 6.71 KB Mon, 07 Sep 2020 15:05:00 GMT 4
1.0.0-prerelease-122456766 6.96 KB Wed, 18 Nov 2020 07:49:41 GMT 1
1.0.0-prerelease-122355518 6.97 KB Tue, 17 Nov 2020 03:41:49 GMT 3
1.0.0-prerelease-122355254 6.97 KB Tue, 17 Nov 2020 03:37:39 GMT 2
1.0.0-prerelease-120728802 6.82 KB Thu, 29 Oct 2020 07:49:55 GMT 4
1.0.0-prerelease-120649604 6.83 KB Wed, 28 Oct 2020 09:50:09 GMT 2
1.0.0-prerelease-119785914 6.83 KB Sun, 18 Oct 2020 09:55:01 GMT 2
1.0.0-prerelease-116259961 6.83 KB Mon, 07 Sep 2020 14:29:17 GMT 2
0.9.0 6.79 KB Sun, 30 Jun 2019 16:53:45 GMT 6
0.9.0-prerelease-98779874 6.84 KB Tue, 18 Feb 2020 06:54:34 GMT 3
0.9.0-prerelease-96270513 6.35 KB Mon, 20 Jan 2020 05:51:53 GMT 1
0.9.0-prerelease-96171846 11.82 KB Sun, 19 Jan 2020 02:26:50 GMT 2
0.9.0-prerelease-96005567 11.81 KB Fri, 17 Jan 2020 04:15:47 GMT 2
0.9.0-prerelease-95838124 11.82 KB Wed, 15 Jan 2020 05:45:10 GMT 3
0.9.0-prerelease-95011552 11.75 KB Sun, 05 Jan 2020 16:08:52 GMT 2
0.9.0-prerelease-94527380 11.75 KB Tue, 31 Dec 2019 01:39:01 GMT 1
0.9.0-prerelease-94302854 11.76 KB Sat, 28 Dec 2019 11:16:53 GMT 2
0.9.0-prerelease-94060027 11.75 KB Wed, 25 Dec 2019 15:50:02 GMT 2
0.9.0-prerelease-94059693 11.75 KB Wed, 25 Dec 2019 15:44:28 GMT 2
0.9.0-prerelease-84713935 6.91 KB Sun, 08 Sep 2019 11:41:17 GMT 2
0.9.0-prerelease-79951862 6.86 KB Mon, 15 Jul 2019 08:53:34 GMT 2
0.9.0-prerelease-78802540 6.86 KB Tue, 02 Jul 2019 01:37:56 GMT 1
0.9.0-prerelease-72090085 6.86 KB Mon, 15 Apr 2019 09:04:15 GMT 2
0.9.0-prerelease-71746179 6.86 KB Thu, 11 Apr 2019 09:31:52 GMT 3
0.9.0-prerelease-71654248 6.86 KB Wed, 10 Apr 2019 07:59:31 GMT 2
0.9.0-prerelease-71639546 6.6 KB Wed, 10 Apr 2019 03:54:20 GMT 2
0.9.0-prerelease-71545328 6.6 KB Tue, 09 Apr 2019 01:43:58 GMT 3
0.9.0-prerelease-71476298 6.6 KB Mon, 08 Apr 2019 06:33:33 GMT 3
0.9.0-prerelease-71402895 6.26 KB Sun, 07 Apr 2019 10:10:05 GMT 3
0.9.0-prerelease-71049318 6.26 KB Wed, 03 Apr 2019 07:57:15 GMT 1
0.9.0-prerelease-114958147 6.86 KB Sun, 23 Aug 2020 12:52:12 GMT 3
0.9.0-prerelease-113464289 6.86 KB Thu, 06 Aug 2020 05:54:33 GMT 2