SkyAPM C#/.NET инструментальный агент

Apache SkyWalking — это APM, предназначенный для микросервисных, облачных и контейнерных (Docker, K8s, Mesos) архитектур. SkyAPM-dotnet предоставляет нативный агент поддержки в средах C# и .NETStandard с помощью команды Apache SkyWalking.

Статус сборки CI

Платформа	Сервер сборки	Статус master
AppVeyor	Windows/Linux
------------------	---------------	--------
SkyAPM.Agent.AspNetCore
SkyAPM.Agent.AspNet
SkyAPM.Agent.GeneralHost

URL пакета MyGet https://www.myget.org/F/skyapm-dotnet/api/v3/index.json# Поддерживаемые версии

• В данный момент проект поддерживает приложения, ориентированные на netcoreapp3.1, net5.0, net6.0 или более новые версии.
• Поддерживаемые промежуточные серверы, фреймворки и библиотеки.

Возможности

Краткий список возможностей агента SkyWalking .NET Core

• Топология приложений
• Распределённое трассирование
• Диагностика ASP.NET Core
• Диагностика HttpClient
• Диагностика EntityFrameworkCore

Начало работы

Развертывание backend SkyWalking и UI

Требования

Начиная с версии v1.0.0, агент SkyAPM .NET Core поддерживает только SkyWalking 8.0 или выше. Документация SkyWalking доступна здесь.

Установка агента SkyWalking .NET Core

Вы можете выполнить следующую команду для установки агента SkyWalking .NET Core в вашем проекте.

dotnet add package SkyAPM.Agent.AspNetCore

Как использовать

Установите переменную окружения ASPNETCORE_HOSTINGSTARTUPASSEMBLIES, чтобы активировать агент SkyAPM .NET Core.

• Добавьте имя сборки SkyAPM.Agent.AspNetCore в переменную окружения ASPNETCORE_HOSTINGSTARTUPASSEMBLIES.

Примеры

• На 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

• На 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

Конфигурация

Установите SkyAPM.DotNet.CLI

dotnet tool install -g SkyAPM.DotNet.CLI
```Используйте `dotnet skyapm config [ваш_название_сервиса] [ваши_серверы]` для генерации файла конфигурации.

```bash
dotnet skyapm config sample_app 192.168.0.1:11800

Вклад

Эта секция находится в процессе разработки здесь: Вклад в SkyAPM-dotnet.

Контакты

• Отправьте запрос на создание проблемы, если у вас возникли вопросы относительно протокола SkyWalking, его официального back-end сервера или UI. Задайте свои вопросы через официальные каналы Apache. Все следующие каналы не предназначены для .NET агента, но подходят, если вы столкнулись с проблемами в back-end или UI.

• Подайте официальное сообщение об ошибке Apache SkyWalking issue.

• Почтовый список: dev@skywalking.apache.org. Отправьте письмо на dev-subscribe@skywalking.apache.org, следуйте ответу для подписки на почтовый список.

• Присоединитесь к каналу skywalking на Apache Slack. Если ссылка не работает, найдите последнюю на Apache INFRA WIKI.

• Группа QQ: 392443393 (2000/2000, недоступна), 901167865 (доступна)

Лицензия

Лицензия Apache Yöntem 2.0.