配置代理编辑

有多种方法可以配置 Node.js 代理。按优先顺序排列:

  1. 通过 Kibana 进行 APM 代理集中配置。(支持的选项标记为 动态配置
  2. 环境变量。
  3. 如果调用 apm.start() 函数,请提供一个 配置对象 作为第一个参数。
  4. 通过 代理配置文件

有关可用配置属性和环境变量的预期名称的信息,请参阅 配置选项 文档。

动态配置编辑

标记为 动态配置 标记的配置选项可以在运行时从受支持的来源设置时更改。

Node.js 代理支持 集中配置,它允许您通过 Kibana 中的 APM 应用程序微调某些配置。默认情况下,代理中启用了此功能,并使用 centralConfig

代理配置对象编辑

要使用可选的 options 参数,请将其传递到 apm.start() 方法中

var apm = require('elastic-apm-node').start({
  // add configuration options here
})

此示例显示了如何将代理配置为仅在生产环境中处于活动状态

// Add this to the VERY top of the first file loaded in your app
require('elastic-apm-node').start({
  // Override service name from package.json
  // Allowed characters: a-z, A-Z, 0-9, -, _, and space
  serviceName: '',

  // Use if APM Server requires a token
  secretToken: '',

  // Use if APM Server uses API keys for authentication
  apiKey: '',

  // Set custom APM Server URL (default: http://127.0.0.1:8200)
  serverUrl: '',

  // Only activate the agent if it's running in production
  active: process.env.NODE_ENV === 'production'
})

代理配置文件编辑

Node.js 代理在当前工作目录中查找名为 elastic-apm-node.js 的文件。您可以使用 configFile 配置选项为此文件指定自定义路径。