Azure Stream Analytics を監視する

この記事では、次の内容について説明します。

  • このサービスに対して収集できる監視データの種類。
  • そのデータを分析する方法。

Note

このサービスや Azure Monitor を既に使い慣れていて、監視データの分析方法だけを確認したい場合は、この記事で後述する分析に関するセクションをご覧ください。

Azure リソースに依存するクリティカルなアプリケーションやビジネス プロセスがある場合は、システムを監視し、そのアラートを受け取る必要があります。 Azure Monitor サービスでは、システムのすべてのコンポーネントからメトリックとログを収集して集計します。 Azure Monitor を使用すると、可用性、パフォーマンス、回復性を視覚化し、問題に関する通知を受け取ることができます。 Azure portal、PowerShell、Azure CLI、REST API、またはクライアント ライブラリは、監視データの設定および表示に使用できます。

Azure PowerShell コマンドレットと PowerShell スクリプトを使用して Azure Stream Analytics リソースを監視および管理する方法については、「Azure PowerShell コマンドレットを使用した Stream Analytics ジョブの監視および管理」を参照してください。

リソースの種類

Azure では、リソースの種類と ID の概念を使用して、サブスクリプション内のすべてを識別します。 同様に、Azure Monitor では、コア監視データがリソースの種類 (名前空間とも呼ばれます) に基づいてメトリックとログに整理されます。 リソースの種類に応じてさまざまなメトリックとログが使用できます。 サービスは、複数のリソースの種類に関連付けられる可能性があります。

リソースの種類は、Azure で実行されているすべてのリソースのリソース ID の一部でもあります。 たとえば、Microsoft.Compute/virtualMachines は、仮想マシンのリソースの種類の 1 つです。 サービスとそれに関連付けられるリソースの種類の一覧については、リソース プロバイダーに関するページをご覧ください。

Azure Stream Analytics のリソースの種類の詳細については、「Azure Stream Analytics の監視データ リファレンスを参照してください。

データ ストレージ

Azure Monitor の場合:

  • メトリック データは、Azure Monitor メトリック データベースに保存されます。
  • ログ データは、Azure Monitor ログ ストアに保存されます。 Log Analytics は、Azure portal のツールの 1 つであり、このストアに対してクエリを実行することができます。
  • Azure アクティビティ ログは、Azure Portal 内の独自のインターフェイスを持つ別のストアです。

必要に応じて、メトリックおよびアクティビティ ログ データを Azure Monitor ログ ストアにルーティングできます。 次に、Log Analytics を使用してデータのクエリを実行し、他のログ データと関連付けることができます。

多くのサービスで診断設定を使用して、メトリックとログ データを Azure Monitor の外部の他のストレージの場所に送信できます。 たとえば、Azure Storage、ホステッド パートナー システムEvent Hubs を使用する Azure 以外のパートナー システムなどがあります。

Azure Monitor によるデータの保存方法の詳細については、「Azure Monitor データ プラットフォーム」を参照してください。

Azure Monitor プラットフォームのメトリック

Azure Monitor により、ほとんどのサービスに関するプラットフォーム メトリックが提供されます。 これらのメトリックは次のとおりです。

  • 名前空間ごとに個別に定義されます。
  • Azure Monitor 時系列メトリック データベースに保存されます。
  • 軽量であり、凖リアルタイムのアラートをサポートできます。
  • リソースのパフォーマンスを時間の経過と共に追跡するために使用されます。

収集: Azure Monitor では、プラットフォーム メトリックを自動的に収集します。 構成は必要ありません。

ルーティング: また、通常は、プラットフォーム メトリックを Azure Monitor ログまたは Log Analytics にルーティングして、他のログ データを使用してクエリを実行することもできます。 詳細については、「メトリック診断設定」を参照してください。 サービスの診断設定を構成する方法については、「Azure Monitor で診断設定を作成する」を参照してください。

Azure Monitor ですべてのリソースに対して収集できるすべてのメトリックの一覧については、Azure Monitor でサポートされるメトリックに関する記事を参照してください。

Azure Stream Analytics メトリック

Azure portal でメトリックを監視する方法の詳細については、「Azure portal で Stream Analytics ジョブを監視する」を参照してください。

Note

Azure REST API、Azure SDK、または PowerShell を介して作成された Azure Stream Analytics ジョブの監視は、既定では有効になっていません。 監視を有効にするには、「Stream Analytics ジョブ モニター をプログラムで作成する」の手順に従ってください。 監視データが、Azure Portal ページの Stream Analytics ジョブの [メトリック] 領域に表示されます。

