安装 .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 代理。

安装说明:

  1. 登录到您的 Site24x7 帐户 > APM > 添加应用程序
  2. 下载 .NET Core 代理。
  3. 将代理包解压到合适的位置。
    运行校验和验证以验证下载代理的完整性。了解更多
  4. 在管理员模式下运行 PowerShell。
  5. 导航到解压缩代理的位置并执行以下命令。 
      • 对于本地安装
        ./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 应用程序的名称:
      1. 导航到应用程序的发布目录。
      2. 创建或编辑 apmapplication.conf文件,然后使用以下键值添加或修改应用程序名称:
application.name=<您的应用程序名称>
  1. 重新启动应用程序
  • 使用代理服务器进行代理通信:
      1. 导航到代理主目录 > Dot Net Agent。
      2. 编辑 apminsight.conf 文件并添加以下键值:

back.proxy = true

proxy.server.host = <代理服务器>

proxy.server.port = <代理端口>

proxy.auth.username = <代理用户>

proxy.auth.password = <代理密码>

  1. 重新启动 .NET Core 应用程序。
  • 通过 appsettings.json 文件配置 .NET Core 代理

一般来说,下载Site24x7 APM Insight代理时,需要在apminsight.conf中单独设置license key。但是,您也可以在应用程序设置文件而不是 conf 文件中设置许可密钥。请按照以下说明进行操作。

        1. 打开应用程序当前工作目录下的 appsettings.json 文件。
        2. 输入许可密钥和应用程序名称,如下所示。
          {
          “site24x7”:{
          “license.key”:“xxxxxxxxxxxxxxxxxxxxxxxxxxxxx”,
          “application.name”:“Your_Application_Name”
          }
          }
        3. 代理将在 appsettings.json 文件中查找许可密钥。如果它不可用,它将在环境变量中查找许可密钥。