Azure Functions の監視

[アーティクル]
03/15/2024

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

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

Note

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

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

Azure Monitor の詳細については、「Azure Monitor の概要」を参照してください。
Azure リソース全般の監視方法の詳細については、「Azure Monitor を使用した Azure リソースの監視」をご覧ください。

分析情報

Azure の一部のサービスについては、サービスを監視するための開始点となる監視ダッシュボードが Azure portal に組み込まれています。これらのダッシュボードは、"分析情報" と呼ばれており、Azure portal の Azure Monitor の [分析情報ハブ] にあります。

Application Insights

Azure Functions には、関数の実行を監視する Application Insights との統合機能が組み込まれています。 Application Insights を統合、構成、および使用し、Azure Functions を監視する方法の詳細については、次の記事を参照してください。

リソースの種類

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

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

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

データストレージ

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 Functions で使用可能なメトリックの一覧については、「Azure Functions 監視データのリファレンス」をご覧ください。

Note

App Service メトリック (Microsoft.Web/サイト) は、関数アプリが従量課金プランで、Linux 上で実行されている場合は使用できません。

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 Functions は Azure Monitor ログと統合され、関数を監視できます。リソースログを構成およびルーティングするための診断設定の詳細な手順については、「Azure Monitor の診断設定を作成する」を参照してください。

Azure Functions の診断設定の追加を示すスクリーンショット。

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

Azure activity log

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

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

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

その他のログ

Azure Functions は、Azure Monitor のリソースログより詳細なログを収集する機能も提供しています。 Azure で実行中の関数によって生成されたアプリケーションログファイルのほぼリアルタイムのストリーミングを表示するには、Application Insights に接続し、Live Metrics Stream を使用します。または、App Service プラットフォーム組み込みのログストリーミングを使用してアプリケーションログファイルのストリームを表示できます。詳しくは、「Azure Functions で実行ログのストリーミングを有効にする」をご覧ください。

監視データを分析する

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

Azure Monitor ツール

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

メトリックスエクスプローラー。Azure リソースのメトリックを表示および分析できる Azure portal のツール。詳細については、「Azure Monitor メトリックスエクスプローラーを使用したメトリックの分析」を参照してください。
Log Analytics は、Kusto クエリ言語 (KQL) を使用して、ログデータのクエリと分析を可能にする Azure Portal のツールです。詳細については、「Azure Monitor でログクエリの使用を開始する」を参照してください。
アクティビティログ。表示および基本的な検索用のユーザーインターフェイスが Azure portal に用意されています。より詳細な分析を行うには、データを Azure Monitor ログにルーティングし、Log Analytics でより複雑なクエリを実行する必要があります。

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

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

Azure Monitor エクスポートツール

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

メトリック:メトリック用 REST API を使用して、Azure Monitor メトリックデータベースからメトリックデータを抽出します。この API では、取得したデータを絞り込むためのフィルター式がサポートされています。詳細については、Azure Monitor REST API のリファレンスをご覧ください。
ログ: REST API または関連するクライアントライブラリを使用します。
もう 1 つのオプションは、ワークスペースデータのエクスポートです。

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

Azure Functions のメトリックを分析する

次の例では、Azure Monitor メトリックを使用して、従量課金プランで関数アプリを実行するコストを見積もることができます。従量課金プランのコストの見積もりについては、「従量課金プランのコストの見積もり」を参照してください。

従量課金プランの関数アプリのコスト関連データをグラフィック形式で表示するには、Azure Monitor メトリックスエクスプローラーを使用します。

Azure portal で関数アプリに移動します。
左側のパネルで、 [監視] までスクロールし、 [メトリック] を選択します。
[メトリック] から [関数の実行回数] を選択し、 [集計] から [合計] を選択します。これにより、選択した期間の実行回数の合計がグラフに追加されます。
[メトリックの追加] を選択し、手順 2 から手順 4 を繰り返して、 [関数の実行単位] をグラフに追加します。

結果のグラフには、選択した時間範囲 (この例では 2 時間) に対する両方の実行メトリックの合計が含まれます。

関数の実行回数と実行単位のグラフ

実行単位の数は実行回数よりはるかに多いため、グラフは実行単位だけのように見えます。

このグラフでは、MB ミリ秒数で測定して、2 時間に合計で 11.1 億の Function Execution Units が消費されたことが示されています。 GB 秒数に変換するには、1,024,000 で割ります。この例の関数アプリでは、1110000000 / 1024000 = 1083.98 GB 秒が消費されました。この値を取得し、Functions の価格ページで示されている実行時間の現在の料金を乗算することにより、この 2 時間のコストがわかります (実行時間の無料提供を既に使用してあるものとします)。

