使用參數化 URL 共用自訂檢視
注意
「時間序列深入解析」服務將於 2024 年 7 月 7 日淘汰。 請考慮盡快將現有的環境移轉至替代解決方案。 如需淘汰和移轉的詳細資訊,請造訪我們的文件。
若要在 Azure 時間序列深入解析總管中共用自訂檢視,您可以程式設計方式建立自訂檢視的參數化 URL。
Azure 時間序列深入解析總管支援 URL 查詢參數,以便直接從 URL 指定檢視。 例如,僅使用 URL,您就可以指定目標環境、搜尋述詞,以及所需的時間範圍。 當使用者選取自訂的 URL 時,介面會在 Azure 時間序列深入解析入口網站中提供該資產的直接連結。 適用資料存取原則。
提示
- 閱讀隨附的 Azure 時間序列深入解析總管文件。
環境識別碼
environmentId=<guid>
參數可指定目標環境識別碼。 其是資料存取 FQDN 的元件,而您可以在 Azure 入口網站中環境概觀的右上角找到此元件。 其是在 env.timeseries.azure.com
之前的所有內容。
範例環境識別碼參數為 ?environmentId=10000000-0000-0000-0000-100000000108
。
Time
您可以使用參數化 URL 來指定絕對或相對時間值。
絕對時間值
對於絕對時間值,使用 from=<integer>
和 to=<integer>
參數。
from=<integer>
是搜尋範圍的開始時間值 (以 JavaScript 毫秒為單位)。to=<integer>
是搜尋範圍的結束時間值 (以 JavaScript 毫秒為單位)。
提示
若要輕鬆地將日期轉譯成 JavaScript 毫秒,請嘗試 Epoch 和 Unix 時間戳記轉換器。
相對時間值
對於相對時間值,使用 relativeMillis=<value>
,其中 value 是以 JavaScript 毫秒表示,此毫秒來自從 API 收到的最新時間戳記。
例如,&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 項目 | 描述 |
---|---|---|
name | \<string> |
term 的名稱。 |
splitBy | \<string> |
split by 的資料行名稱。 |
measureName | \<string> |
measure 的資料行名稱。 |
predicate | \<string> |
用於伺服器端篩選的 where 子句。 |
useSum | 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> |
單位 = days hours minutes seconds milliseconds 。 單位一律大寫。 針對 timeBucketSize 傳遞所需的整數,以定義單位數。 |
timezoneOffset=-<integer> |
整數一律以毫秒為單位。 |
注意
timeBucketUnit 值最多可以平滑 7 天。 timezoneOffset 值既不是 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 時間序列深入解析總管。