- Fleet 和 Elastic Agent 指南其他版本
- Fleet 和 Elastic Agent 概述
- Beats 和 Elastic Agent 功能
- 快速入门
- 从 Beats 迁移到 Elastic Agent
- 部署模型
- 安装 Elastic Agent
- 安装 Fleet 管理的 Elastic Agent
- 安装独立的 Elastic Agent
- 在容器化环境中安装 Elastic Agent
- 在容器中运行 Elastic Agent
- 在 Fleet 管理的 Kubernetes 上运行 Elastic Agent
- 使用 Helm 在 Kubernetes 上安装 Elastic Agent
- 示例:使用 Helm 在 Kubernetes 上安装独立的 Elastic Agent
- 示例:使用 Helm 在 Kubernetes 上安装 Fleet 管理的 Elastic Agent
- Fleet 管理的高级 Elastic Agent 配置
- 在 Elastic Agent 上配置 Kubernetes 元数据增强
- 在 Fleet 管理的 GKE 上运行 Elastic Agent
- 在 Fleet 管理的 Amazon EKS 上运行 Elastic Agent
- 在 Fleet 管理的 Azure AKS 上运行 Elastic Agent
- 在 Kubernetes 上运行独立的 Elastic Agent
- 在 Kubernetes 上扩展 Elastic Agent
- 在 Kubernetes 集成中使用自定义摄取管道
- 环境变量
- 将 Elastic Agent 作为 OTel 收集器运行
- 在没有管理权限的情况下运行 Elastic Agent
- 从 MSI 包安装 Elastic Agent
- 安装布局
- 气隙环境
- 将代理服务器与 Elastic Agent 和 Fleet 一起使用
- 从边缘主机卸载 Elastic Agent
- 在边缘主机上启动和停止 Elastic Agent
- Elastic Agent 配置加密
- 安全连接
- 在 Fleet 中管理 Elastic Agent
- 配置独立的 Elastic Agent
- 创建独立的 Elastic Agent 策略
- 配置文件结构
- 输入
- 提供程序
- 输出
- SSL/TLS
- 日志记录
- 功能标志
- Agent 下载
- 配置文件示例
- 授予独立的 Elastic Agent 对 Elasticsearch 的访问权限
- 示例:将独立的 Elastic Agent 与 Elastic Cloud Serverless 一起使用来监控 nginx
- 示例:将独立的 Elastic Agent 与 Elasticsearch Service 一起使用来监控 nginx
- 调试独立的 Elastic Agent
- 使用 Elastic Agent 进行 Kubernetes 自动发现
- 监控
- 参考 YAML
- 管理集成
- 定义处理器
- 处理器语法
- add_cloud_metadata
- add_cloudfoundry_metadata
- add_docker_metadata
- add_fields
- add_host_metadata
- add_id
- add_kubernetes_metadata
- add_labels
- add_locale
- add_network_direction
- add_nomad_metadata
- add_observer_metadata
- add_process_metadata
- add_tags
- community_id
- convert
- copy_fields
- decode_base64_field
- decode_cef
- decode_csv_fields
- decode_duration
- decode_json_fields
- decode_xml
- decode_xml_wineventlog
- decompress_gzip_field
- detect_mime_type
- dissect
- dns
- drop_event
- drop_fields
- extract_array
- fingerprint
- include_fields
- move_fields
- parse_aws_vpc_flow_log
- rate_limit
- registered_domain
- rename
- replace
- script
- syslog
- timestamp
- translate_sid
- truncate_fields
- urldecode
- 命令参考
- 故障排除
- 发行说明
升级 Elastic Agent 集成
编辑升级 Elastic Agent 集成
编辑默认情况下,Kibana 需要 Internet 连接才能从 Elastic Package Registry 下载集成包。请确保 Kibana 服务器可以通过端口 443
连接到 https://epr.elastic.co
。如果网络限制阻止 Kibana 连接到公共 Elastic Package Registry,则可以使用代理服务器或托管您自己的 Elastic Package Registry。要了解更多信息,请参阅 气隙环境。
Elastic 会定期发布 Elastic Agent 集成更新。要使用新功能和特性,请将已安装的集成升级到最新版本,并选择性地升级集成策略以使用新版本。
在较大的部署中,您应该在部署更大的升级计划之前,先在示例 Elastic Agent 上测试集成升级。
将集成升级到最新版本
编辑- 在 Kibana 中,转到集成页面并打开已安装的集成选项卡。搜索并选择要升级的集成。请注意,版本号旁边有一个警告图标,表示有新版本可用。
-
单击设置选项卡,并注意有关新版本的消息。
-
在升级集成之前,请决定是否也将集成策略升级到最新版本。要使用新功能和特性,您需要升级现有的集成策略。但是,升级可能会引入更改,例如字段更改,这些更改需要您解决冲突。
- 选择升级集成策略,以便在升级集成时升级任何符合条件的集成策略。
- 要继续使用较旧的包版本,请取消选择升级集成策略。您仍然可以选择稍后手动升级集成策略。
-
单击升级到最新版本。
如果您选择了升级集成策略并且存在冲突,请手动升级集成策略并在策略编辑器中解决冲突。
- 升级完成后,验证已安装的版本和最新版本是否匹配。
您必须单独升级独立代理。如果您使用 Kibana 创建和下载您的独立代理策略,请参阅升级集成后升级独立代理策略。
自动保持集成策略为最新
编辑某些集成包(如 System)在 Fleet 设置期间默认安装。当 Fleet 检测到有新版本可用时,这些集成会自动升级。
当您在 Fleet UI 中选择某些选项时,将自动安装以下集成。它们都有一个选项可以自动升级集成策略。
- Elastic Agent - 在 Elastic Agent 策略中启用默认的 收集代理日志 或 收集代理指标 选项时自动安装。
- Fleet Server - 通过 Fleet UI 设置 Fleet Server 时自动安装。
- System - 在 Elastic Agent 策略中启用默认的 收集系统日志和指标 选项时自动安装。
Elastic Defend 集成还有一个选项可以自动升级安装策略。
请注意,对于以下集成,当集成自动更新时,集成策略也会自动升级。此行为无法禁用。
对于支持自动升级集成策略选项的集成,当选择此选项(默认)时,当有新版本的集成可用时,Fleet 会自动升级您的策略。如果在升级过程中出现冲突,您的集成策略将不会升级,您需要手动升级集成策略。
要自动保持集成策略为最新
- 在 Kibana 中,转到集成页面并打开已安装的集成选项卡。搜索并选择要配置的集成。
-
单击设置并确保选中自动保持集成策略为最新。
如果此选项在设置选项卡上不可用,则此功能不适用于您正在查看的集成。
手动升级集成策略
编辑如果您在升级集成时无法升级集成策略,请手动升级它们。
-
单击策略选项卡,并找到要升级的集成策略。
-
单击升级以开始升级过程。
升级将在策略编辑器中打开。
- 进行任何所需的配置更改,并在必要时解决冲突。有关更多信息,请参阅解决冲突。
- 对每个具有过时集成的策略重复此过程。
冲突太多无法解决?请参阅故障排除文档,了解手动步骤。
解决冲突
编辑在尝试升级集成策略时,集成版本之间可能存在重大更改或冲突。例如,如果新版本的集成有一个必需字段,并且没有指定默认值,则 Fleet 无法在没有用户输入的情况下执行升级。如果实验性软件包在版本之间大大重组其字段和配置设置,则也可能出现冲突。
如果 Fleet 在自动升级集成策略时检测到冲突,则不会尝试升级它。您需要
- 手动升级集成策略.
-
使用策略编辑器修复任何冲突或错误。
-
在查看字段冲突下,请注意,您可以单击以前的配置以查看旧集成策略的原始 JSON 表示形式并比较值。当字段在版本之间被弃用或删除时,此功能非常有用。
- 在策略编辑器中,修复任何错误并单击升级集成。
-
On this page