队列监控

监控队列 在积压失控之前。

队列积压很容易被忽视,直到消息堆积、用户感受到延迟。让一个小型 cron 检查脚本通过 redis-cli、rabbitmqctl 或 AWS CLI 读取深度并调用 Pocket Alert,停滞的 worker 就能在一秒内推送到你的手机。

<1s 内推送支持任意消息代理Redis · RabbitMQ · SQS更新于
功能

在积压还小的时候及时发现

cron 中一行深度检查即可调用 Pocket Alert。它把你原本不会去盯的数字,变成可以立即行动的推送通知。

深度阈值

当深度超出你设置的阈值时,cron 脚本中的阈值会触发告警。

停滞检测

积压失控或消费者完全停滞时会发送推送通知,而短暂波动则保持在阈值之下。

消息中包含深度

将队列名称和当前深度直接放入调用的标题和消息中。

支持任意消息代理

`redis-cli LLEN`、`rabbitmqctl list_queues` 和用于 SQS 的 AWS CLI 都会返回可以发送的数字。

按队列分频道

每个队列都有自己的 application_id,因此支付和邮件告警不会混在一起。

亚秒级送达

推送在一秒内送达,足够快,能在积压扩大之前及时处理。

快速开始

队列告警只需三步

1

测量队列

在 cron 脚本中通过 redis-cli LLEN、rabbitmqctl 或 AWS CLI 读取队列深度。

2

超过阈值即触发

当深度超过阈值时调用 pocketalert send(或通过 curl 调用消息 API)。

3

及时处理

你的手机会在一秒内震动。在用户察觉之前清空积压。

为积压的队列设置告警

Redis 列表深度(LLEN)

一个小型 cron 脚本读取深度,并在超过阈值时调用 CLI:

* * * * * depth=$(redis-cli LLEN queue:emails); \
  [ "$depth" -gt 10000 ] && pocketalert send \
    -t "Queue backed up" -m "emails: $depth pending"

RabbitMQ 队列长度

* * * * * depth=$(rabbitmqctl list_queues -p / name messages | awk '$1=="emails"{print $2}'); \
  [ "$depth" -gt 10000 ] && pocketalert send \
    -t "Queue backed up" -m "emails: $depth messages"

通过 API 获取 SQS 近似深度

depth=$(aws sqs get-queue-attributes --queue-url "$QUEUE_URL" \
  --attribute-names ApproximateNumberOfMessages \
  --query 'Attributes.ApproximateNumberOfMessages' --output text)
[ "$depth" -gt 10000 ] && curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"Queue backed up\",\"message\":\"orders: $depth pending\",\"level\":\"critical\"}"

为每个队列设置独立的 application_id,使支付和邮件告警进入各自的频道。文档中介绍了目标设置和按应用分频道的方法。

常见问题

常见问题解答

运行一个小型 cron 脚本,读取队列深度,并在超过阈值时调用 `pocketalert send`(或通过 curl 调用消息 API)。支持 Redis `LLEN`、RabbitMQ `list_queues` 和 SQS `ApproximateNumberOfMessages`。

在脚本中设置阈值。短暂且可自行恢复的积压不会超过阈值,因此只有真正的停滞或深度持续失控才会发送推送通知。

任何可以通过命令行查询的消息代理都可以使用。`redis-cli LLEN queue:emails`、`rabbitmqctl list_queues` 或用于 SQS 的 AWS CLI,都会返回一个可以比较并发送的数字。

将队列名称和当前深度直接放入调用的标题和消息中,推送内容会显示为 `emails: 18420 pending`,无需额外的胶水代码。

为每个队列传入不同的 `application_id`。emails 队列和 payments worker 会进入各自独立的频道,你看到告警就能知道该去哪里排查。

可以。为告警设置 `level=critical`,Android 会将其发布到可绕过勿扰模式的频道,而 iPhone 会将其显示为时效性通知,并能突破专注模式。如果你也会推送常规深度报告,请使用 `level=silent` 发送,这样它们会进入历史记录而不会震动提醒。

队列落后时,第一时间知道。

将监控或简单的深度检查脚本指向 Pocket Alert,在用户察觉之前发现积压。