注释
时序见解服务将于 2024 年 7 月 7 日停用。 请考虑尽快将现有环境迁移到备用解决方案。 有关淘汰和迁移的更多信息，请访问我们的文档。
若要在 Azure 时序见解资源管理器中共享自定义视图，可以通过编程方式创建一个自定义视图的参数化 URL。
Azure 时序见解资源管理器支持使用 URL 查询参数，在 URL 中直接指定体验中的视图。 例如，只使用 URL 就可以指定目标环境、搜索谓词以及所需的时间跨度。 当用户选择自定义的 URL 时，界面会提供一个链接，直接指向 Azure 时序见解门户中的相应资产。 数据访问策略适用。
小窍门
- 阅读随附的 Azure 时序见解浏览器文档。
环境标识
environmentId=<guid> 参数指定目标环境 ID。 这是数据访问 FQDN 的一个组件，可以在 Azure 门户的环境概览的右上角找到。 它是 env.timeseries.azure.com 之前的所有内容。
例如，?environmentId=10000000-0000-0000-0000-100000000108 是环境 ID 参数。
时间
可以通过参数化 URL 来指定绝对或相对时间值。
绝对时间值
对于绝对时间值，请使用 from=<integer> 和 to=<integer> 参数。
-
from=<integer>是以 JavaScript 毫秒为单位的一个值，代表搜索时间跨度的开始时间。 -
to=<integer>是以 JavaScript 毫秒为单位的一个值，代表搜索时间跨度的结束时间。
小窍门
若要轻松地将日期转换为 JavaScript 毫秒，请尝试 Epoch 与 Unix 时间戳转换器。
相对时间值
对于相对时间值，请使用 relativeMillis=<value>，其中值为从 API 接收到的最新时间戳算起的 JavaScript 毫秒数。
例如，&relativeMillis=3600000 显示最新的 60 分钟的数据。
接受的值对应于 Azure 时序洞察浏览器的“快速时间”菜单，包括：
-
1800000（过去 30 分钟） -
3600000（过去 60 分钟） -
10800000（过去 3 小时） -
21600000（过去 6 小时） -
43200000（过去 12 小时） -
86400000（过去 24 小时） -
604800000（过去 7 天） -
2592000000（过去 30 小时）
可选参数
timeSeriesDefinitions=<collection of term objects> 参数指定将在 Azure 时序见解视图中显示的谓词术语：
| 参数 | URL 项 | DESCRIPTION |
|---|---|---|
| 名字 | \<string> |
术语的名称。 |
| splitBy | \<string> |
要按其进行拆分的列名。 |
| measureName | \<string> |
度量值的列名。 |
| 谓词 | \<string> |
用于服务器端筛选的 where 子句。 |
| useSum | true |
一个可选参数，指定对度量值使用总和。 |
注释
如果所选 useSum 度量值为 Events，则默认选择计数。
如果未选择 Events，则默认选择平均值。 |
-
multiChartStack=<true/false>键值对在图表中实现堆叠功能。 -
multiChartSameScale=<true/false>键值对不同可选参数的条件启用相同的 Y 轴比例。 - 可以通过
timeBucketUnit=<Unit>&timeBucketSize=<integer>来调整时间间隔滑块，使图表的视图更精细或更光滑，聚合程度更高。 - 可以通过
timezoneOffset=<integer>参数将显示图表的时区设置为 UTC 的偏移量。
| 对/双 | DESCRIPTION |
|---|---|
multiChartStack=false |
true 是默认启用的，因此请将 false 传递到堆栈。 |
multiChartStack=false&multiChartSameScale=true |
必须启用堆叠才能在不同的条件中使用同一 Y 轴比例。 它在默认情况下为 false，因此传递 true 即可启用此功能。 |
timeBucketUnit=<Unit>&timeBucketSize=<integer> |
单位 = days、hours、minutes、seconds、milliseconds。 在书写时，请始终将单位大写。
为 timeBucketSize 传递所需的整数即可定义单位数。 |
timezoneOffset=-<integer> |
整数的单位始终为毫秒。 |
注释
timeBucketUnit 值可以被平滑处理至最多 7 天。 timezoneOffset 值既不是 UTC 也不是本地时间 。
例子
若要将时序定义以 URL 参数的形式添加到 Azure 时序见解环境，请追加：
&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},
{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]
将示例时序定义用于：
- 环境 ID
- 过去 60 分钟的数据
- 构成可选参数的术语（F1PressureID、F2TempStation 和 F3VibrationPL）
可以为视图构造以下参数化 URL：
https://insights.timeseries.azure.com/classic/samples?environmentId=10000000-0000-0000-0000-100000000108&relativeMillis=3600000&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]
上方的 URL 描述并显示带参数的 Azure 时序见解资源管理器视图。
参数化谓词。
共享的完整图表视图。
后续步骤
了解如何使用 C# 查询数据。
了解 Azure 时序洞察浏览器。