リソース ログを使用した Azure Stream Analytics のトラブルシューティング

Azure Stream Analytics ジョブは予期せず処理を停止することがあります。 このため、この種のイベントのトラブルシューティングを行えることが重要です。 障害は、予期しないクエリ結果、デバイスへの接続、または予期しないサービス停止によって引き起こされる可能性があります。 Stream Analytics のリソース ログは、問題が発生した際にその原因を特定し、復旧時間を短縮するのに役立ちます。

デバッグと監視に非常に役立つため、すべてのジョブのリソース ログを有効にすることを強くお勧めします。

ログの種類

Stream Analytics には 2 種類のログがあります。

• アクティビティ ログ (常に有効) では、ジョブで実行される操作の分析情報が得られます。

• リソース ログ (構成可能) では、ジョブで発生するあらゆるイベントに関してより豊富な分析情報が得られます。 リソース ログはジョブの作成時に開始され、ジョブが削除されると終了します。 ジョブの更新時とジョブの実行中のイベントがログの対象です。

アクティビティ ログを使用したデバッグ

アクティビティ ログは既定で有効になっていて、Stream Analytics ジョブで実行される操作の高度な分析情報が得られます。 ジョブに影響を与える問題の根本原因を見つけるには、アクティビティ ログに含まれている情報が役立ちます。 Stream Analytics でアクティビティ ジョブを使用するためには、次の手順を実行します。

1. Azure portal にサインインし、 [概要] で [アクティビティ ログ] を選択します。

   

2. 実行された操作の一覧を確認できます。 ジョブが失敗する原因となったすべての操作には、赤い情報バブルが表示されます。

3. 操作を選択すると、その概要ビューが表示されます。 多くの場合、ここにある情報は制限されています。 操作の詳細を表示するには、[JSON] を選択します。

   

4. JSON の [プロパティ] セクションまで下へスクロールして、失敗した操作の原因となったエラーの詳細を表示します。 この例では、失敗は範囲外の緯度値からのランタイム エラーが原因でした。 Stream Analytics ジョブによって処理されるデータに矛盾があると、データ エラーが発生します。 さまざまな入力データと出力データのエラーとそれらの発生する理由を学習できます。

   

5. JSON のエラー メッセージに基づいて是正措置を取ることができます。 この例では、-90 度から 90 度の間の緯度値をクエリに追加する必要があることを確認します。

6. 根本原因を特定するのにアクティビティ ログのエラー メッセージが役に立たない場合は、リソース ログを有効にして Azure Monitor ログを使用します。

Azure Monitor ログへの診断データの送信

リソース ログをオンにして Azure Monitor ログに送信することを、強くお勧めします。 既定では、[オフ] になっています。 オンにするには、次の手順を完了します。

1. Log Analytics ワークスペースを作成します (まだ作成していない場合)。 対象の Stream Analytics ジョブと同じリージョン内に Log Analytics ワークスペースを用意することをお勧めします。

2. Azure portal にサインインして、Stream Analytics ジョブに移動します。 [監視] の下の [診断ログ] を選択します。 次に、 [診断を有効にする] を選択します。

   

3. [診断設定の名前] に名前を指定し、 [ログ] の下にある [実行] および [作成] と、 [メトリック] の下にある [AllMetrics] の各ボックスをオンにします。 次に、 [Log Analytics への送信] を選択し、ワークスペースを選択します。 [保存] を選択します。

   

4. Stream Analytics ジョブが開始すると、リソース ログが Log Analytics ワークスペースにルーティングされます。 ジョブのリソース ログを表示するには、 [監視] セクションの [ログ] を選択します。

   

5. Stream Analytics には、関心のあるログを簡単に検索できる定義済みのクエリが用意されています。 左側のペインで定義済みのクエリを選択し、[実行] を選択できます。 下部のペインにクエリの結果が表示されます。

   

リソース ログのカテゴリ

Azure Stream Analytics では、次の 2 つのカテゴリのリソース ログをキャプチャします。

• 作成:ジョブ作成操作 (ジョブの作成、入出力の追加と削除、クエリの追加と更新、ジョブの開始と停止など) に関連するログ イベントを取得します。

• 実行:ジョブの実行中に発生したイベントを取得します。

  • 接続エラー
  • データ処理エラー。次のエラーが含まれます。
    • クエリ定義に準拠していないイベント (フィールドの種類と値の不一致、フィールドの不足など)
    • 式評価エラー
  • その他のイベントとエラー

リソース ログのスキーマ

すべてのログは JSON 形式で格納されます。 各エントリには、次の一般的な文字列フィールドが含まれています。

実行ログ プロパティのスキーマ

実行ログには、Stream Analytics ジョブの実行中に発生したイベントに関する情報が含まれます。 プロパティのスキーマは、イベントがデータ エラーまたは汎用イベントのどちらであるかによって異なります。

データ エラー

ジョブがデータを処理している間に発生したエラーはすべて、ログのこのカテゴリに含まれます。 これらのログはほとんどの場合、データ読み取り、シリアル化、書き込み操作が実行されている間に作成されます。 このログには接続エラーが含まれません。 接続エラーは汎用イベントとして扱われます。 さまざまな入力および出力データ エラーの原因についてさらに学習することができます。

データ エラーのスキーマは、operationName 値に応じて次のようになります。

• シリアル化イベントはイベント読み取り操作中に発生します。 これらは、次のいずれかの理由で入力データがクエリ スキーマを満たしていない場合に発生します。

  • "イベントのシリアル化/逆シリアル化中の種類の不一致": エラーを引き起こしたフィールドが特定されます。

  • "イベントを読み取ることができない。無効なシリアル化": エラーが発生した入力データの場所に関する情報が一覧で表示されます。 ここには、BLOB 入力の BLOB 名、オフセット、データのサンプルが含まれます。

• 送信イベントは書き込み操作中に発生します。 エラーを引き起こしたストリーミング イベントが特定されます。

汎用イベント

汎用イベントには、上に挙げた以外のあらゆるイベントが含まれます。

Azure Monitorでサポートされているすべてのリソース ログのカテゴリの種類の一覧も参照してください。 次の表のリンクを選択すると、Azure Stream Analytics 用に収集されたすべてのリソース ログ カテゴリの種類が表示されます。

次のステップ

• Stream Analytics データ エラー
• Stream Analytics クエリ言語リファレンス