次の表に、一般的に監視される Azure Stream Analytics メトリックの条件と是正措置を示します。

メトリック 条件 時間の集計 しきい値 問題への対応
SU (メモリ) 使用率 (%) より大きい 平均 80 複数の要因により、SU の使用率が増加します。 クエリの並列処理を使用してスケーリングするか、SU 数を増やすことができます。 詳細については、「Azure Stream Analytics でのクエリの並列処理の活用」を参照してください。
CPU 使用率 (%) より大きい 平均 90 これは、一部の操作 (ユーザー定義関数、ユーザー定義の集計、複雑な入力の逆シリアル化など) が多くの CPU サイクルを必要とすることを意味する可能性があります。 この問題は、通常、ジョブの SU の数を増やすことで克服できます。
実行時エラー より大きい 合計 0 アクティビティ ログまたはリソース ログを調べて、入力、クエリ、出力を適切に変更してください。
基準値の遅延 より大きい 平均 このメトリックの直近 15 分間の平均値が到着遅延許容期間 (秒単位) を超えたとき。 到着遅延許容期間を変更していない場合の既定値は 5 秒に設定されています。 SU 数を増やすか、クエリの並列処理を試してみてください。 SU の詳細については、「ストリーミング ユニットの理解と調整」を参照してください。 クエリの並列処理の詳細については、「Azure Stream Analytics でのクエリの並列処理の活用」を参照してください。
逆シリアル化の入力エラー より大きい 合計 0 アクティビティ ログまたはリソース ログを調べて、入力を適切に変更してください。 リソース ログの詳細については、リソース ログを使用した Azure Stream Analytics のトラブルシューティングに関するページを参照してください。

Azure Stream Analytics で使用可能なすべてのメトリックの一覧と説明については、「Azure Stream Analytics の監視データ リファレンス」を参照してください。

Azure Monitor リソース ログ

リソース ログでは、Azure リソースによって実行された操作に関する分析情報を提供します。 ログは自動的に生成されますが、保存するかクエリを実行するには、Azure Monitor ログにルーティングする必要があります。 ログはカテゴリに分類されています。 特定の名前空間に複数のリソース ログ カテゴリが含まれる場合があります。

収集: リソース ログは、"診断設定" を作成してログを 1 つ以上の場所にルーティングするまでは収集および保存されません。 診断設定を作成するときは、収集するログのカテゴリを指定します。 診断設定を作成して管理するには、Azure portal、プログラム、Azure Policy など、複数の方法があります。

ルーティング: 既定で推奨されるのは、リソース ログを Azure Monitor ログにルーティングして、他のログ データを使用してクエリを実行できるようにすることです。 Azure Storage、Azure Event Hubs、特定の Microsoft 監視パートナーなど、その他の場所も利用できます。 詳細については、「Azure リソース ログ」およびリソース ログの送信先に関するページを参照してください。

リソース ログの収集、保存、ルーティングの詳細については、「Azure Monitor の診断設定」を参照してください。

Azure Monitor で使用可能なすべてのリソース ログ カテゴリの一覧については、Azure Monitor でサポートされているリソース ログに関するページを参照してください。

Azure Monitor 内のすべてのリソース ログには、同じヘッダー フィールドの後にサービス固有のフィールドがあります。 共通のスキーマの概要については、Azure Monitor リソース ログのスキーマに関する記事をご覧ください。

Azure Stream Analytics のログ

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

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

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

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

使用可能なリソース ログ カテゴリ、それに関連する Log Analytics テーブル、Azure Stream Analytics のログ スキーマについては、「Azure Stream Analytics の監視データ リファレンス」を参照してください。

リソース ログを使用して Azure Stream Analytics ジョブの失敗のトラブルシューティングを行う方法の詳細なチュートリアルについては、「リソース ログを使用した Azure Stream Analytics のトラブルシューティング」を参照してください。

Azure activity log

アクティビティ ログには、Azure リソースごとに操作を追跡する、そのリソースの外から見たサブスクリプションレベルのイベント (新しいリソースの作成や仮想マシンの起動など) が含まれます。

収集: アクティビティ ログ イベントは、Azure portal で表示するために、個別のストアに自動的に生成および収集されます。

ルート指定: アクティビティ ログ データを Azure Monitor ログに送信して、他のログ データと共に分析できます。 Azure Storage、Azure Event Hubs、特定の Microsoft 監視パートナーなど、その他の場所も利用できます。 アクティビティ ログをルーティングする方法の詳細については、Azure アクティビティ ログの概要に関するページをご覧ください。

