Kibana 中的 Fleet 设置

编辑

Kibana 中的 Fleet 设置

编辑

在 Elastic Cloud 中,Fleet 标志已配置。

您可以在 kibana.yml 中配置 xpack.fleet 设置。默认情况下,Fleet 已启用。要使用 Fleet,您还需要配置 Kibana 和 Elasticsearch 主机。

许多 Fleet 设置也可以直接通过 Fleet UI 进行配置。有关详细信息,请参阅 Fleet UI 设置

有关 Fleet 的更多信息,请参阅 Fleet 文档。

常规 Fleet 设置

编辑
xpack.fleet.agents.enabled logo cloud
设置为 true(默认)以启用 Fleet。
xpack.fleet.isAirGapped
设置为 true 以指示 Fleet 在气隙环境中运行。有关详细信息,请参阅 气隙环境。启用此标志有助于 Fleet 跳过不必要的请求,并改善气隙环境的用户体验。

Elastic Package Manager 设置

编辑
xpack.fleet.registryUrl
用于访问 Elastic Package Manager 注册表的地址。
xpack.fleet.registryProxyUrl
如果无法直接连接互联网,则用于访问 Elastic Package Manager 注册表的代理地址。有关详细信息,请参阅 气隙环境
xpack.fleet.packageVerification.gpgKeyPath
磁盘上用于验证 Elastic Package Manager 包的 GPG 密钥的路径。如果 Elastic 公钥因安全原因而重新发布,您可以使用此设置来指定新密钥。

Fleet 设置

编辑
xpack.fleet.agents.fleet_server.hosts

Elastic Agent 用于访问 Fleet Server 的主机名。

如果在您的 kibana.yml 中配置了此设置,则此设置在 Fleet UI 中将灰显且不可用。要在 UI 中使此设置可编辑,请不要在配置文件中配置它。

xpack.fleet.agents.elasticsearch.hosts
Elastic Agent 用于访问 Elasticsearch 的主机名。
xpack.fleet.agents.elasticsearch.ca_sha256
用于证书验证的哈希密码。该密码是 SHA-256 指纹的 base64 编码字符串。

预配置设置(用于高级用例)

编辑

使用这些设置来预定义您希望 Fleet 默认加载的集成、代理策略和 Fleet Server 主机或代理。

这些设置不支持预配置 Endpoint 和 Cloud Security 集成。

xpack.fleet.packages

Fleet 应用程序首次启动时安装的集成列表。

xpack.fleet.packages 的必需属性
name
来自包注册表的集成名称。
version
确切的语义版本,或关键字 latest 以获取最新的集成版本。
xpack.fleet.agentPolicies

Fleet 应用程序启动时配置的代理策略列表。

xpack.fleet.agentPolicies 的必需属性
id
此策略的唯一 ID。ID 可以是数字或字符串。
name
策略名称。
xpack.fleet.agentPolicies 的可选属性
description
此策略的文本描述。
namespace
标识此策略命名空间的字符串。
monitoring_enabled
指定要收集的监控数据的关键字列表。有效值包括 ['logs']['metrics']['logs', 'metrics']
keep_monitoring_alive
如果为 true,将启用监控,但日志/指标收集将被禁用。如果您希望即使在不收集日志/指标时也保持代理的监控服务器处于活动状态,请使用此选项。
is_managed
如果为 true,则用户无法编辑此策略,只能通过更新 Kibana 配置来更改。
is_default
如果为 true,则此策略是默认代理策略。
is_default_fleet_server
如果为 true,则此策略是默认 Fleet Server 代理策略。
data_output_id
用于发送数据的输出 ID。(需要与 monitoring_output_id 相同)
monitoring_output_id
用于发送监控数据的输出 ID。(需要与 data_output_id 相同)
package_policies

要添加到此策略的集成策略列表。

package_policies 的属性
id
集成策略的唯一 ID。ID 可以是数字或字符串。
name
(必需)集成策略的名称。
package

(必需)此策略配置的集成。

package 的属性
name
与此策略关联的集成名称。
description
描述此集成策略的文本字符串。
namespace
标识此策略命名空间的字符串。
inputs
集成的输入映射。遵循与包策略 API 输入相同的架构,但 vars 中的任何对象都可以传递 frozen: true,以防止用户编辑该特定的 var

配置示例

xpack.fleet.packages:
  - name: apache
    version: 0.5.0

