Apache SkyWalking .NET Core Agent 使用教程

Apache SkyWalking .NET Core Agent 使用教程

SkyAPM-dotnet 项目地址: https://gitcode.com/gh_mirrors/sky/SkyAPM-dotnet

1. 项目介绍

Apache SkyWalking 是一个针对微服务、云原生和容器化（Docker、K8s、Mesos）架构设计的应用程序性能监控（APM）系统。skywalking-netcore 项目是 Apache SkyWalking 的 .NET Core 版本的本地支持代理，由 Apache SkyWalking 提交者团队提供。它允许 .NET Core 应用程序与 SkyWalking 后端进行通信，从而实现对应用程序性能的监控和分析。

2. 项目快速启动

环境要求

• .NET Core 3.1 或更高版本
• SkyWalking 8.0 或更高版本的 backend 和 UI

安装 SkyWalking .NET Core Agent

在你的项目中运行以下命令来安装 SkyWalking .NET Core Agent：

dotnet add package SkyAPM.Agent.AspNetCore

配置环境变量

设置 ASPNETCORE_HOSTINGSTARTUPASSEMBLIES 环境变量以支持 SkyAPM .NET Core Agent 的激活。将 SkyAPM.Agent.AspNetCore 的程序集名称添加到该环境变量中。

在 Windows 上：

set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore

在 macOS/Linux 上：

export ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore

配置服务名称

设置 SKYWALKING__SERVICENAME 环境变量来指定服务名称。

在 Windows 上：

set SKYWALKING__SERVICENAME=sample_app

在 macOS/Linux 上：

export SKYWALKING__SERVICENAME=sample_app

运行应用程序

运行以下命令来启动你的应用程序。

dotnet run

3. 应用案例和最佳实践

部署 SkyWalking Backend 和 UI

请参考 SkyWalking 官方文档来部署 SkyWalking Backend 和 UI。

配置 SkyWalking .NET Core Agent

安装 SkyAPM.DotNet.CLI 工具来帮助生成配置文件。

dotnet tool install -g SkyAPM.DotNet.CLI

对于 2.2.x 或更早版本，使用以下命令生成配置文件：

dotnet skyapm config [你的服务名称] [你的服务器地址]

对于 2.3.x 或更新的版本，使用以下命令生成配置文件：

dotnet skyapm config [你的服务名称] [--reporter=grpc|kafka] [--grpcservers=...] [--kafkaservers=...]

例如，使用 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

4. 典型生态项目

skywalking-netcore 项目可以与多种中间件、框架和库集成，包括但不限于：

• ASP.NET Core
• HttpClient
• EntityFrameworkCore

通过这种方式，你可以实现对你应用程序的全方位监控，包括应用程序拓扑、分布式追踪、诊断信息等。

SkyAPM-dotnet 项目地址: https://gitcode.com/gh_mirrors/sky/SkyAPM-dotnet