Uptime-Kuma监控工具中Google Workspace通知显示优化方案解析

背景介绍

Uptime-Kuma作为一款开源的监控工具，其通知功能对于运维人员至关重要。在2.0版本升级后，用户反馈Google Workspace通知显示方式发生了变化，导致关键信息无法直接预览，需要额外操作才能查看完整内容，这在实际运维场景中带来了不便。

问题分析

原1.0版本中，Google Workspace通知采用纯文本格式，具有以下优势：

1. 信息直接展示在通知预览中
2. 无需交互即可获取关键内容
3. 跨平台显示一致性高

升级到2.0版本后，通知改为富文本卡片形式，导致：

• Windows系统仅显示标题
• Android设备显示为"Sent an attachment"的通用提示
• 需要多次点击才能查看实际监控内容

技术原理

根据Google Workspace API文档，消息结构应同时包含：

1. cardsV2字段（用于富文本卡片展示）
2. text字段（用于基础文本预览）

当前实现仅包含前者，导致各平台客户端无法获取文本预览内容。

解决方案

优化方案需要修改通知发送逻辑，在保留富文本卡片的同时，补充文本预览字段。具体实现要点：

1. 字段补充：在消息结构中添加text字段
2. 内容设计：可采用监控事件标题作为默认文本内容
3. 兼容性考虑：保持新旧版本API的兼容性

实现建议

对于开发者而言，可以通过以下方式改进：

// 示例代码结构
const message = {
    cardsV2: [/* 原有富文本卡片内容 */],
    text: notificationTitle || "Uptime-Kuma监控通知" // 回退文本
}

用户体验提升

该优化将带来以下改进：

1. 移动设备可直接在通知栏预览关键信息
2. 桌面端无需猜测浏览器配置即可理解通知内容
3. 保持富文本交互功能的同时提升信息获取效率

总结

在监控系统的通知设计中，需要平衡信息丰富度和易用性。Uptime-Kuma的这次优化案例很好地展示了如何通过简单的技术调整，显著提升用户的实际使用体验。这种既保留高级功能又确保基础可用性的设计思路，值得其他开发者借鉴。