开始使用通用性能分析编辑

在本页中,您将了解如何配置和使用通用性能分析。本页涵盖

  • 设置通用性能分析的先决条件
  • 在您的 Elastic Cloud 部署中设置通用性能分析
  • 安装通用性能分析代理
  • 安装通用性能分析代理集成

我们感谢您对本产品的体验以及您可能遇到的任何其他性能分析问题提供反馈。有关更多信息,请参阅故障排除文档的 发送反馈 部分。

先决条件编辑

在设置通用性能分析之前,请确保您满足以下要求

  • 版本 8.7.0 或更高版本的 Elastic Cloud 上的 Elastic Stack 部署。通用性能分析目前仅在 Elastic Cloud 上可用。
  • 您要分析的工作负载必须在具有 x86_64 或 ARM64 CPU 的 Linux 机器上运行。
  • 最低支持的内核版本是 x86_64 的 4.19 或 ARM64 机器的 5.5。
  • 您的 Elastic Cloud 部署必须启用集成服务器。
  • superuser Elasticsearch 角色(通常是 elastic 用户)的凭据(用户名和密码)。
解释器编辑

通用性能分析是一个系统范围的性能分析解决方案,它还支持 PHP、Python、Java(或任何 JVM 语言)、Go、Rust、C/C++、Node.js/V8、Ruby、.Net 和 Perl。

每个解释器的最低支持版本是

  • JVM/JDK:7
  • Python:3.6
  • V8:8.1.0
  • Perl:5.28
  • PHP:7.3
  • Ruby:2.5
  • .Net:6
部署配置示例编辑

以下部署配置示例经过测试,可以支持来自最多 500 个主机(每个主机有 8 或 16 个 CPU 内核)的性能分析数据,总计约 6000 个内核

组件

每个区域的大小(内存)

区域

Elasticsearch

64 GB

2

Kibana

8 GB

1

集成服务器

8 GB

1

即使您要分析更小的集群,我们也建议为 Elasticsearch 配置至少两个区域,并为集成服务器和 Kibana 分别配置 4 GB 的内存。

在 Elastic Cloud 部署上设置通用性能分析编辑

要在您的 Elastic Cloud 部署上设置通用性能分析,您需要先 配置数据摄取

配置数据摄取编辑

在您的部署中首次启用通用性能分析后,选择导航菜单中 通用性能分析 下的任何子标题以打开以下页面

profiling setup popup

单击 设置通用性能分析 以配置数据摄取。

要配置数据摄取,您需要提升的权限,通常是 elastic 用户。

如果您要从启用了通用性能分析的先前版本升级,请参阅 升级指南

升级时,您必须删除所有现有的性能分析数据。我们仍然建议您升级,因为最新版本包含一些改进和新功能。

配置数据摄取时的已知问题编辑

如果您的 Elastic Cloud 部署源自 7.x 或更早版本,并且当前运行的是 8.9.0 到 8.10.2 之间的版本,您可能会在尝试启用通用性能分析时遇到问题。

具体来说,单击 设置通用性能分析 按钮会触发一条错误消息,显示 设置通用性能分析时出错。升级到版本 8.10.3 或更高版本以解决此问题。

如果您之前在 Elastic Cloud 版本 8.9.0 中启用了通用性能分析,并且您正在重新执行设置,您也可能会遇到此错误。如果升级到 8.10.3 无法解决问题,请完成以下步骤。

从导航菜单中打开 开发工具 并执行以下命令

运行以下命令时,APM 和 Fleet 配置的自定义设置将被删除。

POST kbn:/internal/fleet/reset_preconfigured_agent_policies/policy-elastic-agent-on-cloud

安装通用性能分析代理编辑

安装通用性能分析代理时,您有以下选项

使用 Elastic Agent 安装通用性能分析代理编辑

要使用 Elastic Agent 和通用性能分析代理集成安装通用性能分析代理,请完成以下步骤

  1. 从 Elastic Agent 集成中复制 secret tokenUniversal Profiling Collector url

    profiling elastic agent
  2. 单击 在 Fleet 中管理通用性能分析代理 以完成集成。
  3. 在集成页面上,单击 添加通用性能分析代理
  4. 通用性能分析代理 → 设置 中,添加您从 添加性能分析数据 页面复制的信息

    1. 将通用性能分析收集器 URL 添加到 通用性能分析收集器端点 字段。
    2. 将 secret token 添加到 授权 字段。

      profililing elastic agent creds
  5. 单击 保存并继续

以独立模式安装通用性能分析代理编辑

通用性能分析代理分析您的集群。您需要在要分析的每台机器上安装和配置它。通用性能分析代理需要 root / CAP_SYS_ADMIN 权限才能运行。

在上一步骤中单击 设置通用性能分析 后,您将看到安装通用性能分析代理的说明。您也可以通过单击页面右上角的 添加数据 按钮找到这些说明。

以下是为 Kubernetes 提供的说明示例

profiling k8s hostagent
通用性能分析代理配置说明编辑

配置通用性能分析代理时,请考虑以下事项

  • Kibana 中的说明非常适合测试环境。对于生产环境,我们建议设置一个不可变版本。
  • 在 Elastic Stack 版本 8.9 之前,通用性能分析代理版本方案 与 Elastic Stack 版本方案不一致
  • releases.prodfiler.com 下载的 OS 包在其文件名中包含一个版本。
  • 您可以在 Elastic 容器库存储库 中找到容器镜像版本的列表。
  • 对于 Kubernetes 部署,Helm 图表版本已用于配置相同的容器镜像,除非使用 Helm 值文件中的 version 参数覆盖。
  • 对于 Elastic Stack 版本 8.8 或更高版本,请使用 v3 主机代理。对于版本 8.7,请使用 v2v3 主机代理与 8.7 Elastic Stack 版本不兼容。