第 14 章 导出字段

这些字段由日志记录系统导出，可从 Elasticsearch 和 Kibana 搜索。在搜索时，请使用完整的带句点字段名称。例如，对于 Elasticsearch /_search URL，若要查找 Kubernetes Pod 名称，请使用 /_search/q=kubernetes.pod_name:name-of-my-pod。

以下小节中描述的字段可能不出现在您的日志记录存储中。并非所有这些字段都会出现在每条记录中。这些字段划分为如下类别：

  • exported-fields-Default
  • exported-fields-systemd
  • exported-fields-kubernetes
  • exported-fields-pipeline_metadata
  • exported-fields-ovirt
  • exported-fields-aushape
  • exported-fields-tlog

14.1. 默认导出的字段

这些默认字段由日志记录系统导出，Elasticsearch 和 Kibana 可从对它们进行搜索。默认字段是顶级字段和 collectd* 字段

顶级字段

顶级字段对于每个应用程序都是通用的，并且可能会出现在每条记录中。对于 Elasticsearch 模板，顶级字段在模板的映射部分中填充 default 的实际映射。

参数描述

@timestamp

此 UTC 值标记日志有效负载的创建时间，如果创建时间未知，则标记首次收集日志有效负载的时间。这是日志处理管道尽力确定何时生成日志有效负载的方法。添加 @ 前缀惯例，可注明字段保留给特定用途。使用 Elasticsearch 时，大多数工具默认查找 @timestamp。例如，格式是 2015-01-24 14:06:05.071000。

geoip

这是机器的 geo-ip。

hostname

hostname 是生成原始有效负载的实体的完全限定域名 (FQDN)。此字段尝试生成此上下文。有时候，生成它的实体知道其上下文。但在其他时候，实体本身具有受限的命名空间，为收集器或规范化程序所知。

ipaddr4

源服务器的 IPv4 地址，可以是数组。

ipaddr6

源服务器的 IPv6 地址（若有）。

level

由 python 的日志记录模块 rsyslog（severitytext 属性）提供的日志记录级别。misc/sys/syslog.h 列出了可能的值，另外还有 trace 和 unknown。例如，“alert crit debug emerg err info notice trace unknown warning”。注意 trace 不在 syslog.h 列表中，但许多应用程序都用到它。

.只有在日志记录系统获取了不理解的值时，才应使用 unknown。另外，还需要注意它是最高级别。trace 可以视为比 debug 的级别更高级且产生更详细的信息。error 已弃用，请使用 err。将 panic 转换为 emerg。将 warn 转换为 warning。

通常可以使用 misc/sys/syslog.h 上列出的优先级值来映射 syslog/journal PRIORITY 中的数值。

其他日志记录系统的日志级别和优先级应映射到最接近的匹配项。请参阅python 日志记录中的示例。

message

典型的日志条目消息或有效负载。可以从中剥离由收集器或规范化程序提取的元数据，这些元数据采用 UTF-8 编码。

pid

这是日志记录实体（若有）的进程 ID。

service

与日志记录实体（若有）关联的服务的名称。例如，syslog APP-NAME 属性映射到 service 字段。

tags

（可选）由 Operator 定义的标签的列表，这些标签由收集器或规范化程序放置在每个日志上。有效负载可以是含有空格分隔字符串令牌的字符串，也可以是字符串令牌的 JSON 列表。

file

文件的可选路径，该文件包含对文件路径的收集器 TODO 分析器而言是本地的日志条目。

offset

偏移值可以表示文件中日志行开头的字节数（从零或一算起），或者表示日志行号（从零或一算起），只要这些值在单个日志的上下文中严格单调递增。允许对这些值换行，以表示日志文件的新版本（轮转）。

namespace_name

将这条记录与共享其名称的 namespace 关联。这个值不会存储下来，而是用于将记录与适当的 namespace 相关联，以进行访问控制和视觉化。通常，这个值在标签中给出，但如果协议不支持发送标签，则可以使用此字段。如果存在此字段，它将覆盖标签（tag）或 kubernetes.namespace_name 中指定的namespace。

namespace_uuid

与 namespace_name 关联的 uuid。这个值不会存储下来，而是用于将记录与适当的命名空间相关联，以进行访问控制和视觉化。如果存在此字段，它将覆盖 kubernetes.namespace_uuid 给出的 uuid。这也将会导致针对此日志记录跳过 Kubernetes 元数据查找。

