使用參數化URL共用自定義檢視
注意
時間序列深入解析服務將於 2024 年 7 月 7 日淘汰。 請考慮儘快將現有的環境移轉至替代解決方案。 如需關於淘汰和移轉的更多資訊，請瀏覽我們的 文件。
若要在 Azure 時序分析總管中共用自定義檢視，您可以程式化地建立該自定義檢視的參數化 URL。
Azure 時間序列 Insights Explorer 支援 URL 查詢參數，以直接從 URL 指定檢視。 例如，僅使用 URL，您可以指定目標環境、搜尋述詞和所需的時間範圍。 當使用者選取自訂 URL 時，介面會直接提供連結至 Azure 時間序列洞察入口網站中的該資產。 套用數據存取原則。
小提示
- 閱讀隨附的 Azure 時間序列見解瀏覽器 文件。
環境標識碼
environmentId=<guid> 參數會指定目標環境標識碼。 它是數據存取 FQDN 的元件，您可以在 Azure 入口網站的環境概觀右上角找到它。 這是 env.timeseries.azure.com之前的一切。
範例環境識別子參數是 ?environmentId=10000000-0000-0000-0000-100000000108。
時間
您可以使用參數化 URL 來指定絕對或相對時間值。
絕對時間值
針對絕對時間值，請使用 from=<integer> 和 to=<integer> 參數。
-
from=<integer>是搜尋範圍的開始時間以 JavaScript 毫秒為單位的值。 -
to=<integer>是搜尋範圍結束時間的 JavaScript 毫秒值。
提示
若要輕鬆地將日期轉譯成 JavaScript 毫秒，請嘗試 Epoch & Unix Timestamp Converter。
相對時間值
針對相對時間值，請使用 relativeMillis=<value>，其中 值 是以 JavaScript 毫秒為單位從 API 收到的最新時間戳。
例如，&relativeMillis=3600000 顯示最近 60 分鐘的數據。
接受的值會對應至 Azure 時間序列 Insights Explorer 快速時間 選單，並包括：
-
1800000（過去 30 分鐘） -
3600000（過去 60 分鐘） -
10800000（過去 3 小時） -
21600000（過去 6 小時） -
43200000（過去 12 小時） -
86400000（過去 24 小時） -
604800000（過去 7 天） -
2592000000（過去 30 小時）
選擇性參數
timeSeriesDefinitions=<collection of term objects> 參數會指定將在 Azure 時間序列深入解析檢視中顯示的述詞字詞：
| 參數 | URL 項目 | 描述 |
|---|---|---|
| 名稱 | \<string> |
字詞的名稱是。 |
| 分割為 | \<string> |
要將欄位名稱 依進行分割。 |
| measureName | \<string> |
量值的資料列名稱。 |
| 述詞 | \<string> |
用於伺服器端篩選的 條件子句。 |
| 使用和 | true |
選擇性參數，指定使用量值的總和。 |
注意
如果 Events 是選取的 useSum 量值，則預設會選取計數。
如果未選取 Events，則預設會選取平均值。 |
- 索引鍵/值組
multiChartStack=<true/false>可讓您在圖表中堆疊。 -
multiChartSameScale=<true/false>索引鍵/值組可在選擇性參數內跨字詞啟用相同的 Y 軸刻度。 -
timeBucketUnit=<Unit>&timeBucketSize=<integer>可讓您調整間隔滑桿，以提供更細微或更流暢、更匯總的圖表檢視。 -
timezoneOffset=<integer>參數可讓您將圖表的時區設定為UTC的位移。
| 配對對數 | 描述 |
|---|---|
multiChartStack=false |
默認啟用 true，因此請將 false 傳遞到堆疊中。 |
multiChartStack=false&multiChartSameScale=true |
必須啟用堆疊，才能在不同的項目中使用相同的 Y 軸刻度。 預設為 false，因此傳遞 true 將會啟用此功能。 |
timeBucketUnit=<Unit>&timeBucketSize=<integer> |
Units = days、hours、minutes、seconds、milliseconds。 請務必將單位大寫。
傳遞 timeBucketSize 所需的整數，以定義單位數目。 |
timezoneOffset=-<integer> |
整數一律以毫秒為單位。 |
注意
timeBucketUnit 值最多可以平滑 7 天。 時區偏移 的值既不是 UTC 也不是當地時間。
例子
若要將時間序列定義新增至 Azure 時間序列深入解析環境作為 URL 參數，請附加：
&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'"}]
使用範例時間序列定義，用於：
- 環境標識碼
- 過去 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 時間序列洞察瀏覽器。