Azure CLI には、メトリックを取得するためのコマンドがあります。ローカルコマンド環境から、または Azure Cloud Shell を使用してポータルから直接、CLI を使用できます。たとえば、次の az monitor metrics list コマンドでは、前に使用したのと同じ期間に対する 1 時間あたりのデータが返されます。

<AZURE_SUBSCRIPTON_ID> は、コマンドを実行している Azure サブスクリプション ID に置き換えてください。

az monitor metrics list --resource /subscriptions/<AZURE_SUBSCRIPTION_ID>/resourceGroups/metrics-testing-consumption/providers/Microsoft.Web/sites/metrics-testing-consumption --metric FunctionExecutionUnits,FunctionExecutionCount --aggregation Total --interval PT1H --start-time 2019-09-11T21:46:00Z --end-time 2019-09-11T23:18:00Z

このコマンドでは、次の例のような JSON ペイロードが返されます。

{
  "cost": 0.0,
  "interval": "1:00:00",
  "namespace": "Microsoft.Web/sites",
  "resourceregion": "centralus",
  "timespan": "2019-09-11T21:46:00Z/2019-09-11T23:18:00Z",
  "value": [
    {
      "id": "/subscriptions/XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX/resourceGroups/metrics-testing-consumption/providers/Microsoft.Web/sites/metrics-testing-consumption/providers/Microsoft.Insights/metrics/FunctionExecutionUnits",
      "name": {
        "localizedValue": "Function Execution Units",
        "value": "FunctionExecutionUnits"
      },
      "resourceGroup": "metrics-testing-consumption",
      "timeseries": [
        {
          "data": [
            {
              "average": null,
              "count": null,
              "maximum": null,
              "minimum": null,
              "timeStamp": "2019-09-11T21:46:00+00:00",
              "total": 793294592.0
            },
            {
              "average": null,
              "count": null,
              "maximum": null,
              "minimum": null,
              "timeStamp": "2019-09-11T22:46:00+00:00",
              "total": 316576256.0
            }
          ],
          "metadatavalues": []
        }
      ],
      "type": "Microsoft.Insights/metrics",
      "unit": "Count"
    },
    {
      "id": "/subscriptions/XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX/resourceGroups/metrics-testing-consumption/providers/Microsoft.Web/sites/metrics-testing-consumption/providers/Microsoft.Insights/metrics/FunctionExecutionCount",
      "name": {
        "localizedValue": "Function Execution Count",
        "value": "FunctionExecutionCount"
      },
      "resourceGroup": "metrics-testing-consumption",
      "timeseries": [
        {
          "data": [
            {
              "average": null,
              "count": null,
              "maximum": null,
              "minimum": null,
              "timeStamp": "2019-09-11T21:46:00+00:00",
              "total": 33538.0
            },
            {
              "average": null,
              "count": null,
              "maximum": null,
              "minimum": null,
              "timeStamp": "2019-09-11T22:46:00+00:00",
              "total": 13040.0
            }
          ],
          "metadatavalues": []
        }
      ],
      "type": "Microsoft.Insights/metrics",
      "unit": "Count"
    }
  ]
}

この特定の応答では、2019-09-11T21:46 から 2019-09-11T23:18 までの間に、アプリで 1,110,000,000 MB ミリ秒 (1083.98 GB 秒) が消費されたことが示されています。

Azure PowerShell には、メトリックを取得するためのコマンドがあります。ローカルコマンド環境から、または Azure Cloud Shell を使用してポータルから直接、Azure PowerShell を使用できます。たとえば、次の Get-AzMetric コマンドでは、前に使用したのと同じ期間に対する 1 時間あたりのデータが返されます。

<AZURE_SUBSCRIPTON_ID> は、コマンドを実行している Azure サブスクリプション ID に置き換えてください。

Get-AzMetric -ResourceId /subscriptions/<AZURE_SUBSCRIPTION_ID>/resourceGroups/metrics-testing-consumption/providers/Microsoft.Web/sites/metrics-testing-consumption -MetricName  FunctionExecutionUnits,FunctionExecutionCount -AggregationType Total -TimeGrain 01:00:00 -StartTime 2019-09-11T21:46:00Z -EndTime 2019-09-11T23:18:00Z

このコマンドでは、次の例のような出力が返されます。

