通过 NuGet Package 配置 .NET 代理
借助 APM Insight .NET Core 代理,监控基于 .NET Core 2.1 及更高版本构建的 Web 应用程序。APM Insight .NET Core 代理可帮助跟踪 ASP .NET Core 应用程序中的 HTTP 请求、SQL 查询、Web API 调用和远程调用。应用程序异常可通过所提供的日志记录器 API 进行记录。
注意
此安装方式在 Linux 和 Windows 环境中均适用。请按照以下说明从 NuGet 获取 APM Insight .NET Core 代理,两种环境的步骤相同。
视频
以下是有关如何在 Windows 上安装 Site24x7 APM Insight .NET Core 代理的快速视频。
以下是有关如何在 Linux 上安装 Site24x7 APM Insight .NET Core 代理的快速视频。
安装 .NET Core 代理
- 将 Site24x7.DotNetCoreAgent 添加到您的项目中。
PM> Install-Package Site24x7.DotNetCoreAgent
- 修改您的 Startup.cs 文件中的 ConfigureServices 方法。如截图所示,在 AddMvc() 方法之前插入以下一行代码。
services.AddSite24x7ApmInsights();

- 如以下截图所示,从 Site24x7 门户复制 License Key。

- 如需添加 License Key,请选择以下两种方法之一:
- 创建一个环境变量,并如下粘贴 License Key:
S247_LICENSE_KEY=<YOUR LICENSE KEY HERE> - 找到应用程序发布目录中的配置文件:
- 前往 <ApplicationPublishDirectory>\DotNetAgent\apminsight.conf
- 如果文件不存在,请在上述位置创建该文件。
- 在文件中添加以下条目:license.key=<YOUR_LICENSE_KEY>
- 创建一个环境变量,并如下粘贴 License Key:
- 发布并部署您的 Web 应用程序。
- 应用程序名称将默认使用 ASP.NET Core 应用程序名称。
- 如需更改应用程序名称,请选择以下两种方法之一:
- 创建一个环境变量,并如下设置应用程序名称:
SITE24X7_APP_NAME=<YOUR_APPLICATION_NAME> - 找到应用程序发布目录中的配置文件:
- 创建一个环境变量,并如下设置应用程序名称:
-
- 前往 <ApplicationPublishDirectory>\DotNetAgent\apminsight.conf
- 如果文件不存在,请在上述位置创建该文件。
- 在文件中添加以下条目:application.name=<YOUR_APPLICATION_NAME>
- 执行相应事务以收集性能指标。
- 下图说明了安装流程。

卸载 .NET Core 代理
- 在 Visual Studio IDE 中打开 .NET Core 应用程序项目。
- 打开 startup.cs 文件,并删除以下代码行:
services.AddSite24x7ApmInsights();
- 右键单击项目,选择 Manage NuGet Packages...
- 从已安装的软件包列表中选择 Site24x7.DotNetCoreAgent。
- 点击"卸载"以移除 APM Insight .NET Core 代理。
- 发布并部署应用程序。