アクティビティ ログを使用して Azure Stream Analytics ジョブの失敗のトラブルシューティングを行う方法の詳細なチュートリアルについては、「アクティビティ ログ使用したデバッグ」を参照してください。

監視データを分析する

監視データを分析するためのツールは多数あります。

Azure Monitor ツール

Azure Monitor は、次の基本的なツールをサポートします。

より複雑な視覚化を可能にするツールは次のとおりです。

  • ダッシュボードを使用すると、さまざまな種類のデータを組み合わせて、Azure portal 内の 1 つのペインに表示できます。
  • ブック。Azure portal で作成できるカスタマイズ可能なレポート。 ブックには、テキスト、メトリック、ログ クエリを含めることができます。
  • Grafana。運用ダッシュボードに優れたオープン プラットフォーム ツール。 Grafana を使用して、Azure Monitor 以外の複数のソースからのデータを含むダッシュボードを作成できます。
  • Power BI。さまざまなデータ ソースにわたって対話型の視覚化を提供するビジネス分析サービス。 Azure Monitor からログ データを自動的にインポートするように Power BI を構成して、これらの視覚化を利用できます。

Azure Monitor エクスポート ツール

次の方法を使用して、Azure Monitor から他のツールにデータを取得できます。

Azure Monitor 用 REST API の使用を開始するには、「Azure 監視 REST API のチュートリアル」を参照してください。

Kusto クエリ

Kusto クエリ言語 (KQL) を使用して、Azure Monitor ログ/Log Analytics ストアの監視データを分析できます。

重要

ポータルでサービスのメニューから [ログ] を選択すると、クエリ スコープが現在のサービスに設定された状態で Log Analytics が開きます。 このスコープは、ログ クエリにその種類のリソースのデータのみが含まれることを意味します。 他の Azure サービスのデータを含むクエリを実行する場合は、[Azure Monitor] メニューから [ログ] を選択します。 詳細については、「Azure Monitor Log Analytics のログ クエリのスコープと時間範囲」を参照してください。

いずれかのサービスに関する一般的なクエリの一覧については、Log Analytics クエリ インターフェイスに関するページを参照してください。

サンプル クエリ

次に、Azure Stream Analytics リソースの監視に使用できるサンプル クエリを示します。

  • すべての入力データ エラーを一覧表示します。 次のクエリは、入力からのデータの処理中に発生したすべてのエラーを示しています。

    AzureDiagnostics 
    | where ResourceProvider == "MICROSOFT.STREAMANALYTICS" and parse_json(properties_s).Type == "DataError" 
    | project TimeGenerated, Resource, Region_s, OperationName, properties_s, Level, _ResourceId        
    
  • 遅れて到着したイベント。 次のクエリは、アプリケーション時間と到着時間の差が遅延到着ポリシーよりも大きいイベントによるエラーを示しています。

    AzureDiagnostics
    | where ResourceProvider == "MICROSOFT.STREAMANALYTICS" and  parse_json(properties_s).DataErrorType == "LateInputEvent"
    | project TimeGenerated, Resource, Region_s, OperationName, properties_s, Level, _ResourceId
    
  • 早く到着したイベント。 次のクエリは、アプリケーション時間と到着時間の差が 5 分を上回っているイベントによるエラーを示しています。

    AzureDiagnostics
    | where ResourceProvider == "MICROSOFT.STREAMANALYTICS" and parse_json(properties_s).DataErrorType == "EarlyInputEvent"
    | project TimeGenerated, Resource, Region_s, OperationName, properties_s, Level, _ResourceId    
    
  • 順に到着したイベント。 次のクエリは、順不同のポリシーに従って順不同に到着したイベントによるエラーを示しています。

    // To create an alert for this query, click '+ New alert rule'
    AzureDiagnostics
    | where ResourceProvider == "MICROSOFT.STREAMANALYTICS" and parse_json(properties_s).DataErrorType == "OutOfOrderEvent"
    | project TimeGenerated, Resource, Region_s, OperationName, properties_s, Level, _ResourceId    
    
  • すべての出力データ エラー。 次のクエリは、クエリの結果をジョブの出力に書き込むときに発生したすべてのエラーを示しています。

    AzureDiagnostics
    | where ResourceProvider == "MICROSOFT.STREAMANALYTICS" and parse_json(properties_s).DataErrorType in ("OutputDataConversionError.RequiredColumnMissing", "OutputDataConversionError.ColumnNameInvalid", "OutputDataConversionError.TypeConversionError", "OutputDataConversionError.RecordExceededSizeLimit", "OutputDataConversionError.DuplicateKey")
    | project TimeGenerated, Resource, Region_s, OperationName, properties_s, Level, _ResourceId
    
  • 次のクエリは、過去 7 日間に失敗した操作の概要を示しています。

    AzureDiagnostics
    | where TimeGenerated > ago(7d) //last 7 days
    | where ResourceProvider == "MICROSOFT.STREAMANALYTICS" and status_s == "Failed" 
    | summarize Count=count(), sampleEvent=any(properties_s) by JobName=Resource        
    

