Azure Time Series Insights Gen2 環境の診断とトラブルシューティング
手記
Time Series Insights サービスは、2024 年 7 月 7 日に廃止されます。 既存の環境をできるだけ早く別のソリューションに移行することを検討してください。 非推奨と移行の詳細については、
この記事では、Azure Time Series Insights Gen2 環境で作業するときに発生する可能性のあるいくつかの一般的な問題について説明します。 この記事では、各問題の潜在的な原因と解決策についても説明します。
問題: Gen2 エクスプローラーで自分の環境が見つからない
この問題は、Time Series Insights 環境にアクセスするためのアクセス許可がない場合に発生する可能性があります。 ユーザーには、Time Series Insights 環境を表示するための閲覧者レベルのアクセス ロールが必要です。 現在のアクセス レベルを確認し、追加のアクセス権を付与するには、Azure portalの Time Series Insights リソースの データ アクセス ポリシー セクションに移動します。
問題: Gen2 エクスプローラーにデータが表示されない
Azure Time Series Insights Gen2 エクスプローラーにデータが表示されない一般的な理由はいくつかあります。
イベント ソースがデータを受信していない可能性があります。
イベント ソース (イベント ハブまたは IoT ハブ) がタグまたはインスタンスからデータを受信していることを確認します。 確認するには、Azure portal でリソースの概要ページに移動します。
イベント ソース データが JSON 形式ではありません。
Time Series Insights では、JSON データのみがサポートされます。 JSON サンプルについては、サポートされている JSON 図形 を参照してください。
イベント ソース キーに必要なアクセス許可がありません。
IoT ハブの場合は、サービス接続許可 を持つキーを指定する必要があります。
- ポリシー
iothubowner とサービス はどちらも、サービス接続 アクセス許可持っているため機能します。
- ポリシー
イベント ハブには、Listen のアクセス許可を持つキーを指定する必要があります。
- 読み取り ポリシーと 管理 ポリシーは、リッスン 権限を持っているために機能します。
提供されたコンシューマー グループは、Time Series Insights に限定されません。
IoT ハブまたはイベント ハブの登録時に、データの読み取りに使用するコンシューマー グループを指定します。 このコンシューマー グループは、環境ごとに一意である必要があります。 コンシューマー グループが共有されている場合、基になるイベント ハブはリーダーの 1 つをランダムに自動的に切断します。 Time Series Insights の読み取り対象となる一意のコンシューマー グループを提供します。
プロビジョニング時に指定されたタイム シリーズ ID プロパティが正しくない、見つからない、または null です。
この問題は、環境のプロビジョニング時にタイム シリーズ ID プロパティが正しく構成されていない場合に発生する可能性があります。 詳細については、「タイム シリーズ IDを選択するためのベスト プラクティス」を参照してください。 現時点では、別のタイム シリーズ ID を使用するように既存の Time Series Insights 環境を更新することはできません。
問題: 一部のデータが表示されるが、一部が欠落している
時系列 ID なしでデータを送信している可能性があります。
この問題は、ペイロードにタイム シリーズ ID フィールドを含まないイベントを送信するときに発生する可能性があります。 詳細については、「サポートされている JSON 図形 」を参照してください。
この問題は、環境が制限されているために発生する可能性があります。
手記
現時点では、Time Series Insights では最大インジェスト レート 1 Mbps がサポートされています。
問題: データが表示されていましたが、インジェストが停止しました
- イベント ソース キーが再生成され、Gen2 環境に新しいイベント ソース キーが必要な場合があります。
この問題は、イベント ソースの作成時に指定されたキーが無効になった場合に発生します。 ハブにはテレメトリが表示されますが、Time Series Insights では受信したイングレス メッセージは表示されません。 キーが再生成されたかどうかわからない場合は、Event Hubs のアクティビティ ログで "名前空間承認規則の作成または更新" を検索するか、IoT Hub の "Create or update IotHub Resource" を検索します。
Time Series Insights Gen2 環境を新しいキーで更新するには、Azure portal でハブ リソースを開き、新しいキーをコピーします。 TSI リソースに移動し、[イベント ソース] をクリックします。
インジェストが停止したイベント ソースを選択し、新しいキーを貼り付けて [保存] をクリックします。
問題: イベント ソースの Timestamp プロパティ名が機能しない
名前と値が次の規則に準拠していることを確認します。
- Timestampプロパティ名は大文字と小文字を区別します。
- イベント ソースから JSON 文字列として取得される Timestamp プロパティ値の形式は
yyyy-MM-ddTHH:mm:ss.FFFFFFFK。 このような文字列の例は、"2008-04-12T12:53Z"です。
タイムスタンプ プロパティ名がキャプチャされ、正常に動作することを確認する最も簡単な方法は、Time Series Insights Gen2 エクスプローラーを使用することです。 Time Series Insights Gen2 エクスプローラー内で、グラフを使用して、Timestamp プロパティ名を指定した後の期間を選択します。 選択した項目を右クリックし、イベントを探索 オプションを選択します。 最初の列ヘッダーは、Timestamp プロパティ名です。
Timestampという単語の隣にではなく、($ts) が必要です。
-
(abc)。Time Series Insights がデータ値を文字列として読み取っていることを示します。 - カレンダー アイコン。Time Series Insights がデータ値を datetime として読み取っていることを示します。
-
#。Time Series Insights がデータ値を整数として読み取っていることを示します。
Timestamp プロパティが明示的に指定されていない場合は、イベントの IoT ハブまたはイベント ハブのエンキュー時間が既定のタイム スタンプとして使用されます。
問題: エクスプローラーでウォーム ストアのデータを表示できない
- ウォーム ストアを最近プロビジョニングした可能性があり、データはまだ流れ込み中です。
- ウォーム ストアを削除した可能性があります。その場合、データが失われた可能性があります。
問題: 時系列モデルを表示または編集できない
Time Series Insights S1 または S2 環境にアクセスしている可能性があります。
タイム シリーズ モデルは、従量課金制環境でのみサポートされます。 Time Series Insights Gen2 エクスプローラーから S1 または S2 環境にアクセスする方法の詳細については、エクスプローラーでデータ
視覚化する方法に関する記事を参照してください。 
モデルを表示および編集するためのアクセス許可がない場合があります。
ユーザーは、時系列モデルを編集および表示するために共同作成者レベルのアクセス権が必要です。 現在のアクセス レベルを確認し、追加のアクセス権を付与するには、Azure portal の Time Series Insights リソースの データ アクセス ポリシー セクションに移動します。
問題: Gen2 エクスプローラー内のすべてのインスタンスに親がありません
この問題は、環境にタイム シリーズ モデル階層が定義されていない場合に発生する可能性があります。 詳細については、タイム シリーズ モデルを使用する方法 に関する情報を参照してください。
次の手順
タイムシリーズモデルを
どのように扱うかを読む。 に対応する JSON 構造について学ぶ。
Azure Time Series Insights Gen2 で
計画と制限を確認します。