{"id":13458286,"url":"https://github.com/SkyAPM/SkyAPM-dotnet","last_synced_at":"2025-03-24T15:31:08.706Z","repository":{"id":37276202,"uuid":"120469298","full_name":"SkyAPM/SkyAPM-dotnet","owner":"SkyAPM","description":"The .NET/.NET Core instrument agent for Apache SkyWalking","archived":false,"fork":false,"pushed_at":"2024-07-26T10:09:57.000Z","size":2953,"stargazers_count":1643,"open_issues_count":18,"forks_count":330,"subscribers_count":98,"default_branch":"main","last_synced_at":"2025-03-20T03:44:40.509Z","etag":null,"topics":["apm","csharp","distributed-tracing","dotnet","metric","observability","skywalking"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SkyAPM.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/Supported-list.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-06T14:24:09.000Z","updated_at":"2025-03-09T07:26:22.000Z","dependencies_parsed_at":"2024-03-11T09:26:21.623Z","dependency_job_id":"8daa1442-d088-441b-a67e-3d15da5477d1","html_url":"https://github.com/SkyAPM/SkyAPM-dotnet","commit_stats":{"total_commits":251,"total_committers":42,"mean_commits":5.976190476190476,"dds":0.5338645418326693,"last_synced_commit":"761699c1911dcc6f622eeeb121f60b2b5bda6ecd"},"previous_names":["openskywalking/skywalking-netcore"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyAPM%2FSkyAPM-dotnet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyAPM%2FSkyAPM-dotnet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyAPM%2FSkyAPM-dotnet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyAPM%2FSkyAPM-dotnet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SkyAPM","download_url":"https://codeload.github.com/SkyAPM/SkyAPM-dotnet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245297970,"owners_count":20592509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apm","csharp","distributed-tracing","dotnet","metric","observability","skywalking"],"created_at":"2024-07-31T09:00:49.778Z","updated_at":"2025-03-24T15:31:07.227Z","avatar_url":"https://github.com/SkyAPM.png","language":"C#","readme":"SkyAPM C#/.NET instrument agent\n==========\n\n\u003cimg src=\"https://skyapmtest.github.io/page-resources/SkyAPM/skyapm.png\" alt=\"Sky Walking logo\" height=\"90px\" align=\"right\" /\u003e\n\n[Apache SkyWalking](https://github.com/apache/incubator-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.\n\n[![issues](https://img.shields.io/github/issues-raw/skyapm/skyapm-dotnet.svg?style=flat-square)](https://github.com/SkyAPM/SkyAPM-dotnet/issues)\n[![pulls](https://img.shields.io/github/issues-pr-raw/skyapm/skyapm-dotnet.svg?style=flat-square)](https://github.com/SkyAPM/SkyAPM-dotnet/pulls)\n[![releases](https://img.shields.io/github/release/skyapm/skyapm-dotnet.svg?style=flat-square)](https://github.com/SkyAPM/SkyAPM-dotnet/releases)\n[![Gitter](https://img.shields.io/gitter/room/openskywalking/lobby.svg?style=flat-square)](https://gitter.im/openskywalking/Lobby)\n[![Twitter Follow](https://img.shields.io/twitter/follow/asfskywalking.svg?style=flat-square\u0026label=Follow\u0026logo=twitter)](https://twitter.com/AsfSkyWalking)\n\n## CI Build Status\n\n| Platform | Build Server | Master Status  |\n|--------- |------------- |---------|\n| AppVeyor |  Windows/Linux |[![Build status](https://ci.appveyor.com/api/projects/status/fl6vucwfn1vu94dv/branch/master?svg=true)](https://ci.appveyor.com/project/wu-sheng/skywalking-csharp/branch/master)|\n\n## Nuget Packages\n\n| Package Name |  NuGet | MyGet | Downloads\n|--------------|  ------- |  ------- |  ----\n| SkyAPM.Agent.AspNetCore | [![nuget](https://img.shields.io/nuget/v/SkyAPM.Agent.AspNetCore.svg?style=flat-square)](https://www.nuget.org/packages/SkyAPM.Agent.AspNetCore) | [![myget](https://img.shields.io/myget/skyapm-dotnet/vpre/SkyAPM.Agent.AspNetCore.svg?style=flat-square)](https://www.myget.org/feed/skyapm-dotnet/package/nuget/SkyAPM.Agent.AspNetCore) | [![stats](https://img.shields.io/nuget/dt/SkyAPM.Agent.AspNetCore.svg?style=flat-square)](https://www.nuget.org/stats/packages/SkyAPM.Agent.AspNetCore?groupby=Version)\n| SkyAPM.Agent.GeneralHost | [![nuget](https://img.shields.io/nuget/v/SkyAPM.Agent.GeneralHost.svg?style=flat-square)](https://www.nuget.org/packages/SkyAPM.Agent.GeneralHost) | [![myget](https://img.shields.io/myget/skyapm-dotnet/vpre/SkyAPM.Agent.GeneralHost.svg?style=flat-square)](https://www.myget.org/feed/skyapm-dotnet/package/nuget/SkyAPM.Agent.GeneralHost) | [![](https://img.shields.io/nuget/dt/SkyAPM.Agent.GeneralHost.svg?style=flat-square)](https://www.nuget.org/stats/packages/SkyAPM.Agent.GeneralHost?groupby=Version)\n\n\u003e MyGet feed URL https://www.myget.org/F/skyapm-dotnet/api/v3/index.json\n\n# Supported\n- This project currently supports apps targeting netcoreapp3.1、net5.0、net6.0 or higher.\n- [Supported middlewares, frameworks and libraries.](docs/Supported-list.md)\n\n# Features\nA quick list of SkyWalking .NET Core Agent's capabilities\n- Application Topology\n- Distributed Tracing\n- ASP.NET Core Diagnostics\n- HttpClient Diagnostics\n- EntityFrameworkCore Diagnostics\n\n# Getting Started\n\n## Deploy SkyWalking Backend And UI\n\n#### Requirements\nStart with v1.0.0, SkyAPM .NET Core Agent only supports SkyWalking 8.0 or higher. The SkyWalking doc is [here](https://skywalking.apache.org/docs/).\n\n## Install SkyWalking .NET Core Agent\n\nYou can run the following command to install the SkyWalking .NET Core Agent in your project.\n\n```\ndotnet add package SkyAPM.Agent.AspNetCore\n```\n\n## How to use\nSet the `ASPNETCORE_HOSTINGSTARTUPASSEMBLIES` environment variable to support the activation of the SkyAPM .NET Core Agent.\n\n- Add the assembly name of `SkyAPM.Agent.AspNetCore` to the `ASPNETCORE_HOSTINGSTARTUPASSEMBLIES` environment variable.\n\n### Examples\n- On windows\n\n```\ndotnet new mvc -n sampleapp\ncd sampleapp\ndotnet add package SkyAPM.Agent.AspNetCore\nset ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore\nset SKYWALKING__SERVICENAME=sample_app\ndotnet run\n```\n\n- On macOS/Linux\n\n```\ndotnet new mvc -n sampleapp\ncd sampleapp\ndotnet add package SkyAPM.Agent.AspNetCore\nexport ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore\nexport SKYWALKING__SERVICENAME=sample_app\ndotnet run\n```\n\n## Configuration\n\nInstall `SkyAPM.DotNet.CLI`\n\n```\ndotnet tool install -g SkyAPM.DotNet.CLI\n```\n\nFor 2.2.x or older, use `dotnet skyapm config [your_service_name] [your_servers]` to generate config file.\n\n```\ndotnet skyapm config sample_app 192.168.0.1:11800\n```\n\nFor 2.3.x or newer, use `dotnet skyapm config ${your_service_name} [--reporter=grpc|kafka] [--grpcservers=...] [--kafkaservers=...]` to generate config file.\n\n```\n# grpc\ndotnet skyapm config sample_app --reporter=grpc --grpcservers=192.168.0.1:11800\n\n# kafka\ndotnet skyapm config sample_app --reporter=kafka --kafkaservers=192.168.0.1:9092\n```\n\n# Contributing\nThis section is in progress here: [Contributing to SkyAPM-dotnet](/CONTIBUTING.md)\n\n# Contact Us\n* Submit an issue\n\nIf 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.\n* Submit an official Apache SkyWalking [issue](https://github.com/apache/skywalking/issues).\n* Mail list: **dev@skywalking.apache.org**. Mail to `dev-subscribe@skywalking.apache.org`, follow the reply to subscribe the mail list.\n* Join `skywalking` channel at [Apache Slack](https://join.slack.com/t/the-asf/shared_invite/enQtNzc2ODE3MjI1MDk1LTAyZGJmNTg1NWZhNmVmOWZjMjA2MGUyOGY4MjE5ZGUwOTQxY2Q3MDBmNTM5YTllNGU4M2QyMzQ4M2U4ZjQ5YmY). If the link is not working, find the latest one at [Apache INFRA WIKI](https://cwiki.apache.org/confluence/display/INFRA/Slack+Guest+Invites).\n* QQ Group: 392443393(2000/2000, not available), 901167865(available)\n\n# License\n[Apache 2.0 License.](/LICENSE)\n","funding_links":[],"categories":["C\\#","3. Collect","C# #"],"sub_categories":["Metrics"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSkyAPM%2FSkyAPM-dotnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSkyAPM%2FSkyAPM-dotnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSkyAPM%2FSkyAPM-dotnet/lists"}