collectd 字段

以下字段代表命名空间指标元数据。

参数描述

collectd.interval

类型：浮点数

collectd 间隔。

collectd.plugin

类型：字符串

collectd 插件。

collectd.plugin_instance

类型：字符串

collectd 插件实例。

collectd.type_instance

类型：字符串

collectd 类型实例。

collectd.type

类型：字符串

collectd 类型。

collectd.dstypes

类型：字符串

collectd dstypes。

collectd.processes 字段。

以下字段对应于 collectd 进程插件。

参数描述

collectd.processes.ps_state

类型：整数。collectd ps_state 型进程插件。

collectd.processes.ps_disk_ops 字段

collectd ps_disk_ops 型进程插件。

参数描述

collectd.processes.ps_disk_ops.read

类型：浮点数

TODO

collectd.processes.ps_disk_ops.write

类型：浮点数

TODO

collectd.processes.ps_vm

类型：整数

collectd ps_vm 型进程插件。

collectd.processes.ps_rss

类型：整数

collectd ps_rss 型进程插件。

collectd.processes.ps_data

类型：整数

collectd ps_data 型进程插件。

collectd.processes.ps_code

类型：整数

collectd ps_code 型进程插件。

collectd.processes.ps_stacksize

类型：整数

collectd ps_stacksize 型进程插件。

collectd.processes.ps_cputime 字段

collectd ps_cputime 型进程插件。

参数描述

collectd.processes.ps_cputime.user

类型：浮点数

TODO

collectd.processes.ps_cputime.syst

类型：浮点数

TODO

collectd.processes.ps_count 字段

collectd ps_count 型进程插件。

参数描述

collectd.processes.ps_count.processes

类型：整数

TODO

collectd.processes.ps_count.threads

类型：整数

TODO

collectd.processes.ps_pagefaults 字段

collectd ps_pagefaults 型进程插件。

参数描述

collectd.processes.ps_pagefaults.majflt

类型：浮点数

TODO

collectd.processes.ps_pagefaults.minflt

类型：浮点数

TODO

collectd.processes.ps_disk_octets 字段

collectd ps_disk_octets 型进程插件。

参数描述

collectd.processes.ps_disk_octets.read

类型：浮点数

TODO

collectd.processes.ps_disk_octets.write

类型：浮点数

TODO

collectd.processes.fork_rate

类型：浮点数

collectd fork_rate 型进程插件。

collectd.disk 字段

对应于 collectd 磁盘插件。

collectd.disk.disk_merged 字段

collectd disk_merged 型磁盘插件。

参数描述

collectd.disk.disk_merged.read

类型：浮点数

TODO

collectd.disk.disk_merged.write

类型：浮点数

TODO

collectd.disk.disk_octets 字段

collectd disk_octets 型磁盘插件。

参数描述

collectd.disk.disk_octets.read

类型：浮点数

TODO

collectd.disk.disk_octets.write

类型：浮点数

TODO

collectd.disk.disk_time 字段

collectd disk_time 型磁盘插件。

参数描述

collectd.disk.disk_time.read

类型：浮点数

TODO

collectd.disk.disk_time.write

类型：浮点数

TODO

collectd.disk.disk_ops 字段

collectd disk_ops 型磁盘插件。

参数描述

collectd.disk.disk_ops.read

类型：浮点数

TODO

collectd.disk.disk_ops.write

类型：浮点数

TODO

collectd.disk.pending_operations

类型：整数

collectd pending_operations 型磁盘插件。

collectd.disk.disk_io_time 字段

collectd disk_io_time 型磁盘插件。

参数描述

collectd.disk.disk_io_time.io_time

类型：浮点数

TODO

collectd.disk.disk_io_time.weighted_io_time

类型：浮点数

TODO

collectd.interface 字段

对应于 collectd 接口插件。

collectd.interface.if_octets 字段

collectd if_octets 型接口插件。

参数描述

collectd.interface.if_octets.rx

类型：浮点数

TODO

collectd.interface.if_octets.tx

类型：浮点数

TODO

collectd.interface.if_packets 字段

collectd if_packets 型接口插件。

参数描述

collectd.interface.if_packets.rx

类型：浮点数

TODO

collectd.interface.if_packets.tx

类型：浮点数

TODO

collectd.interface.if_errors 字段

collectd if_errors 型接口插件。

参数描述

collectd.interface.if_errors.rx