Id         : /subscriptions/<AZURE_SUBSCRIPTION_ID>/resourceGroups/metrics-testing-consumption/providers/Microsoft.Web/sites/metrics-testing-consumption/providers/Microsoft.Insights/metrics/FunctionExecutionUnits
Name       : 
                LocalizedValue : Function Execution Units
                Value          : FunctionExecutionUnits
             
Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, 
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, 
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, 
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

Id         : /subscriptions/<AZURE_SUBSCRIPTION_ID>/resourceGroups/metrics-testing-consumption/providers/Microsoft.Web/sites/metrics-testing-consumption/providers/Microsoft.Insights/metrics/FunctionExecutionCount
Name       : 
                LocalizedValue : Function Execution Count
                Value          : FunctionExecutionCount
             
Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, 
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, 
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, 
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

この Data プロパティには、実際のメトリック値が含まれています。

Azure Functions のログを分析する

Azure Functions によって、すべてのログは、データを送信する Log Analytics ワークスペースの [LogManagement] にある FunctionAppLogs テーブルに書き込まれます。データにクエリを実行するために Kusto クエリを使用できます。

Log Analytics ワークスペースの Azure Functions の [クエリ] ウィンドウのスクリーンショット。

Kusto クエリ

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

重要

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

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

次のサンプルクエリは、すべての関数アプリのログを監視するのに役立ちます。


FunctionAppLogs
| order by TimeGenerated desc

FunctionAppLogs
| project TimeGenerated, HostInstanceId, Message, _ResourceId
| order by TimeGenerated desc

次のサンプルクエリは、特定の関数アプリのログを監視するのに役立ちます。

FunctionAppLogs
| where FunctionName == "<Function name>" 
| order by TimeGenerated desc

次のサンプルクエリは、すべての関数アプリのログの例外を監視するのに役立ちます。


FunctionAppLogs
| where ExceptionDetails != ""  
| order by TimeGenerated asc

次のサンプルクエリは、特定の関数アプリのログに関する例外を監視するのに役立ちます。

FunctionAppLogs
| where ExceptionDetails != ""  
| where FunctionName == "<Function name>" 
| order by TimeGenerated desc

警告

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 つのアラートルールで複数のリソースを監視する」をご覧ください。

Note

サービスで動作するアプリケーションを作成または実行している場合、Azure Monitor Application Insights は他の種類の警告を表示する場合があります。

Azure Functions のアラートルール

次の表に、Azure Functions の一般的および推奨される警告ルールを示します。これはあくまで推奨されるアラートです。 Azure Functions の監視データのリファレンスに一覧表示されているメトリック、ログエントリ、またはアクティビティログエントリに対してアラートを設定できます。

アラートの種類	条件	説明
メトリック	平均接続数	接続数が設定値を超えた場合
メトリック	HTTP 404	HTTP 404 応答が設定値を超えた場合
メトリック	HTTP サーバーエラー数	HTTP 5xx エラーが設定値を超えた場合
アクティビティログ	関数アプリを作成または更新する	アプリが作成または更新されたとき
アクティビティログ	関数アプリを削除する	アプリが削除されたとき
アクティビティログ	関数アプリを再起動する	アプリが再起動されたとき
アクティビティログ	関数アプリを停止する	アプリが停止したとき

Advisor の推奨事項

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

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

Azure Functions の監視については、以下のアーティクルをご覧ください。

Azure Functions 監視データのリファレンスでは、関数アプリに利用可能なメトリック、ログ、その他の重要な値の参照が提供されます。
Azure Monitor を使用した Azure リソースの監視では、Azure リソースの監視に関する一般的な詳細情報が提供されます。
Azure Functions での実行の監視では、関数アプリを監視する方法の詳細について説明します。
Azure Functions で監視を構成する方法では、監視の構成方法について説明します。
Application Insights による Azure Functions のテレメトリーの分析では、関数アプリから収集されたデータの表示方法と問い合わせ方法について説明します。

Azure Functions の監視

分析情報

Application Insights

リソースの種類

データ ストレージ

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

Azure Monitor リソース ログ

Azure activity log

その他のログ

監視データを分析する

Azure Monitor ツール

Azure Monitor エクスポート ツール

Azure Functions のメトリックを分析する

Azure Functions のログを分析する

Kusto クエリ

警告

アラートの種類

Azure Functions のアラート ルール

Advisor の推奨事項

関連するコンテンツ

その他のリソース

データストレージ

Azure Monitor リソースログ

Azure Monitor エクスポートツール

Azure Functions のアラートルール