如何配置Elastic APM以监控使用IDistributedCache的Redis？

核心原因 #

你通过AddStackExchangeRedisCache配置分布式缓存时，该方法会自动创建并注册一个ConnectionMultiplexer实例，而你手动注册的IConnectionMultiplexer并没有被缓存服务实际使用，导致APM的拦截逻辑无法作用到真实的Redis连接上。

修复方案 #

1. 修改Redis缓存配置，直接在创建ConnectionMultiplexer时启用APM
   移除你手动注册的IConnectionMultiplexer单例代码，改用AddStackExchangeRedisCache的配置回调来注入APM监控：

   builder.Services.AddStackExchangeRedisCache(options =>
   {
       options.Configuration = redis; // 替换为你的Redis连接字符串
       // 可选：设置Redis实例名称，便于区分多个缓存实例
       options.InstanceName = "AppCache";
       // 自定义ConnectionMultiplexer创建逻辑，启用APM
       options.ConnectionMultiplexerFactory = async config =>
       {
           var multiplexer = await ConnectionMultiplexer.ConnectAsync(config);
           multiplexer.UseElasticApm();
           return multiplexer;
       };
   });
   

2. 验证包版本兼容性
   确保以下NuGet包版本匹配（建议使用最新稳定版）：

   • Elastic.Apm
   • Elastic.Apm.StackExchangeRedis
   • StackExchange.Redis

3. 检查APM基础配置
   确认appsettings.json中的APM配置正确，尤其是采样率未被设为0：

   "ElasticApm": {
       "ServiceName": "你的服务名称",
       "ServerUrl": "http://你的APM服务器地址:8200",
       "TransactionSampleRate": 1.0 // 确保全量采样，便于调试
   }
   

4. 启用调试日志排查
   开启APM的调试日志，查看是否有Redis监控相关的错误信息：

   "Logging": {
       "LogLevel": {
           "Elastic.Apm": "Debug"
       }
   }
   

内容的提问来源于stack exchange，提问作者Master