4.1 Extractors 入门
4.1 Extractors 入门
Extractors 的作用
Extractors 用于从原始日志中抽取字段,适合快速上手与简单场景。常见的抽取方式包括:
Grok:基于正则模板
Regex:自定义正则表达式
JSON:直接解析 JSON 字段
何时使用 Extractors
小规模、快速解析
日志格式简单
不需要复杂条件判断
创建 Extractor 步骤
打开某条日志详情
点击字段区域 Extract
选择 Grok/Regex/JSON
测试并保存
示例(Regex)
日志:
127.0.0.1 - - [16/Feb/2026:10:00:00 +0800] "GET /api/ping HTTP/1.1" 200 12
Regex:
^(?<client_ip>\S+) .* "(?<method>\S+) (?<path>\S+)"
小结
Extractors 上手快,但不利于复杂规 ...
3.4 Beats/Sidecar
3.4 Beats/Sidecar
适用场景
当需要采集多台服务器日志并统一管理配置时,推荐使用 Graylog Sidecar + Beats。
Sidecar 的作用
统一下发采集配置
管理 Filebeat/Winlogbeat 等采集器
支持多平台(Linux/Windows)
基本流程
在 Graylog UI 创建 Sidecar 配置
安装 Sidecar 客户端
注册并分配配置
采集并发送到 Graylog Input
典型配置示例(Filebeat)
filebeat.inputs:
- type: log
enabled: true
paths:
- /var/log/nginx/access.log
output.logstash:
hosts: ["graylog.example.com:5044"]
小结
Sidecar 适合大规模日志采集。下一章介绍 Extractors。
下一节:4.1 Extractors 入门
返回目录 | 返回首页
3.3 GELF 输入
3.3 GELF 输入
为什么推荐 GELF
GELF(Graylog Extended Log Format)是 Graylog 推荐的结构化日志格式。它支持 JSON 字段,能够减少后续解析的成本。
GELF 输入类型
GELF UDP
GELF TCP
GELF HTTP
建议使用 GELF TCP/HTTP 以保证可靠性。
示例(应用直接发送)
应用层可以使用 GELF SDK/库直接发送:
{
"version": "1.1",
"host": "api-01",
"short_message": "order created",
"level": 6,
"_service": "order",
"_trace_id": "abc123"
}
示例(Nginx GELF)
通过 log_format 输出 JSON,然后使用 Sidecar 或输入解析。
小结
GELF 是最适合结构化日志的输入方式。下一章介绍 Beats/Sidecar。
下一节:3.4 Beats/Sidecar
返回目录 | 返回 ...
3.2 Syslog 输入
3.2 Syslog 输入
适用场景
Syslog 是传统设备与操作系统最常见的日志协议。典型来源包括:
Linux 系统日志
网络设备(交换机、防火墙)
应用网关与中间件
创建 Syslog Input
System → Inputs
选择 Syslog UDP 或 Syslog TCP
绑定节点并配置端口(如 5140)
保存并启动
采集示例(Linux rsyslog)
在客户端 /etc/rsyslog.d/50-graylog.conf:
*.* @@graylog.example.com:5140 # TCP
# 或
*.* @graylog.example.com:5140 # UDP
重启 rsyslog:
systemctl restart rsyslog
解析建议
Syslog 默认是文本,需要配合 Extractors 或 Pipelines 解析字段,比如:
主机名
程序名
日志级别
小结
Syslog Input 是最常用的入口之一。下一章介绍 GELF 输入。
下一节:3.3 GEL ...
3.1 Inputs 概述
3.1 Inputs 概述
Inputs 是什么
Inputs 是 Graylog 接收日志的入口,每个 Input 对应一种协议或格式(如 Syslog、GELF、Beats)。Inputs 可以绑定在任意 Graylog 节点,也可以绑定在集群中所有节点。
常见 Input 类型
Syslog UDP/TCP:传统设备与系统日志
GELF UDP/TCP/HTTP:结构化日志推荐格式
Raw/Plaintext:原始文本
Beats:Filebeat/Winlogbeat 采集
选择 Input 的建议
新系统优先使用 GELF(结构化字段)
传统系统使用 Syslog(需解析)
复杂应用使用 Sidecar + Beats
创建 Input 的步骤
System → Inputs
选择类型并绑定节点
配置端口与接收缓存
保存并开始监听
小结
本章介绍了 Inputs 的定位与类型。下一章以 Syslog 为例进行实践。
下一节:3.2 Syslog 输入
返回目录 | 返回首页
2.3 高可用与负载均衡
2.3 高可用与负载均衡
高可用目标
Web/API 高可用:Graylog 多节点
写入高可用:Inputs 统一入口并可扩展
存储高可用:MongoDB 副本集 + ES/OS 集群
负载均衡策略
1) Web/API(9000)
通过 Nginx/HAProxy/LVS 做四层或七层 LB
开启健康检查
2) Inputs
UDP/TCP Inputs 建议使用四层 LB
GELF/HTTP Inputs 可用七层 LB
设计要点
共享密钥一致:password_secret
Session 一致性:可使用粘性会话或统一 SSO
告警与仪表盘:配置存放于 MongoDB,天然共享
实战建议
Graylog 节点至少 2 台
MongoDB 3 节点副本集
ES/OS 3+ 节点,确保主节点与数据节点分离
小结
本章介绍了高可用与负载均衡的关键设计。下一章进入 Inputs 实操。
下一节:3.1 Inputs 概述
返回目录 | 返回首页
2.2 集群部署
2.2 集群部署
目标
搭建具备高可用能力的 Graylog 集群,适合中等规模日志量。
参考拓扑
2~3 台 Graylog Server(前置 LB)
MongoDB 副本集(3 节点)
OpenSearch/Elasticsearch 集群(3+ 节点)
关键注意点
时间同步:所有节点必须 NTP 同步
一致配置:Graylog 节点配置保持一致
共享密钥:password_secret 在所有节点相同
负载均衡:统一入口 9000 与 Inputs 端口
Graylog 节点示例配置
password_secret = <与其他节点一致>
root_password_sha2 = <sha256密码>
http_bind_address = 0.0.0.0:9000
elasticsearch_hosts = http://es01:9200,http://es02:9200,http://es03:9200
mongodb_uri = mongodb://mongo01,mongo02,mongo03/graylog? ...
2.1 单机部署
2.1 单机部署
目标
快速搭建可用的 Graylog 单机环境,用于学习与验证。
组件版本建议
Graylog 5.x
MongoDB 6.x
OpenSearch 2.x 或 Elasticsearch 7.x
最小配置建议
4C / 8GB / 100GB SSD
单机仅用于测试或小流量
基础部署步骤(示例)
安装 MongoDB
安装 OpenSearch/Elasticsearch
安装 Graylog Server
配置 Graylog:设置 password_secret 与 root_password_sha2
启动服务 并访问 Web UI
核心配置项
password_secret = <随机32位>
root_password_sha2 = <sha256密码>
http_bind_address = 0.0.0.0:9000
elasticsearch_hosts = http://127.0.0.1:9200
mongodb_uri = mongodb://127.0.0.1:2701 ...

