« Express 快速入门 hapi 快速入门 »
Elastic 文档 › ›设置代理

Fastify 快速入门

编辑

Fastify 快速入门

编辑

为您的 Fastify 应用设置 Elastic APM 非常简单，您可以通过多种方式对其进行调整以满足您的需求。

请按照以下指南开始使用，有关更高级主题，请查看API 参考。

安装

编辑

将 elastic-apm-node 模块作为依赖项添加到您的应用程序

npm install elastic-apm-node --save

初始化

编辑

在您的 Node.js 应用程序中，在引入任何其他模块（例如 fastify、http 等）之前，务必先启动代理。

这意味着您可能应该在应用程序的主文件中（通常为 index.js、server.js 或 app.js）引入并启动代理。

这是一个安装了 Elastic APM 代理的简单 Fastify 示例

// Add this to the VERY top of the first file loaded in your app
var apm = 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: '',
})

// Require the framework and instantiate it
var fastify = require('fastify')({
  logger: true
})

// Declare a route
fastify.get('/', function (request, reply) {
  reply.send({ hello: 'world' })
})

// Run the server!
fastify.listen(3000, function (err, address) {
  if (err) throw err
  fastify.log.info(`server listening on ${address}`)
})

现在，代理将监控 Fastify 应用程序的性能并记录任何未捕获的异常。

高级配置
编辑

在上面的示例中，我们通过调用 start() 函数来初始化代理。此函数接受一个可选的选项对象，用于配置代理。任何未通过选项对象提供的选项都可以使用环境变量进行配置。因此，如果您愿意，可以使用环境变量设置相同的配置选项

ELASTIC_APM_SERVICE_NAME=<service name>
ELASTIC_APM_SECRET_TOKEN=<token>
ELASTIC_APM_SERVER_URL=<server url>

然后只需像这样启动代理即可

// Start the agent before any thing else in your app
var apm = require('elastic-apm-node').start()

请参阅 API 文档 中配置代理的所有可能方法。

完整文档
编辑

性能监控

编辑

Elastic APM 自动测量 Fastify 应用程序的性能。它会为数据库查询、外部 HTTP 请求以及在对 Fastify 应用的请求期间发生的任何其他缓慢操作记录跨度。

默认情况下，代理将检测 最常见的模块。要检测其他事件，可以使用自定义跨度。有关自定义跨度的信息，请参阅 自定义跨度部分。

跨度分组在事务中 - 默认情况下，每个传入的 HTTP 请求一个。但也可以创建与 HTTP 请求无关的自定义事务。有关详细信息，请参阅 自定义事务部分。

未知路由
编辑

在 Elastic APM 中查看应用程序的性能指标时，您可能会看到一些名为“未知路由”的事务。这表示代理检测到对应用程序的传入 HTTP 请求，但不知道此 HTTP 请求与 Fastify 应用中的哪个路由匹配。

这可能只是 404 请求（根据定义，这些请求与任何路由都不匹配），或者也可能是代理未正确安装的症状。如果您看到此情况或无法显示任何有意义的指标，请按照 故障排除指南 进行操作。

错误日志记录

编辑

默认情况下，Node.js 代理将监视未捕获的异常并自动将其发送到 Elastic APM。但在大多数情况下，错误不会被抛出，而是通过回调返回、由 Promise 捕获或简单地手动创建。这些错误不会自动发送到 Elastic APM。要手动将错误发送到 Elastic APM，只需使用错误调用 apm.captureError()

var err = new Error('Ups, something broke!')

apm.captureError(err)

有关错误的高级日志记录（包括向错误添加额外元数据），请参阅 API 文档。

过滤敏感信息

编辑

默认情况下，Node.js 代理将在将错误和指标发送到 Elastic APM 服务器之前过滤常见的敏感信息。

您可以调整这些默认值或删除您不想发送到 Elastic APM 的任何信息

  • 默认情况下，Node.js 代理不会记录 HTTP 请求的主体。要启用此功能，请使用 captureBody 配置选项
  • 默认情况下，Node.js 代理将过滤已知包含敏感信息的某些 HTTP 标头。要禁用此功能，请使用 sanitizeFieldNames 配置选项
  • 要应用自定义过滤器，请使用 过滤 函数之一

添加您自己的数据

编辑

Node.js 代理将跟踪活动 HTTP 请求，并在将其发送到 Elastic APM 服务器时将其链接到错误和记录的事务指标。这使您可以查看有关哪个请求导致特定错误或哪些请求导致特定 HTTP 端点变慢的详细信息。

但在许多情况下，仅有关 HTTP 请求本身的信息是不够的。要向错误和事务添加更多元数据，请使用以下函数之一

  • apm.setUserContext() - 调用此函数以使用有关用户/客户端的信息丰富收集的性能数据和错误
  • apm.setCustomContext() - 调用此函数以使用您认为有助于调试性能问题和错误的任何信息丰富收集的性能数据和错误（这些数据仅存储，但在 Elasticsearch 中未编入索引）
  • apm.setLabel() - 调用此函数以使用您认为有助于调试性能问题和错误的简单键/值字符串丰富收集的性能数据和错误（标签在 Elasticsearch 中编入索引）

兼容性

编辑

有关详细信息，请参阅 支持的技术。

另请参阅：Fastify 自身的 LTS 文档。

故障排除

编辑

如果您无法按预期使 Node.js 代理正常工作，请按照 故障排除指南 进行操作。

« Express 快速入门 hapi 快速入门 »