安装 .NET Core 代理
在 APM Insight .NET Core 代理的帮助下,监控在 .NET Core 2.0 及更高版本中构建的 Web 应用程序。您可以在 IIS 或 Kestrel Web 服务器中托管的 ASP .NET Core 应用程序中跟踪 HTTP 请求、SQL 查询、错误、异常、Web API 调用和远程调用。
此方法仅适用于 Windows 环境。请参阅此处在 Linux 环境中安装 APM Insight .NET Core 代理。
安装说明:
- 登录到您的 Site24x7 帐户 > APM > 添加应用程序
- 下载 .NET Core 代理。
- 将代理包解压到合适的位置。
运行校验和验证以验证下载代理的完整性。了解更多。
- 在管理员模式下运行 PowerShell。
- 导航到解压缩代理的位置并执行以下命令。
- 对于本地安装
./InstallAgent.ps1 -Destination "<path>" -InstallType "local" -LicenseKey "<license_key>"
- 用于全局安装
./InstallAgent.ps1 -Destination" <path> " -InstallType " global " -LicenseKey " <license_key> "
- 对于本地安装
- 由于全局安装会无意中检测所有 .NET Core 应用程序,Site24x7 建议进行本地安装。
- 目标路径可以是机器中任何驱动器上的任何文件夹。我们建议不要使用应用程序的目录,因为我们可能必须在每个版本中定期替换应用程序文件。
如下表所述。
安装选项 | 描述 |
目的 | 必需的。将安装代理的绝对或相对路径。 |
安装类型 | 必需的。确定代理是本地安装还是全局安装。 |
注册码 | 必需的。从 Site24x7 门户复制的许可密钥。 |
配置 | 可选的。覆盖现有安装。我们建议先备份现有的配置文件。 |
帮助 | 可选的。显示安装代理的指南。 |
6. 启动或重新启动 .NET Core 应用程序。(注意:如果您通过 AspNetCoreModule 使用 IIS 服务器进行反向代理,则需要重新启动 IIS 服务器。)
7. 执行一些事务以开始监控。
注意:
- 要更改 .NET Core 应用程序的名称:
- 导航到应用程序的发布目录。
- 创建或编辑 apmapplication.conf文件,然后使用以下键值添加或修改应用程序名称:
application.name=<您的应用程序名称>
- 重新启动应用程序
- 使用代理服务器进行代理通信:
- 导航到代理主目录 > Dot Net Agent。
- 编辑 apminsight.conf 文件并添加以下键值:
back.proxy = true
proxy.server.host = <代理服务器>
proxy.server.port = <代理端口>
proxy.auth.username = <代理用户>
proxy.auth.password = <代理密码>
- 重新启动 .NET Core 应用程序。
- 通过 appsettings.json 文件配置 .NET Core 代理
一般来说,下载Site24x7 APM Insight代理时,需要在apminsight.conf中单独设置license key。但是,您也可以在应用程序设置文件而不是 conf 文件中设置许可密钥。请按照以下说明进行操作。
- 打开应用程序当前工作目录下的 appsettings.json 文件。
- 输入许可密钥和应用程序名称,如下所示。
{
“site24x7”:{
“license.key”:“xxxxxxxxxxxxxxxxxxxxxxxxxxxxx”,
“application.name”:“Your_Application_Name”
}
} - 代理将在 appsettings.json 文件中查找许可密钥。如果它不可用,它将在环境变量中查找许可密钥。