类型：浮点数

TODO

collectd.interface.if_errors.tx

类型：浮点数

TODO

collectd.interface.if_dropped 字段

collectd if_dropped 型接口插件。

参数描述

collectd.interface.if_dropped.rx

类型：浮点数

TODO

collectd.interface.if_dropped.tx

类型：浮点数

TODO

collectd.virt 字段

对应于 collectd virt 插件。

collectd.virt.if_octets 字段

collectd if_octets 型 virt 插件。

参数描述

collectd.virt.if_octets.rx

类型：浮点数

TODO

collectd.virt.if_octets.tx

类型：浮点数

TODO

collectd.virt.if_packets 字段

collectd if_packets 型 virt 插件。

参数描述

collectd.virt.if_packets.rx

类型：浮点数

TODO

collectd.virt.if_packets.tx

类型：浮点数

TODO

collectd.virt.if_errors 字段

collectd if_errors 型 virt 插件。

参数描述

collectd.virt.if_errors.rx

类型：浮点数

TODO

collectd.virt.if_errors.tx

类型：浮点数

TODO

collectd.virt.if_dropped 字段

collectd if_dropped 型 virt 插件。

参数描述

collectd.virt.if_dropped.rx

类型：浮点数

TODO

collectd.virt.if_dropped.tx

类型：浮点数

TODO

collectd.virt.disk_ops 字段

collectd disk_ops 型 virt 插件。

参数描述

collectd.virt.disk_ops.read

类型：浮点数

TODO

collectd.virt.disk_ops.write

类型：浮点数

TODO

collectd.virt.disk_octets 字段

collectd disk_octets 型 virt 插件。

参数描述

collectd.virt.disk_octets.read

类型：浮点数

TODO

collectd.virt.disk_octets.write

类型：浮点数

TODO

collectd.virt.memory

类型：浮点数

collectd 内存型 virt 插件。

collectd.virt.virt_vcpu

类型：浮点数

collectd virt_vcpu 型 virt 插件。

collectd.virt.virt_cpu_total

类型：浮点数

collectd virt_cpu_total 型 virt 插件。

collectd.CPU 字段

对应于 collectd CPU 插件。

参数描述

collectd.CPU.percent

类型：浮点数

collectd 百分比型 CPU 插件。

collectd.df 字段

对应于 collectd df 插件。

参数描述

collectd.df.df_complex

类型：浮点数

collectd df_complex 型 df 插件。

collectd.df.percent_bytes

类型：浮点数

collectd percent_bytes 型 df 插件。

collectd.entropy 字段

对应于 collectd 熵插件。

参数描述

collectd.entropy.entropy

类型：整数

collectd 熵型熵插件。

collectd.memory 字段

对应于 collectd 内存插件。

参数描述

collectd.memory.memory

类型：浮点数

collectd 内存型内存插件。

collectd.memory.percent

类型：浮点数

collectd 百分比型内存插件。

collectd.swap 字段

对应于 collectd 交换插件。

参数描述

collectd.swap.swap

类型：整数

collectd 交换型交换插件。

collectd.swap.swap_io

类型：整数

collectd swap_io 型交换插件。

collectd.load 字段

对应于 collectd 负载插件。

collectd.load.load 字段

collectd 负载型负载插件。

参数描述

collectd.load.load.shortterm

类型：浮点数

TODO

collectd.load.load.midterm

类型：浮点数

TODO

collectd.load.load.longterm

类型：浮点数

TODO

collectd.aggregation 字段

对应于 collectd 聚合插件。

参数描述

collectd.aggregation.percent

类型：浮点数

TODO

collectd.statsd 字段

对应于 collectd statsd 插件。

参数描述

collectd.statsd.host_cpu

类型：整数

collectd CPU 型 statsd 插件。

collectd.statsd.host_elapsed_time

类型：整数

collectd elapsed_time 型 statsd 插件。

collectd.statsd.host_memory

类型：整数

collectd 内存型 statsd 插件。

collectd.statsd.host_nic_speed

类型：整数

collectd nic_speed 型 statsd 插件。

collectd.statsd.host_nic_rx

类型：整数

collectd nic_rx 型 statsd 插件。

collectd.statsd.host_nic_tx

类型：整数

collectd nic_tx 型 statsd 插件。

collectd.statsd.host_nic_rx_dropped

类型：整数

collectd nic_rx_dropped 型 statsd 插件。

