如何在固定到Azure仪表板的工作簿查询部件中使用仪表板时间粒度参数？

先说明下当前Azure平台的原生限制：固定到仪表板的工作簿部件，默认仅自动透传内置的timeRange参数，不会主动把仪表板配置的时间粒度值注入工作簿上下文，因此无法像调用时间范围参数那样直接引用。以下是实际验证可用的落地实现方法：

方法1：配置同名内置参数实现透传联动 #

• 在现有工作簿的参数配置页，新增一个和仪表板内置键名完全一致的参数：参数名设为timeGrain，参数类型选择时间跨度选择器，可设置一个兜底默认值（比如15m）
• 修改所有需要自定义粒度的查询部件：
  • Log Analytics 查询：将原本自动计算的聚合粒度位置，替换为参数引用，把类似bin(TimeGenerated, auto)的写法改为bin(TimeGenerated, {timeGrain})
  • Metrics 查询：把时间粒度的选择项从“自动”切换为刚才创建的timeGrain参数
• 保存工作簿后，重新将目标查询部件固定到Azure仪表板。固定时在高级配置中确认透传参数列表包含自动识别的timeRange、timeGrain项即可，不需要额外手动配置映射
• 生效效果：仪表板全局调整时间范围、修改时间粒度时，会自动把对应值透传给工作簿的同名参数，完全覆盖工作簿内的默认配置。即使时间范围选了3天，只要仪表板设置了15分钟粒度，查询就会严格按该粒度聚合

注意：timeGrain是Azure仪表板预留的固定透传键名，只要工作簿内存在同名参数，仪表板就会自动完成值传递，无需额外接口或自定义扩展。

方法2：硬编码固定粒度（无需联动仪表板设置的场景） #

如果需求仅为强制覆盖自动粒度、不需要跟随仪表板的粒度选项动态切换，不需要对接仪表板的粒度参数：

• 直接在工作簿的查询配置中写死聚合粒度：Log查询中将bin()的间隔设为固定值15m，Metrics查询的时间粒度选择“自定义-15分钟”而非“自动”
• 固定部件到仪表板后，无论仪表板推算出什么粒度，部件都会按配置的固定15分钟粒度渲染，完全不受自动粒度逻辑影响

常见踩坑点 #

• 不要自行自定义参数名称（比如命名为customGrain、dashboardGrain），这类非内置的参数名不会被仪表板识别，无法实现自动透传
• 较早固定的旧版工作簿部件，不会自动识别新增的timeGrain参数，需要删除仪表板上的旧部件，重新从更新后的工作簿固定对应部件，才能获取透传能力
• 如果查询部件的粒度选项仍选了“自动”，就算参数配置正确，部件也会按照自身的自动逻辑覆盖参数传入的粒度值，固定前要确认粒度配置已切换为参数引用模式

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