生产环境下Django应用的Papertrail日志未显示问题求助

1. 确认生产环境LOGGING配置是否生效 #

你的配置里注释提到生产环境要添加papertrail handler，但要确保部署后这个配置确实被加载：

• 可以通过环境变量区分开发/生产配置，在settings.py中补充逻辑：

  import os
  # 根据Heroku的环境变量判断生产环境
  if os.environ.get('DJANGO_ENV') == 'production' or not os.environ.get('DEBUG'):
      LOGGING['loggers']['']['handlers'] = ['console', 'papertrail']
  else:
      LOGGING['loggers']['']['handlers'] = ['console']
  

• 登录Heroku验证配置：执行heroku run python manage.py shell，然后输入以下代码检查：

  from django.conf import settings
  print(settings.LOGGING['loggers']['']['handlers'])
  

  输出应包含papertrail。

2. 修正SysLogHandler的传输协议 #

SysLogHandler默认使用UDP协议，但Papertrail推荐用TCP，这是常见的丢日志原因：

• 在papertrail handler中添加socktype参数，记得顶部导入socket：

  import socket
  
  LOGGING = {
      # ... 其他配置不变
      'handlers': {
          # ... console handler不变
          'papertrail': {
              'level': 'INFO',
              'class': 'logging.handlers.SysLogHandler',
              'address': ('logsX.papertrailapp.com', XXXXX),
              'formatter': 'verbose',
              'socktype': socket.SOCK_STREAM,  # 指定TCP传输
          },
      },
      # ... 其他配置不变
  }
  

3. 验证Heroku到Papertrail的网络连通性 #

执行以下命令测试dyno能否连接到Papertrail服务器：

heroku run telnet logsX.papertrailapp.com XXXXX

• 如果连接成功，会进入telnet会话，说明网络无问题；
• 如果连接失败，检查Papertrail的地址/端口是否正确，或联系Heroku支持确认网络限制。

4. 排查日志生成与传输链路 #

• 先检查Heroku本地日志：执行heroku logs --tail，访问你的index页面，看是否能看到test这条warning。如果console里有日志，说明日志生成正常，问题出在Papertrail传输；如果console里也没有，说明Django日志配置未生效，需检查：
  • 确认disable_existing_loggers设为False，避免覆盖默认logger；
  • 检查views中的logger是否正确获取：logger = logging.getLogger(__name__)是否能继承root logger的配置。

5. 替换为更稳定的SocketHandler #

如果SysLogHandler仍有问题，尝试用SocketHandler直接建立TCP连接：

LOGGING = {
    # ... 其他配置不变
    'handlers': {
        # ... console handler不变
        'papertrail': {
            'level': 'INFO',
            'class': 'logging.handlers.SocketHandler',
            'host': 'logsX.papertrailapp.com',
            'port': XXXXX,
            'formatter': 'verbose',
        },
    },
    # ... 其他配置不变
}

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