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

> 消息队列一旦积压，立即收到推送通知。Pocket Alert 将 RabbitMQ 或 SQS 的队列深度和消费者延迟转为手机告警，不到一秒即可送达。

<!-- source: https://pocketalert.app/zh/use-cases/queue-monitoring-alerts -->

最后更新：2026-08-11

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

## 队列告警只需三步

1. **测量队列** — 在 cron 脚本中通过 redis-cli LLEN、rabbitmqctl 或 AWS CLI 读取队列深度。
2. **超过阈值即触发** — 当深度超过阈值时调用 pocketalert send（或通过 curl 调用消息 API）。
3. **及时处理** — 你的手机会在一秒内震动。在用户察觉之前清空积压。

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

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

- **深度阈值** — 当深度超出你设置的阈值时，cron 脚本中的阈值会触发告警。
- **停滞检测** — 积压失控或消费者完全停滞时会发送推送通知，而短暂波动则保持在阈值之下。
- **消息中包含深度** — 将队列名称和当前深度直接放入调用的标题和消息中。
- **支持任意消息代理** — `redis-cli LLEN`、`rabbitmqctl list_queues` 和用于 SQS 的 AWS CLI 都会返回可以发送的数字。
- **按队列分频道** — 每个队列都有自己的 application_id，因此支付和邮件告警不会混在一起。
- **亚秒级送达** — 推送在一秒内送达，足够快，能在积压扩大之前及时处理。

## 为积压的队列设置告警

### 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`，使支付和邮件告警进入各自的频道。[文档](https://info.pocketalert.app/getting-started.html)中介绍了目标设置和按应用分频道的方法。

## 常见问题

### 如何为积压的队列获取告警？

运行一个小型 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` 发送，这样它们会进入历史记录而不会震动提醒。