collectd.statsd.host_nic_tx_dropped

类型：整数

collectd nic_tx_dropped 型 statsd 插件。

collectd.statsd.host_nic_rx_errors

类型：整数

collectd nic_rx_errors 型 statsd 插件。

collectd.statsd.host_nic_tx_errors

类型：整数

collectd nic_tx_errors 型 statsd 插件。

collectd.statsd.host_storage

类型：整数

collectd 存储型 statsd 插件。

collectd.statsd.host_swap

类型：整数

collectd 交换型 statsd 插件。

collectd.statsd.host_vdsm

类型：整数

collectd VDSM 型 statsd 插件。

collectd.statsd.host_vms

类型：整数

collectd VMS 型 statsd 插件。

collectd.statsd.vm_nic_tx_dropped

类型：整数

collectd nic_tx_dropped 型 statsd 插件。

collectd.statsd.vm_nic_rx_bytes

类型：整数

collectd nic_rx_bytes 型 statsd 插件。

collectd.statsd.vm_nic_tx_bytes

类型：整数

collectd nic_tx_bytes 型 statsd 插件。

collectd.statsd.vm_balloon_min

类型：整数

collectd balloon_min 型 statsd 插件。

collectd.statsd.vm_balloon_max

类型：整数

collectd balloon_max 型 statsd 插件。

collectd.statsd.vm_balloon_target

类型：整数

collectd balloon_target 型 statsd 插件。

collectd.statsd.vm_balloon_cur

类型：整数

collectd balloon_cur 型 statsd 插件。

collectd.statsd.vm_cpu_sys

类型：整数

collectd cpu_sys 型 statsd 插件。

collectd.statsd.vm_cpu_usage

类型：整数

collectd cpu_usage 型 statsd 插件。

collectd.statsd.vm_disk_read_ops

类型：整数

collectd disk_read_ops 型 statsd 插件。

collectd.statsd.vm_disk_write_ops

类型：整数

statsd 插件的 collectd disk_write_ops 类型。

collectd.statsd.vm_disk_flush_latency

类型：整数

collectd disk_flush_latency 型 statsd 插件。

collectd.statsd.vm_disk_apparent_size

类型：整数

collectd disk_apparent_size 型 statsd 插件。

collectd.statsd.vm_disk_write_bytes

类型：整数

collectd disk_write_bytes 型 statsd 插件。

collectd.statsd.vm_disk_write_rate

类型：整数

collectd disk_write_rate 型 statsd 插件。

collectd.statsd.vm_disk_true_size

类型：整数

collectd disk_true_size 型 statsd 插件。

collectd.statsd.vm_disk_read_rate

类型：整数

collectd disk_read_rate 型 statsd 插件。

collectd.statsd.vm_disk_write_latency

类型：整数

collectd disk_write_latency 型 statsd 插件。

collectd.statsd.vm_disk_read_latency

类型：整数

collectd disk_read_latency 型 statsd 插件。

collectd.statsd.vm_disk_read_bytes

类型：整数

collectd disk_read_bytes 型 statsd 插件。

collectd.statsd.vm_nic_rx_dropped

类型：整数

collectd nic_rx_dropped 型 statsd 插件。

collectd.statsd.vm_cpu_user

类型：整数

collectd cpu_user 型 statsd 插件。

collectd.statsd.vm_nic_rx_errors

类型：整数

collectd nic_rx_errors 型 statsd 插件。

collectd.statsd.vm_nic_tx_errors

类型：整数

collectd nic_tx_errors 型 statsd 插件。

collectd.statsd.vm_nic_speed

类型：整数

collectd nic_speed 型 statsd 插件。

collectd.postgresql 字段

对应于 collectd postgresql 插件。

参数描述

collectd.postgresql.pg_n_tup_g

类型：整数

collectd pg_n_tup_g 型 postgresql 插件。

collectd.postgresql.pg_n_tup_c

类型：整数

collectd pg_n_tup_c 型 postgresql 插件。

collectd.postgresql.pg_numbackends

类型：整数

collectd pg_numbackends 型 postgresql 插件。

collectd.postgresql.pg_xact

类型：整数

collectd pg_xact 型 postgresql 插件。

collectd.postgresql.pg_db_size

类型：整数

collectd pg_db_size 型 postgresql 插件。

collectd.postgresql.pg_blks

类型：整数

collectd pg_blks 型 postgresql 插件。