xpack.fleet.agentPolicies:
  - name: Preconfigured Policy
    id: preconfigured-policy
    namespace: test
    package_policies:
      - package:
          name: system
        name: System Integration
        namespace: test
        id: preconfigured-system
        inputs:
          system-system/metrics:
            enabled: true
            vars:
              '[system.hostfs]': home/test
            streams:
              '[system.core]':
                enabled: true
                vars:
                  period: 20s
          system-winlog:
            enabled: false
xpack.fleet.outputs

Fleet 应用程序启动时配置的输出列表。

某些类型的输出具有其他必需和可选设置。有关每种输出类型的完整设置列表,请参阅 Fleet 和 Elastic Agent 指南中的 输出设置

如果在您的 kibana.yml 中配置了输出设置,则这些设置在 Fleet UI 中将灰显且不可用。要在 UI 中使这些设置可编辑,请不要在配置文件中配置它们。

xpack.fleet.outputs 设置旨在用于高级配置,例如具有多个输出。我们建议在使用 xpack.fleet.outputs 时不要启用 xpack.fleet.agents.elasticsearch.host 设置。

xpack.fleet.outputs 的必需属性
id
此输出的唯一 ID。ID 应为字符串。
name
输出名称。
type
输出类型。目前,我们支持 “elasticsearch”、“logstash”、“kafka” 和 “remote_elasticsearch”。
hosts
包含该输出的主机列表的数组。
xpack.fleet.outputs 的可选属性
is_default
如果为 true,则除非为代理策略专门配置了另一个输出,否则 xpack.fleet.outputs 中指定的输出将用于发送代理数据。
is_default_monitoring
如果为 true,则除非为代理策略专门配置了另一个输出,否则 xpack.fleet.outputs 中指定的输出将用于发送代理监控数据。
is_internal
如果为 true,则 xpack.fleet.outputs 中指定的输出将不会出现在 UI 中,并且只能通过 kibana.yml 或 Fleet API 进行管理。
config
该输出的额外配置。
proxy_id
用于访问输出的代理的唯一 ID。
ssl

设置为使用安全套接字层 (SSL) 协议启用身份验证。

ssl 的属性
certificate
Elastic Agent 用于与输出进行身份验证的 SSL 证书。在此处包含证书的完整内容。
secrets

在此处包含应存储为密钥的预配置输出的任何值。密钥值在 kibana.yml 设置文件中被替换为引用,原始值在外部存储为安全哈希。请注意,这种类型的密钥存储要求所有已配置的 Fleet Server 均为 8.12.0 或更高版本。

secrets 的属性
key:
Elastic Agent 用于与输出进行身份验证的私钥证书。

xpack.fleet.outputs 配置示例

xpack.fleet.outputs:
  - id: my-logstash-output-with-a-secret
    name: preconfigured logstash output with a secret
    type:  logstash
    hosts: ["localhost:9999"]
    ssl:
      certificate: xxxxxxxxxx
    secrets:
      ssl:
        key: securekey
xpack.fleet.fleetServerHosts

Fleet 应用程序启动时配置的 Fleet Server 主机列表。

xpack.fleet.fleetServerHosts 的必需属性
id
主机服务器的唯一 ID。
name
主机服务器的名称。
host_urls
Elastic Agent 将用于连接到 Fleet Server 的一个或多个主机 URL 的数组。
xpack.fleet.fleetServerHosts 的可选属性
is_default
此主机是否应为用于 Fleet Server 的默认主机。
is_internal
如果为 true,则该主机将不会出现在 UI 中,并且只能通过 kibana.yml 或 Fleet API 进行管理。
proxy_id
用于访问 Fleet Server 主机的代理的唯一 ID。
xpack.fleet.proxy

用于访问 Fleet Server 的代理列表,在 Fleet 应用程序启动时配置。

xpack.fleet.proxy 的必需属性
id
用于访问 Fleet Server 主机的代理的唯一 ID。
name
用于访问 Fleet Server 主机的代理的名称。
url
Elastic Agent 用于连接到代理以访问 Fleet Server 的 URL。
xpack.fleet.proxy 的可选属性
proxy_headers
要与代理一起使用的标头的映射。proxy_headers 的属性
详细信息
key
用于代理标头的键。
value
用于代理标头的值。
certificate_authorities
用于颁发证书的证书颁发机构 (CA)。
certificate
用于验证代理的证书的名称。
certificate_key
用于验证代理的证书密钥。
xpack.fleet.enableExperimental
要在 Fleet 中启用的实验性功能标志列表。

不应在生产环境中启用实验性功能。本节中的功能是实验性的,可能会在未来的版本中更改或完全删除。Elastic 将尽最大努力修复任何问题,但实验性功能的支持级别与通用可用 (GA) 功能的支持级别不同。