WSO2 API Manager 4.2.0与ELK集成时缺失userName致指标无法上报

一、处理SourceHandler证书未知警告 #

该警告是因为WSO2不信任ELK服务的SSL证书，需将ELK证书导入WSO2客户端信任库：

• 导出ELK的SSL证书：
  替换<elk-host>和<elk-port>为你的ELK地址（如9200端口），执行命令：

  openssl s_client -connect <elk-host>:<elk-port> -showcerts </dev/null 2>/dev/null | openssl x509 -outform PEM > elk.crt
  

• 导入证书到WSO2信任库：
  切换到WSO2 APIM安装目录，执行以下命令（默认信任库密码为wso2carbon）：

  keytool -importcert -file elk.crt -alias elk-cert -keystore repository/resources/security/client-truststore.jks -storepass wso2carbon
  

  提示是否信任证书时输入yes确认。
• 重启WSO2 API Manager服务。

二、解决userName is missing in metric data报错（无统计数据生成） #

这个错误是ELK事件构建器验证时发现userName字段为空，直接丢弃了事件，根据你的场景选择对应方案：

方案1：允许匿名请求的统计上报 #

修改<APIM_HOME>/repository/conf/deployment.toml，添加ELK发布器配置，开启空用户名允许：

[apim.analytics.publisher.elk]
enable = true
allow_empty_username = true

配置完成后重启APIM，空userName的请求事件会被正常处理，不会被丢弃。

方案2：确保认证请求的userName被正确提取 #

如果你的API要求用户认证（如OAuth2/JWT），检查以下配置：

• 确认API已启用对应认证方式，且请求携带有效令牌；
• 验证deployment.toml中分析发布器基础配置正确：

  [apim.analytics.publisher]
  enable = true
  publisher_type = "elk"
  

• 调整<APIM_HOME>/repository/conf/analytics/elk-event-builder-config.xml中的userName提取逻辑，确保能从请求上下文正确获取用户信息，比如从JWT的subject claim中提取：

  <field name="userName" type="STRING">
      <expression><![CDATA[$ctx:api.jwt.subject ?: $ctx:api.ut.userName ?: 'anonymous']]></expression>
  </field>
  

方案3：自定义userName默认值 #

如果方案1不生效（如版本兼容性问题），直接修改elk-event-builder-config.xml给userName设置默认值：

<field name="userName" type="STRING">
    <expression><![CDATA[$ctx:api.ut.userName ?: 'anonymous']]></expression>
</field>

修改后重启APIM，空userName会被替换为anonymous，事件可正常流转到ELK。

额外排查步骤 #

• 调整日志级别为DEBUG，查看org.wso2.am.analytics.publisher相关日志，确认数据发布器连接ELK状态及事件处理细节：

  [logger.am.analytics.publisher]
  level = "DEBUG"
  appenders = ["CONSOLE", "FILE"]
  

• 登录Kibana的Discover模块，检查对应索引是否有数据流入。

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