如何基于User-Agent头监控客户端版本分布情况？

1. 先建带版本维度的计数器指标 #

打开Cloud Logging的「指标」页面，点「创建指标」选「基于日志的指标」：

• 指标类型选计数器（Counter），用来累计每个版本的请求次数——这就是你之前只能用热力图的核心问题，别再选日志型指标了。
• 设置日志过滤器匹配你的请求日志，比如resource.type="gae_app" AND logName="projects/你的项目ID/logs/http_request"，根据实际资源类型调整即可。
• 添加标签提取器，从User-Agent里抠版本：
  • 若只需要主+次版本（比如1.2），就建个叫version的标签，正则写User-Agent:.*MyApp/(\d+\.\d+)\.\d+，提取组选1。
  • 想分开主、次、补丁版本的话，分别建major_version（正则抓对应主版本号的(\d+)）、minor_version（抓次版本的(\d+)）、patch_version（抓补丁的(\d+)）。
• 给指标起个好记的名字，比如myapp_requests_by_version，保存即可。

2. 配置仪表盘的堆叠条形图/直方图 #

打开Cloud Monitoring仪表盘，新建或编辑现有仪表盘：

• 添加图表，选「指标」类型，找到刚才创建的myapp_requests_by_version。
• 聚合设置里，时间聚合选总和（Sum），对齐周期按需求选（比如15分钟、1小时）。
• 切换到「变换」标签，选百分比（Percent），计算方式挑「相对于同系列的总和」，这样每个版本的数值会自动转换成占总请求的百分比。
• 图表类型选堆叠条形图（适合对比同一时间段各版本占比），或者直方图（按版本值分布展示）。
• 分组设置里选择你之前建的版本标签（比如version），图表就会按版本分组展示了。

3. 优化展示细节 #

• 要是想展示主版本下的次版本层级，就同时保留major_version和minor_version标签，分组时先按主版本分，再按次版本子分组，堆叠条形图会自动展示层级占比。
• 调整时间范围到你需要观察的区间，给图表加个清晰标题，比如「MyApp 请求版本占比（主/次版本）」。

这样就能得到你想要的百分比分布图表，不用再用热力图凑数了。

内容的提问来源于stack exchange，提问作者Brad J