« 配置 Windows 服务配置 »
Elastic 文档 › ›配置

ASP.NET Core 配置

编辑

ASP.NET Core 配置

编辑

UseElasticApm() 扩展方法提供了一个重载，用于将 IConfiguration 实例传递给 APM Agent。要使用这种设置（在 ASP.NET Core 应用程序中很常见），应用程序的 Startup.cs 文件应包含类似于以下内容的代码

using Elastic.Apm.AspNetCore;

public class Startup
{
    private readonly IConfiguration _configuration;

    public Startup(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        //Registers the agent with an IConfiguration instance:
        app.UseElasticApm(_configuration);

        //Rest of the Configure() method...
    }
}

通过这种设置，Agent 能够以与应用程序中任何其他库相同的方式进行配置。例如，任何已在传递给 APM Agent 的 IConfiguration 实例上配置的配置源都可用于设置 Agent 配置值。

更多信息可在官方 Microsoft .NET Core 配置文档 中找到。您可以在此文档中，选项说明的 IConfiguration 或 Web.config 密钥 列下找到每个 APM 配置选项的密钥。

也可以在不使用重载的情况下调用 UseElasticApm()。在这种情况下，代理将仅从环境变量读取配置。

UseElasticApm 方法仅打开 ASP.NET Core 监控。要打开 .NET Core 上 Agent 支持的所有内容（包括 HTTP 和数据库监控）的跟踪，请使用 Elastic.Apm NetCoreAll 包中的 UseAllElasticApm 方法。在 ASP.NET Core 设置 中了解更多信息。

示例配置文件

编辑

这是一个典型 ASP.NET Core 应用程序的示例 appsettings.json 配置文件，该应用程序已使用 UseElasticApm() 激活。有两个重要的要点，在示例下方列出为标注

{
  "Logging": {
    "LogLevel": { 
      "Default": "Warning",
      "Elastic.Apm": "Debug"
    }
  },
  "AllowedHosts": "*",
  "ElasticApm": 
    {
      "ServerUrl":  "http://myapmserver:8200",
      "SecretToken":  "apm-server-secret-token",
      "TransactionSampleRate": 1.0
    }
}

使用 ASP.NET Core，必须在标准 Logging 部分使用 Elastic.Apm 类别名称设置内部 APM 日志记录器的 LogLevel。

ElasticApm 下面的配置在将相应的 IConfiguration 传递给代理时由代理获取。

在某些情况下（例如，当您不使用 ASP.NET Core 时），您不会使用 UseElasticApm() 方法激活代理。在这种情况下，请使用 ElasticApm:LogLevel 设置代理日志级别，如以下 appsettings.json 文件所示

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ElasticApm":
    {
      "LogLevel":  "Debug",
      "ServerUrl":  "http://myapmserver:8200",
      "SecretToken":  "apm-server-secret-token",
      "TransactionSampleRate": 1.0
    }
}
« 配置 Windows 服务配置 »