服务字段编辑

服务字段描述了从中收集数据的服务的相关信息。

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

服务字段详细信息编辑

字段 描述 级别

service.address

收集有关此服务的数据的地址。

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

类型: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.nameservice.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.origin.*

service

[测试版] 在此位置复用 service 字段目前被视为测试版。

描述传入请求或事件的来源服务。

service.target.*

service

[测试版] 在此位置复用 service 字段目前被视为测试版。

描述传出请求或事件的目标服务。

服务字段使用编辑

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