开始使用通用性能分析

编辑

在本页中,您将学习如何配置和使用通用性能分析。本页涵盖以下内容:

  • 通用性能分析设置的先决条件
  • 在您的 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 用户。

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

编程配置
编辑

如果您更喜欢以编程方式配置数据摄取,则可以使用 Kibana API 调用。此调用可以通过 Kibana 中的“Dev Tools”控制台或使用任何独立的 HTTP 客户端(例如 curlwget)进行。在这两种情况下,API 调用都必须使用 elastic 用户凭据执行,以确保必要的权限。

成功的 API 调用将返回一个带有空主体的 202 Accepted 响应。

要从控制台配置数据摄取,请转到导航菜单中的Dev Tools 并运行以下命令:

POST kbn:/internal/profiling/setup/es_resources
{}

要使用独立 HTTP 客户端(例如 curl)以编程方式配置数据摄取,请运行以下命令:

curl -u elastic:<PASSWORD> -H "kbn-xsrf: true" -H "Content-Type: application/json" \
    --data "{}" "https://<kibana-host>:<kibana-port>/internal/profiling/setup/es_resources"
安装通用性能分析代理
编辑

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

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

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

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

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

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

      profililing elastic agent creds
  5. 单击保存并继续
以独立模式安装通用性能分析代理
编辑

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

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

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

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

配置通用性能分析代理时,请考虑以下几点:

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