必须记录$hostname，因为它是集群中定位故障节点的唯一可靠标识；需在日志框架中配置注入（如Log4j2用%host{hostname}、Logback用%X{HOSTNAME}等），并确保使用FQDN、容器环境显式注入Node名、采集端保留该字段。
在多机集群中，日志里不带主机名（$hostname），等于在几百台机器的日志海洋里“盲搜”。加上 $hostname 是最简单、最有效的故障节点定位手段——不是可选项，是必选项。
为什么必须记录 $hostname？
集群中各节点运行相同服务、使用相同日志格式，若日志不带主机标识，一旦出现异常（如超时、连接拒绝、数据不一致），你根本无法判断是哪台机器出问题。人工比对 IP 或查进程再反推主机名，耗时且易错。而 $hostname 是操作系统原生、稳定、无需额外维护的唯一性标识（只要 DNS/hosts 配置正确）。
在常见日志框架中添加 hostname 的方法
无需改业务代码，优先通过日志框架配置注入：
-
Log4j2（Java）：在
log4j2.xml的PatternLayout中加入%host{fqdn}或%host{hostname}，例如：%d{HH:mm:ss.SSS} [%t] %-5level %host{hostname} %c{1} - %msg%n -
Logback（Java）：用
%X{HOSTNAME}，需配合System.setProperty("HOSTNAME", InetAddress.getLocalHost().getHostName())初始化，或使用JaninoEventEvaluator动态注入 -
Python logging（标准库）：自定义
Formatter，在format()中插入socket.gethostname()；更推荐用logging.config.dictConfig+%(hostname)s占位符，并提前设置logging.LogRecord.hostname = socket.gethostname() -
Go（Zap / logrus）：在
Fields中统一加hostname: os.Getenv("HOSTNAME")（Docker/K8s 环境下确保该环境变量已注入）
生产环境要注意的几个细节
光加了还不够，得保证它真正可用：
-
避免使用短主机名：如只写
node1，在跨机房或命名重复时会冲突；优先用fqdn（如node1.prod-us-east-1a.example.com），或至少确保集群内唯一 -
容器环境别依赖
/proc/sys/kernel/hostname：Kubernetes Pod 默认 hostname 是 Pod 名，但可能被覆盖；建议显式挂载fieldRef到环境变量：env: [{name: HOSTNAME, valueFrom: {fieldRef: {fieldPath: spec.nodeName}}}]，这样记录的是所在 Node，更贴近物理定位 -
日志采集侧也要保留 hostname：如果用 Filebeat / Fluent Bit 收集日志，确认其配置未覆盖或丢弃原始字段；必要时在
processors中显式添加add_host_metadata或add_kubernetes_metadata
配合日志平台做快速筛选
有了 $hostname 字段，才能发挥日志平台（如 ELK、Loki、Splunk）的价值：
- 在 Kibana 中直接用
hostname: "web-03"过滤，5 秒定位某节点全量日志 - 用 Loki 的 LogQL 写聚合查询：
count_over_time({job="api"} |~ "timeout" | hostname | __error__="" [1h]) by (hostname)，快速发现高频异常节点 - 告警规则中把
hostname作为关键标签输出，钉钉/企微通知里直接显示 “node-db-7 在过去 5 分钟报错 42 次”，省去二次排查
