服务字段

编辑

服务字段描述了收集数据的服务来源或目标服务。

这些字段有助于查找和关联特定服务和版本的日志。

服务字段详情

编辑
字段 描述 级别

service.address

收集此服务数据的地址。

这应该是一个 URI、网络地址(ipv4:port 或 [ipv6]:port)或资源路径(sockets)。

类型: keyword

示例: 172.26.0.2:5432

扩展

service.environment

[测试版] 此字段为测试版,可能会发生更改。

标识服务运行的环境。

如果同一服务在不同的环境(生产、预发布、QA、开发等)中运行,则环境可以标识同一服务的其他实例。还可以对来自同一环境的服务和应用程序进行分组。

类型: keyword

示例: production

扩展

service.ephemeral_id

此服务的临时标识符(如果存在)。

此 ID 通常在重启后会发生变化,但 service.id 不会。

类型: keyword

示例: 8a4f500f

扩展

service.id

正在运行服务的唯一标识符。如果服务由多个节点组成,则所有节点的 service.id 应该相同。

此 ID 应唯一标识服务。这使得可以关联一个特定服务的日志和指标,无论哪个特定节点发出事件。

请注意,如果您需要查看服务的一个特定主机的事件,则应根据 host.namehost.id 进行过滤。

类型: keyword

示例: d37e5ebfe0ae6c4972dbe9f0174a1637bb8247f6

核心

service.name

收集数据服务的名称。

服务的名称通常是用户指定的。这允许在多个主机上运行的分布式服务根据名称关联相关的实例。

对于 Elasticsearch,service.name 可能包含集群名称。对于 Beats,如果没有指定名称,则 service.name 默认情况下是 service.type 字段的副本。

类型: keyword

示例: elasticsearch-metrics

核心

service.node.name

服务节点的名称。

这允许区分在同一主机上运行的同一服务的两个节点。因此,service.node.name 通常应该在给定服务的节点之间是唯一的。

对于 Elasticsearch,service.node.name 可能包含 Elasticsearch 集群中的唯一节点名称。在服务没有节点名称概念的情况下,可以使用主机名或容器名称来区分构成此服务的正在运行的实例。如果这些名称无法提供唯一性(例如,在同一主机上运行服务的多个实例),则可以手动设置节点名称。

类型: keyword

示例: instance-0000000016

扩展

service.node.role

将在下一个主要版本发布中弃用并移除。此字段将被 node.roles 取代。

服务节点的角色。

这允许区分同一服务的不同运行角色。

对于 Kibana,service.node.role 可以是 uibackground_tasks

对于 Elasticsearch,service.node.role 可以是 masterdata

其他服务可以使用它来区分作为服务一部分运行的 webworker 角色。

类型: keyword

示例: background_tasks

扩展

service.node.roles

服务节点的角色。

这允许区分同一服务的不同运行角色。

对于 Kibana,service.node.role 可以是 uibackground_tasks 或两者兼而有之。

对于 Elasticsearch,service.node.role 可以是 masterdata 或两者兼而有之。

其他服务可以使用它来区分作为服务一部分运行的 webworker 角色。

类型: keyword

注意:此字段应包含一个值数组。

示例: ["ui", "background_tasks"]

扩展

service.state

服务的当前状态。

类型: keyword

核心

service.type

收集数据服务的类型。

该类型可用于对来自一种服务类型的日志和指标进行分组和关联。

例如:如果从 Elasticsearch 收集日志或指标,则 service.type 将为 elasticsearch

类型: keyword

示例: elasticsearch

核心

service.version

收集数据服务的版本。

这允许仅查看特定服务版本的的数据集。

类型: keyword

示例: 3.2.4

核心

字段重用

编辑

预期 service 字段嵌套在

  • service.origin
  • service.target

另请注意,service 字段可以直接在事件的根目录下使用。

可以嵌套在 Service 下的字段集
编辑
位置 字段集 描述

service.origin.*

service

[测试版] 目前,在此位置重用 service 字段被认为是测试版。

在传入请求或事件的情况下,描述源服务。

service.target.*

service

[测试版] 目前,在此位置重用 service 字段被认为是测试版。

在传出请求或事件的情况下,描述目标服务。

服务字段用法

编辑

有关服务字段的用法和示例,请参见 服务字段用法和示例 部分。