Apache SkyWalking .NET Core Agent 安装与配置指南

1. 项目基础介绍

Apache SkyWalking 是一个用于微服务、云原生和容器架构（Docker, K8s, Mesos）的应用性能监控（APM）系统。本项目，SkyWalking .NET Core Agent，是为 .NET 和 .NETStandard 平台提供的本地支持代理，由 Apache SkyWalking 贡献者团队开发。

主要编程语言：C#

2. 项目使用的关键技术和框架

本项目使用了以下关键技术和框架：

• .NET Core：构建现代化的、跨平台的应用程序。
• ASP.NET Core：用于构建 Web 应用程序和服务的框架。
• HttpClient：用于发送 HTTP 请求和接收 HTTP 响应。
• EntityFrameworkCore：对象关系映射（ORM）框架，用于数据库操作。
• 分布式追踪：追踪服务之间的调用链路。

3. 项目安装和配置的准备工作

在开始安装和配置之前，请确保您的开发环境满足以下要求：

• .NET Core SDK 已安装。 -具备基本的命令行操作知识。
• 如果您打算将配置文件放在非默认位置，请准备好相应的路径信息。

详细安装步骤

步骤 1：创建新项目

首先，您需要创建一个新的 .NET Core 项目。打开命令行工具，执行以下命令：

dotnet new mvc -n SampleApp

步骤 2：安装 SkyWalking .NET Core Agent

进入项目目录：

cd SampleApp

然后，使用 nuget 命令安装 SkyWalking .NET Core Agent：

dotnet add package SkyAPM.Agent.AspNetCore

步骤 3：配置环境变量

为了激活 SkyAPM .NET Core Agent，您需要设置 ASPNETCORE_HOSTINGSTARTUPASSEMBLIES 环境变量，添加 SkyAPM.Agent.AspNetCore 到该环境变量中。

在 Windows 系统上，执行以下命令：

set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore

在 macOS/Linux 系统上，执行以下命令：

export ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore

步骤 4：设置服务名称

您还需要设置服务的名称，可以通过环境变量 SKYWALKING__SERVICENAME 来设置：

Windows：

set SKYWALKING__SERVICENAME=sample_app

macOS/Linux：

export SKYWALKING__SERVICENAME=sample_app

步骤 5：运行项目

现在，您可以运行您的项目了：

dotnet run

如果一切设置正确，您的项目应该会启动，并且 SkyWalking .NET Core Agent 将开始工作。

注意：

以上步骤仅提供了基本的安装和配置过程。在实际部署中，您可能还需要配置 SkyWalking 的后端服务和 UI 界面，并确保您的项目与 SkyWalking 后端服务相连接。请参考 SkyWalking 的官方文档以获取更多详细信息。