針對 Azure 時間序列深入解析 Gen2 環境進行診斷與疑難排解

注意

「時間序列深入解析」服務將於 2024 年 7 月 7 日淘汰。 請考慮盡快將現有的環境移轉至替代解決方案。 如需淘汰和移轉的詳細資訊，請造訪我們的文件。

本文摘要說明使用 Azure 時間序列深入解析 Gen2 環境時，可能會遇到的幾個常見問題。 文章中也會描述每個問題的可能發生原因和解決方案。

問題：我在 Gen2 總管中找不到我的環境

如果您沒有存取時間序列深入解析環境的權限，就可能會發生這個問題。 使用者需要讀取器層級存取角色，才能檢視他們的時間序列深入解析環境。 若要確認目前的存取層級並授與其他存取權，請移至 Azure 入口網站中，時間序列深入解析資源的 [資料存取原則] 區段。

問題：在 Gen2 總管中看不到任何資料

您無法在 Azure 時間序列深入解析 Gen2 總管中看到資料有幾個常見原因。

• 事件來源可能沒有接收資料。

  請確認事件來源 (事件中樞或 IoT 中樞)，是否正從您的標籤或執行個體接收資料。 請在 Azure 入口網站中，瀏覽至您資源的概觀頁面以進行確認。

  

• 事件來源資料不是 JSON 格式。

  時間序列深入解析僅支援 JSON 資料。 如需 JSON 範例，請閱讀支援的 JSON 樣貌。

• 事件來源索引鍵遺漏必要的權限。

  • 針對 IoT 中樞，您必須提供具有「服務連接」權限的索引鍵。

    

    • iothubowner 與 service 原則都可使用，因為兩者皆有服務連線權限。

  • 針對事件中樞，您必須提供具有「接聽」權限的索引鍵。

    

    • 讀取和管理原則都可使用，因為這兩個原則均有接聽權限。

• 您提供的取用者群組不是時間序列深入解析專用的。

  在註冊 IoT 中樞或事件中樞期間指定的取用者群組是要用於讀取資料的。 此取用者群組每個環境都必須是唯一的。 如果共用取用者群組，基礎事件中樞會自動且隨機地與其中一個讀取器中斷連線。 提供唯一的取用者群組讓時間序列深入解析讀取。

• 您在佈建期間指定的時間序列識別碼屬性不正確、遺漏，或為 null。

  如果時間序列識別碼屬性設定不正確，佈建環境時就可能會發生這個問題。 如需詳細資訊，請閱讀選擇時間序列識別碼的最佳做法。 目前您無法將現有的時間序列深入解析環境更新為使用不同的時間序列識別碼。

問題：只顯示部分資料，遺漏了部分資料

您可能傳送了沒有時間序列識別碼的資料。

• 在酬載中傳送沒有時間序列識別碼欄位的事件時，就可能會發生這個問題。 如需詳細資訊，請閱讀支援的 JSON 樣貌。

• 發生這個問題的原因可能是因為您的環境正在進行節流。

  注意

  目前時間序列深入解析支援最高 1 Mbps 的擷取速率。

問題：資料已顯示，但現在擷取已停止

• 您的事件來源金鑰可能已重新產生，因此您的 Gen2 環境需要新的事件來源金鑰。

在建立事件來源時所提供的金鑰不再有效時，就會發生這個問題。 您會在中樞中看到遙測資料，但時間序列深入解析中看不到輸入接收的訊息。 如果您不確定金鑰是否已重新產生，可以在事件中樞的活動記錄中搜尋「建立或更新命名空間授權規則」，或在「建立或更新 IotHub 資源」搜尋 IoT 中樞。

若要使用新的金鑰更新您的時間序列深入解析 Gen2 環境，請在Azure 入口網站中開啟中樞資源，並複製新的金鑰。 導覽至您的 TSI 資源，然後按一下 [事件來源]。

選取已停止擷取的事件來源、貼上新的金鑰，然後按一下 [儲存]。

問題：我的事件來源的時間戳記屬性名稱沒有作用

請確定名稱和值符合下列規則︰

• 時間戳記屬性名稱區分大小寫。
• 來自事件來源的時間戳記屬性值 (JSON 字串) 格式為 yyyy-MM-ddTHH:mm:ss.FFFFFFFK。 此類型字串的其中一個範例為 "2008-04-12T12:53Z"。

若要確保系統已擷取時間戳記屬性名稱且正常運作，最簡單方式是使用時間序列深入解析 Gen2 總管。 在時間序列深入解析 Gen2 總管中，當您輸入時間戳記屬性名稱之後，使用圖表選取一段時間。 以滑鼠右鍵按一下選取範圍，然後選取 [探索事件] 選項。 第一個資料行標頭就是您的時間戳記屬性名稱。 它的字組 Timestamp 旁邊應該有 ($ts)，而非：

• (abc)，這表示時間序列深入解析將資料值讀取為字串。
• 行事曆圖示，這表示時間序列深入解析將資料值讀取為日期時間。
• #，這表示時間序列深入解析將資料值讀取為整數。

如果未明確指定時間戳記屬性，就會使用事件的 IoT 中樞或事件中樞加入佇列時間做為預設時間戳記。

問題：我無法在總管中檢視來自一般性存放區的資料

• 您可能最近已佈建一般性存放區，且資料仍在流入。
• 您可能已刪除一般性存放區，在此情況下，您會遺失資料。

問題：我無法檢視或編輯時間序列模型

• 您可能存取了時間序列深入解析 S1 或 S2 環境。

  僅在隨用隨付環境中才支援時間序列模型。 如需如何透過時間序列深入解析 Gen2 總管存取 S1 或 S2 環境的詳細資訊，請閱讀在總管中將資料視覺化。

  

• 您可能沒有檢視及編輯模型的權限。

  使用者需要參與者層級存取權，才能編輯及檢視他們的時間序列模型。 若要確認目前的存取層級並授與其他存取權，請移至 Azure 入口網站中，時間序列深入解析資源的 [資料存取原則] 區段。

問題：Gen2 總管中的所有執行個體都缺少上層

如果您的環境未定義時間序列模型階層，就可能會發生這個問題。 如需詳細資訊，請閱讀如何使用時間序列模型。

下一步

• 了解如何使用時間序列模型。

• 了解支援的 JSON 樣貌。

• 檢閱 Azure 時間序列深入解析 Gen2 中的規劃和限制。