配置代理

编辑

有多种方法可以配置 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 配置选项为此文件指定自定义路径。