桶通知
MinIO 桶通知允许管理员在某些对象或桶事件发生时将通知发送到支持的外部服务。MinIO 支持与 Amazon S3 事件通知 类似的桶级和对象级 S3 事件。
支持的通知目标
MinIO 支持将事件通知发布到以下目标
目标 |
描述 |
---|---|
AMQP (RabbitMQ) |
将通知发布到 AMQP 服务,例如 RabbitMQ。 有关教程,请参见 将事件发布到 AMQP (RabbitMQ)。 |
MQTT |
将通知发布到 MQTT 服务。 有关教程,请参见 将事件发布到 MQTT。 |
NATS |
将通知发布到 NATS 服务。 有关教程,请参见 将事件发布到 NATS。 |
NSQ |
将通知发布到 NSQ 服务。 有关教程,请参见 将事件发布到 NSQ |
Elasticsearch |
将通知发布到 Elasticsearch 服务。 有关教程,请参见 将事件发布到 Elasticsearch。 |
Kafka |
将通知发布到 Kafka 服务。 有关教程,请参见 将事件发布到 Kafka。 |
MySQL |
将通知发布到 MySQL 服务。 有关教程,请参见 将事件发布到 MySQL。 |
PostgreSQL |
将通知发布到 PostgreSQL 服务。 有关教程,请参见 将事件发布到 PostgreSQL。 |
Redis |
将通知发布到 Redis 服务。 有关教程,请参见 将事件发布到 Redis。 |
webhook |
将通知发布到 Webhook 服务。 有关教程,请参见 将事件发布到 Webhook。 |
异步与同步桶通知
在版本 RELEASE.2023-06-23T20-26-00Z 中新增: MinIO 支持对所有远程目标使用异步(默认)或同步桶通知。
使用异步传递,MinIO 会在配置的远程端触发事件,并且不会等待响应,然后继续处理下一个事件。异步桶通知优先考虑发送事件,如果远程目标在传输或处理过程中出现瞬时问题,则存在一些事件丢失的风险。
使用同步传递,MinIO 会在配置的远程端触发事件,然后等待远程端确认成功接收,然后再继续处理下一个事件。同步桶通知优先考虑事件传递,存在事件发送速度较慢和队列填满的风险。
要为所有配置的远程目标启用同步桶通知,请使用以下任一设置
将
MINIO_API_SYNC_EVENTS
环境变量设置为on
并重启 MinIO 部署。将
api.sync_events
配置设置为on
并重启 MinIO 部署。
注意
对于同步和异步事件,MinIO 会维护一个针对每个远程目标的队列,用于存储未发送和待处理的事件。默认情况下,队列限制为 100000
。
当队列已满时,MinIO 会丢弃新事件。
可以根据需要增加队列大小,以更好地适应 MinIO 部署和远程目标的事件发送和处理速度。使用 QUEUE_LIMIT
环境变量或配置设置来修改通知方法的此限制。
对于异步事件,MinIO 允许最多 50000
个并发 send
调用。
支持的 S3 事件类型
MinIO 存储桶通知与 Amazon S3 事件通知 兼容。本节列出了所有支持的事件。
对象事件
MinIO 支持在以下 S3 对象事件上触发通知
指定通配符 *
字符以选择与前缀相关的所有事件
复制事件
MinIO 支持在以下 S3 复制事件上触发通知
指定通配符 *
字符以选择所有 s3:Replication
事件
ILM 过渡事件
MinIO 支持在以下 S3 ILM 过渡事件上触发通知
指定通配符 *
字符以选择与前缀相关的所有事件
扫描器事件
MinIO 支持在以下 S3 扫描器 过渡事件上触发通知
- s3:Scanner:ManyVersions
扫描器 查找具有超过 1,000 个版本的 对象。
- s3:Scanner:BigPrefix
扫描器 查找具有超过 50,000 个子文件夹的前缀。
全局事件
MinIO 支持在以下全局事件上触发通知。只能通过 ListenNotification API 监听这些事件