Django-Celery定时任务中Sentry指定monitor_slug不生效问题

问题描述 #

我在使用Sentry监控Django-Celery定时任务时，先在Sentry后台创建了名为check-server-alive-cron-job的Cron监控，接着用@sentry_sdk.crons.monitor(monitor_slug="check-server-alive-cron-job")装饰Celery任务函数is_server_alive。但任务实际运行时，并没有关联到我创建的监控，反而自动生成了一个名为"test"的新监控并正常捕获任务信号，而原check-server-alive-cron-job监控始终没有数据。

使用的依赖版本：

• celery==5.2.7
• django-celery-results==2.4.0
• django-celery-beat==2.5.0
• redis==4.5.4
• sentry-sdk==1.21.0

可能的原因及解决步骤 #

1. 补全Sentry SDK的Cron监控集成配置 #

确保在Django配置文件（如settings.py）中初始化Sentry时，添加了CronMonitorIntegration，这是关联手动创建监控的必要配置：

import sentry_sdk
from sentry_sdk.integrations.celery import CeleryIntegration
from sentry_sdk.integrations.django import DjangoIntegration
from sentry_sdk.crons import CronMonitorIntegration

sentry_sdk.init(
    dsn="你的Sentry DSN",
    integrations=[
        DjangoIntegration(),
        CeleryIntegration(),
        CronMonitorIntegration(),  # 必须添加该集成才能识别手动创建的监控slug
    ],
    traces_sample_rate=1.0,
    send_default_pii=True,
)

若遗漏此集成，SDK无法匹配手动创建的监控，会默认生成"test"监控。

2. 调整装饰器顺序 #

Celery任务的装饰器顺序至关重要，@sentry_sdk.crons.monitor必须放在@app.task的下方，否则无法正确捕获任务事件：

from celery import app
import sentry_sdk

@app.task
@sentry_sdk.crons.monitor(monitor_slug="check-server-alive-cron-job")
def is_server_alive():
    # 任务逻辑代码
    pass

3. 校验监控slug的一致性 #

检查Sentry后台创建的监控slug与装饰器中monitor_slug的拼写、大小写、连字符是否完全一致——Sentry的slug区分大小写，任何细微差异都会导致关联失败，触发默认的"test"监控生成。

4. 升级Sentry SDK版本 #

你使用的sentry-sdk==1.21.0版本较旧，后续版本修复了部分Cron监控关联逻辑问题。建议升级到稳定版本：

pip install --upgrade sentry-sdk>=1.30.0

升级后重启Celery Worker和Beat服务，再测试任务运行。

5. 确认Celery Beat的任务调度配置 #

确保django-celery-beat的定时任务配置正确，is_server_alive是由Celery Beat调度运行的（手动触发的任务可能无法正确关联Cron监控）。可通过Django后台的Periodic Tasks页面确认调度规则无误。

6. 排查日志定位问题 #

查看Celery Worker的日志，检查是否有Sentry相关的错误提示；同时在Sentry后台查看"test"监控的详情，确认任务关联的异常信息，这些日志能帮助定位具体的关联失败原因。

内容的提问来源于stack exchange，提问作者C.K.