coco/coco-synthetic-image-publication-monitor

synthetic-publication 镜像文档

镜像概述

synthetic-publication 是一个用于执行测试图像发布并监控问题的服务镜像。该服务定期向当前栈的 cms-notifier 发送随机图像，图像经 kafka-bridge 转发后存储到特定 S3 bucket，服务在等待指定时间后检查 S3 中的内容是否与发布的图像匹配。若报告“图像未找到”，将触发追踪作业并在 Slack 频道报警。自 2015 年 7 月 17 日起，该服务仅检查容器化栈中图像发布的状态。

核心功能与特性

• 定期测试发布：周期性向 cms-notifier 发送随机图像，模拟图像发布流程
• S3 内容验证：在指定等待时间后，检查 S3 bucket 中存储的内容是否与发布图像一致
• 健康检查：提供标准健康检查端点，反映发布功能是否正常
• 历史记录查询：展示最近十次发布结果
• 强制发布：支持手动触发图像生成与发布，便于本地测试
• 异常追踪与报警：图像未找到时，触发追踪作业并在 Slack 频道报警

使用场景与适用范围

• 监控容器化栈中图像发布流程的健康状态
• 定期验证图像从发布到存储的全链路可用性
• 本地开发与测试环境中手动触发发布流程
• 问题排查时获取历史发布结果

端点说明

1. /__health

• 功能：FT 标准健康检查端点
• 状态：若发布功能正常，返回 OK
• 说明：检查最近一次发布的状态

2. /history

• 功能：展示最近十次发布结果
• 格式：自定义格式
• 用途：查看历史发布记录，辅助问题排查

3. /forcePublish

• 功能：手动触发图像生成与发布
• 注意事项：使用时需关闭 tick 标志，否则可能因发布检查时间问题导致结果不准确；主要用于本地测试

访问方法

在容器化环境中，vulcand 路由会将请求转发至该服务，需将请求的 Host 头设置为 Host: syn-pub（缩写形式）。

示例

查询历史发布记录：

bash
curl localhost:8080/history -H "Host: syn-pub"

健康检查状态也会在聚合健康检查中显示。

注意事项

• /__health 端点状态取决于最近一次发布的结果
• 使用 /forcePublish 时，确保 tick 标志已禁用，避免时间同步问题导致的结果异常
• 仅监控容器化栈中的图像发布状态，不涉及旧栈