Node.js 应用全链路追踪及Kibana显示问题的解决
本文介绍如何在 Node.js 应用中集成 Elastic APM 实现全链路追踪，并解决一个常见问题：Kibana 界面只显示接口总耗时，而缺少 SQL 查询和 HTTP 请求的细分耗时信息。
问题描述：
一位开发者使用 Node.js (v10)、elastic-apm-node (v3.x) 和 Elastic APM (v7.14.0) 进行全链路追踪。按照官方示例配置后，Kibana 中的追踪结果只显示接口总耗时，无法查看 SQL 查询和 HTTP 请求等子调用的耗时细节。Go 语言编写的同类接口则能清晰显示这些信息，这引发了对 Node.js 探针配置的疑问。
解决方案：
问题在于 Elastic APM agent 的初始化代码位置。 开发者最初未将 elastic-apm-node 的初始化代码放在所有代码的最前面。
关键： require('elastic-apm-node').start() 以及 serviceName 和 serverUrl 等配置选项必须位于所有其他代码之前。
正确的代码片段如下：
const agent = require('elastic-apm-node').start({
serviceName: 'apm-service-test', // 覆盖 package.json 中的服务名
serverUrl: 'http://localhost:8200' // 自定义 APM Server URL (默认: http://localhost:8200)
// secretToken: '' // APM Server 需要令牌时使用
});
将这段代码放在所有其他代码之前，即可解决问题。Kibana 将正确显示 SQL 查询和 HTTP 调用的耗时信息，实现完整的全链路追踪效果。 通过调整代码位置，成功解决了 Kibana 显示不完整耗时信息的问题。
