« 升级到 8.14.2 版本 将自安装的 APM 集成升级到 8.14.2 »
Elastic 文档 ›Elastic 可观测性 [8.14] ›应用程序性能监控 (APM) ›升级 ›升级到 8.14.2 版本

将独立安装的 APM Server 升级到 8.14.2

编辑

将独立安装的 APM Server 升级到 8.14.2编辑

本升级指南适用于运行 APM Server 的独立方法。仅当以下两个条件都满足时，才使用本指南

  • 您拥有 Elastic Stack 的自安装版本，即您没有使用 Elastic Cloud。
  • 您正在运行 APM Server 二进制文件，即您尚未切换到 Elastic APM 集成。
先决条件编辑

  1. 在升级到 8.14.2 版本之前，Elasticsearch、Kibana 和 APM Server 必须升级到 7.17 版本。

  2. 查看 APM 发行说明、重大变更 和可观测性 新增功能 内容。
升级步骤编辑

  1. 将 Elastic Stack 升级到 8.14.2 版本

    必须在升级 APM Server 之前升级 Elastic Stack（Elasticsearch 和 Kibana）。请参阅 Elastic Stack 安装和升级指南 以获取指导。

  2. 通过 Fleet UI 安装 APM 集成

    从 8.0.0 版本开始，Fleet 使用 APM 集成来设置和管理 APM 索引模板、ILM 策略和摄取管道。APM Server 仅在安装 APM 集成后才会将数据发送到 Elasticsearch。

    如果您有互联网连接

    通过 Kibana 中的 Fleet UI 安装 APM 集成需要互联网连接。

    1. 打开 Kibana 并选择 添加集成 > Elastic APM.
    2. 单击 APM 集成.
    3. 单击 添加 Elastic APM.
    4. 单击 保存并继续.
    5. 单击 稍后添加 Elastic Agent。您无需运行 Elastic Agent 即可完成设置。
    如果您没有互联网连接

    如果您的环境存在网络流量限制，则可以使用其他方法安装 APM 集成。有关更多信息，请参阅 断开连接的环境。

    选项 1：更新 kibana.yml

    更新 kibana.yml 以包含以下内容，然后重新启动 Kibana。

    xpack.fleet.packages:
- name: apm
  version: latest

    有关如何编辑 Kibana 配置文件的更多信息，请参阅 配置 Kibana。

    选项 2：使用 Fleet API

    使用 Fleet API 安装 APM 集成。要成功，这需要针对 Kibana API 运行，而不是针对 Elasticsearch API 运行。

    POST kbn:/api/fleet/epm/packages/apm/8.14.2
{ "force": true }

    有关如何使用 Kibana API 的更多信息，请参阅 Kibana API。

  3. 安装 8.14.2 APM Server 版本

    请参阅 安装 以查找适合您的系统的命令。

    如果您在安装 APM 集成之前安装了 8.14.2 版本的 APM Server，您将看到类似于以下内容的错误日志。您必须返回并安装 APM 集成，然后才能将数据摄取到 Elasticsearch 中。

    ...
{"log.level":"error","@timestamp":"2022-01-19T10:45:34.923+0800","log.logger":"beater","log.origin":{"file.name":"beater/waitready.go","file.line":62},"message":"precondition 'apm integration installed' failed: error querying Elasticsearch for integration index templates: unexpected HTTP status: 404 Not Found ({\"error\":{\"root_cause\":[{\"type\":\"resource_not_found_exception\",\"reason\":\"index template matching [traces-apm.sampled] not found\"}],\"type\":\"resource_not_found_exception\",\"reason\":\"index template matching [traces-apm.sampled] not found\"},\"status\":404}): to remediate, please install the apm integration: https://ela.st/apm-integration-quickstart","service.name":"apm-server","ecs.version":"1.6.0"}
{"log.level":"error","@timestamp":"2022-01-19T10:45:37.461+0800","log.logger":"beater","log.origin":{"file.name":"beater/waitready.go","file.line":62},"message":"precondition 'apm integration installed' failed: error querying Elasticsearch for integration index templates: unexpected HTTP status: 404 Not Found ({\"error\":{\"root_cause\":[{\"type\":\"resource_not_found_exception\",\"reason\":\"index template matching [logs-apm.error] not found\"}],\"type\":\"resource_not_found_exception\",\"reason\":\"index template matching [logs-apm.error] not found\"},\"status\":404}): to remediate, please install the apm integration: https://ela.st/apm-integration-quickstart","service.name":"apm-server","ecs.version":"1.6.0"}
...

  4. 查看您的配置文件

    某些设置已被删除或更改。您可能需要在启动 APM Server 之前更新您的 apm-server.yml 配置文件。有关帮助查找此文件的信息，请参阅 安装布局，有关所有可用配置选项的列表，请参阅 配置。

  5. 启动 APM Server

    要启动 APM Server，请运行

    ./apm-server -e

    有关更多详细信息，请参阅 启动 APM Server。

  6. （可选）升级到 APM 集成

    有时间进行更多升级吗？请参阅 切换到 Elastic APM 集成。

« 升级到 8.14.2 版本 将自安装的 APM 集成升级到 8.14.2 »