如何在Python Flask中配置Graylog以记录错误与信息？

Got it, let's walk through getting your Flask app sending logs to Graylog properly. I’ve tackled this a few times, so here’s a step-by-step breakdown that should work:

1. 确认依赖与基础 Handler 配置 #

First, assuming you’re using graypy (the most common library for Python ↔ Graylog), you already have it installed via pip install graypy. Now we need to hook it into Flask’s built-in logging system.

Here’s a basic setup you can add when initializing your Flask app:

from flask import Flask
import logging
from graypy import GELFUDPHandler

app = Flask(__name__)

# Configure Graylog handler
graylog_handler = GELFUDPHandler(
    host="your-graylog-server-ip",  # 替换为你的Graylog服务器IP/主机名
    port=12201,  # 默认GELF UDP端口，若在Graylog中修改过请对应调整
    extra_fields={"application": "my-flask-app"}  # 可选：添加自定义字段，方便在Graylog中过滤
)

# 设置日志级别（DEBUG/INFO/WARNING/ERROR/CRITICAL）
graylog_handler.setLevel(logging.INFO)

# 将Handler添加到Flask的日志器中
app.logger.addHandler(graylog_handler)

# 可选：让Flask根日志器的级别与Handler匹配
app.logger.setLevel(logging.INFO)

2. 配置 Graylog 端的输入 #

在测试前，务必在Graylog中创建一个GELF输入：

• 登录Graylog Web界面
• 进入「System → Inputs」
• 从输入下拉菜单中选择「GELF UDP」（如果需要可靠投递也可以选TCP）
• 点击「Launch new input」，填写详情（端口要和Flask配置中一致，默认12201）
• 保存并启动该输入

3. 测试日志发送 #

添加一个测试路由，验证日志是否能到达Graylog：

@app.route("/test-logs")
def test_logs():
    app.logger.info("这是一条从Flask发送到Graylog的信息日志！")
    app.logger.error("哎呀，一条测试错误日志！")
    return "去Graylog查看日志吧！"

启动Flask应用，访问/test-logs端点，然后打开Graylog的搜索页面——你应该能看到两条日志，如果你添加了自定义application字段，它也会显示在日志详情里。

4. 常见问题排查 #

如果日志没出现，检查这些点：

• 防火墙/网络：确保Flask服务器能连通Graylog服务器的配置端口（UDP 12201默认可能被防火墙拦截，可以用nc -uvz your-graylog-ip 12201测试连通性）
• Graylog输入状态：再次确认输入处于运行状态，且监听端口正确
• 日志级别：如果你发送的是DEBUG日志，但Handler级别设为INFO，这些日志不会被发送，按需调整级别即可
• 库版本：确保graypy是较新版本，旧版本可能和新版Graylog存在兼容性问题

进阶：结构化日志 #

如果需要更详细的日志（比如请求数据），可以扩展Handler来添加上下文信息。比如在before_request钩子中记录请求详情：

from flask import request

@app.before_request
def log_request_context():
    app.logger.info("收到请求", extra={
        "path": request.path,
        "method": request.method,
        "remote_addr": request.remote_addr
    })

这些额外字段会以结构化数据的形式出现在Graylog中，方便你过滤和分析请求。

内容的提问来源于stack exchange，提问作者sam ruben