警告

Azure Monitor のアラートにより、監視データで特定の状態が見つかったときに事前に通知を受け取ります。 アラートにより、ユーザーが気付く前に、管理者が問題を識別して対処できます。 詳細については、Azure Monitor アラートに関するページを参照してください。

Azure リソースに関する一般的なアラートのソースは数多くあります。 Azure リソースに関する一般的なアラートの例については、ログ アラート クエリのサンプルに関するページをご覧ください。 Azure Monitor ベースライン アラート (AMBA) サイトには、重要なプラットフォーム メトリック アラート、ダッシュボード、ガイドラインを実装するための半自動化された方法が用意されています。 このサイトは、Azure ランディング ゾーン (ALZ) の一部であるすべてのサービスを含む、Azure サービスの継続的に拡張されるサブセットに適用されます。

共通アラート スキーマを使用すると、Azure Monitor のアラート通知の使用を標準化できます。 詳細については、「共通アラート スキーマ」をご覧ください。

アラートの種類

Azure Monitor データ プラットフォームでは、任意のメトリックまたはログ データ ソースに対してアラートを生成できます。 監視するサービスと収集する監視データに応じて、さまざまな種類のアラートがあります。 アラートの種類に応じて、さまざまな利点と欠点があります。 詳細については、適切な種類の監視アラートの選択に関するページをご覧ください。

次の一覧では、作成できる Azure Monitor アラートの種類について説明します。

  • メトリック アラートでは、リソース メトリックを定期的に評価します。 メトリックはプラットフォーム メトリック、カスタム メトリック、メトリックに変換された Azure Monitor からのログまたは Application Insights メトリックにすることができます。 メトリック警告では、複数の条件と動的しきい値を適用することもできます。
  • ログ アラートでは、ユーザーは Log Analytics クエリを使用して、定義済みの頻度でリソース ログを評価できます。
  • アクティビティ ログ アラートは、定義された条件と一致する新しいアクティビティ ログ イベントが発生したときにトリガーされます。 Resource Health アラートと Service Health アラートは、サービスとリソースの正常性を報告するアクティビティ ログ アラートです。

一部の Azure サービスでは、スマート検出アラートPrometheus アラート推奨されるアラート ルールもサポートされています。

一部のサービスでは、同じ Azure リージョン内に存在する同じ種類の複数のリソースに同じメトリック警告ルールを適用することで、大規模に監視することができます。 監視対象リソースごとに個別の通知が送信されます。 サポートされている Azure サービスとクラウドについては、「1 つのアラート ルールで複数のリソースを監視する」をご覧ください。

Azure Stream Analytics の警告ルール

次の表に、Azure Stream Analytics に推奨されるいくつかの警告ルールを示します。 これらのアラートは例に過ぎません。 「Azure Stream Analytics の監視データ リファレンス」に一覧表示されている任意のメトリック、ログ エントリ、またはアクティビティ ログ エントリに対して警句を設定することができます。

アラートの種類 条件 説明
プラットフォームのメトリック ストリーミング ユニット (SU) のメモリ使用率 平均 SU (メモリ) 使用率が 80% を超える場合
アクティビティ ログ 失敗した操作 アクティビティ ログにカテゴリ = "管理"、信号名 = "すべての管理操作"、状態 = "失敗" のイベントがある場合

Azure Stream Analytics のアラートを設定する方法の詳細については、「Azure Stream Analytics ジョブ のアラートを設定する」を参照してください

Advisor の推奨事項

一部のサービスでは、リソースの操作中にクリティカルな条件や差し迫った変更が発生した場合は、ポータルのサービス [概要] ページにアラートが表示されます。 アラートの詳細と推奨される修正は、左側のメニューの [監視] の下の [アドバイザーのレコメンデーション] に表示されます。 通常の操作中、アドバイザーのレコメンデーションは表示されません。

Azure Advisor の詳細については、Azure Advisor の概要に関するページをご覧ください。