› ›

问题排查日志

本节提供了您在加入日志时可能遇到的错误的可能解决方案。

用户没有创建 API 密钥的权限

如果您没有创建 API 密钥所需的权限，您将看到以下错误消息

User does not have permissions to create API key.

Required cluster privileges are [`monitor`, `manage_own_api_key`] and
required index privileges are [`auto_configure`, `create_doc`] for
indices [`logs-*-*`, `metrics-*-*`], please add all required privileges
to the role of the authenticated user.

解决方案

编辑

您需要以下任一操作

让管理员授予您 monitor 和 manage_own_api_key 集群权限以及 auto_configure 和 create_doc 索引权限。拥有这些权限后，重新启动加入流程。
从管理员处获取 API 密钥，并将 API 手动添加到 Elastic Agent 配置中。有关手动更新配置和添加 API 密钥的更多信息，请参阅配置 Elastic Agent。

创建 API 密钥失败

编辑

如果您没有在 Kibana 中创建 savedObjects 的权限，您将看到以下错误消息

Failed to create API key

Something went wrong: Unable to create observability-onboarding-state

解决方案

编辑

您需要管理员授予您 保存对象管理 Kibana 权限以生成所需的 observability-onboarding-state 流状态。拥有必要的权限后，重新启动加入流程。

无法从主机访问 Kibana

编辑

如果无法从主机访问 Kibana，在将 安装 Elastic Agent 指令粘贴到主机后，您将看到以下错误消息

Failed to connect to {host} port {port} after 0 ms: Connection refused

解决方案

编辑

主机需要访问 Kibana。端口 443 必须打开，并且部署的 Elasticsearch 端点必须可访问。从 帮助菜单（）→ 连接详细信息 中找到您的项目端点。

运行以下命令，将 URL 替换为您的端点，您应该会收到一个身份验证错误，其中包含有关解决问题的更多详细信息

curl https://your-endpoint.elastic.cloud

下载 Elastic Agent 失败

编辑

如果主机能够下载安装脚本但无法连接到公共工件存储库，您将看到以下错误消息

Download Elastic Agent

Failed to download Elastic Agent, see script for error.

解决方案

编辑

如果 Elastic Agent 版本和操作系统架构的组合不可用，您将看到以下错误消息
```
The requested URL returned error: 404
```
要解决此问题，请将安装说明中的 Elastic Agent 版本更新为已知的 Elastic Agent 版本。
如果以前已完全下载 Elastic Agent，您将看到以下错误消息
```
Error: cannot perform installation as Elastic Agent is already running from this directory
```
要解决此问题，请删除以前的下载并重新启动加入。
您是 Elastic Cloud Enterprise 用户，但无权访问 Elastic 下载页面。

安装 Elastic Agent 失败

编辑

如果主机上已存在 Elastic Agent，您将看到以下错误消息

Install Elastic Agent

Failed to install Elastic Agent, see script for error.

解决方案

编辑

您可以使用 elastic-agent uninstall 命令卸载当前的 Elastic Agent，然后再次运行该脚本。

卸载当前的 Elastic Agent 将删除整个当前设置，包括现有配置。

等待日志发送… 步骤永远无法完成

编辑

如果 等待日志发送… 步骤永远无法完成，则日志未发送到 Elasticsearch，并且很可能是您的 Elastic Agent 配置存在问题。

解决方案

编辑

检查 Elastic Agent 日志是否有错误。有关在 Elastic Agent 日志中查找错误的更多信息，请参阅调试独立 Elastic Agent 文档。

« 日志索引模板参考问题排查 »

问题排查日志