Japan Azure PaaS Support Team

Azure Functions のトリガーの同期とは

3 minute read

質問

Azure Functions にトリガーの同期がありますが何の機能ですか。

トリガーのいずれかを変更する場合、Functions インフラストラクチャにその変更を認識させる必要があります。 同期は、多くのデプロイ テクノロジでは自動的に実行されます。 ただし、場合によっては、トリガーを手動で同期する必要があります。

回答

Azure Functions にデプロイされたアプリケーションのトリガーの情報を Azure Functions のバックエンドに同期するための機能です。

なぜトリガーの同期が必要か

Azure Functions は、アプリケーション ルート(/home/site/wwwroot/)を基幹として複数のトリガーごとにフォルダを分割した構造となっています。下記は C#(インプロセス) の場合のフォルダ階層の例です。

image-7da7eea6-9e7d-4aec-852d-34ac06f2cff2.png

host.json と呼ばれる Azure Functions 全体の設定ファイルに加えて、ご利用の各トリガーごとに function.json と呼ばれる定義ファイルを保持しております。どういったバインディングを利用しているかの一覧などの情報を知るためにはファイル名などの表面的な情報では不足しており、すべての設定ファイルを読み込み・解釈する必要があります。

例えば、Azure ポータルの関数一覧に実装したトリガーを表示することを考えます。下記のような複数のトリガーを実装した場合には、この Azure Functions リソースにデプロイされているアプリケーションには、BLOBTrigger~TimerTrigger まで 15 個のトリガーが実装されていますが、この一覧という情報はどの設定ファイルにも無く、それぞれのトリガーごとのフォルダに含まれている functions.json を確認する必要があります。

関数一覧

image-46fd2f8a-e707-4450-8525-fe6f71bcebdc.png

BLOBTrigger の function.json の例

image-b6c0a2a3-1896-4566-9365-d3d18a9650d6.png

こういった情報(いわば Azure Functions のメタデータ)を更新するための契機としてトリガーの同期が存在しています。

動作シーケンス

前述の解説とこちらにある通り、トリガーの同期はデプロイ時に実施する必要があります。Azure Functions での推奨としている ZIP デプロイの場合の動作を確認します。

  1. ZIP デプロイとは、Kudu(SCM サイト) の /api/zipdeploy エンドポイントにアプリケーション コンテンツと一緒に POST 通信することです。このデプロイ時に、Kudu の PostDeploymentHelper クラスの中で Azure Functions の場合にはトリガーの同期 (/admin/host/synctriggers へのリクエスト)が呼び出されています。

  2. このトリガーの同期のエンドポイント /admin/host/synctriggers は Azure Functions がリスンしているエンドポイントです。FunctionsSyncManager クラスで、/admin/host/synctriggers を受けたら /operation/settriggers を呼び出しています。

以上の2段の HTTP リクエストが発出されることでトリガーの同期が行われます。/operation/settriggers を受け付けた以降の処理は Azure Functions 内部動作となっており現時点で公開情報はございません。

VNet 統合している場合の動作シーケンスのイメージは下記となります。 image-63418e81-91c7-4edb-8fd0-148e98fa756d.png

トリガーの同期失敗による影響と対策

トリガーの同期が失敗するとどういった影響があるか解説します。 構成例として、ある Azure Functions が VNet 統合を設定しており、サブネットに適用された NSG で外部接続（Outbound）がすべて拒否されている場合を考えます。

1. Azure ポータルにトリガーが表示されない

Kudu から確認するとアプリケーション ルート(/home/site/wwwroot/)にアプリケーション コードは配置されていますが、Azure ポータルの関数には一切の関数が表示されず、あたかも何もデプロイされていないように見えてしまいます。この状態ではデプロイされているアプリケーション コードは起動するため、処理は行われます。画面表示との乖離が問題となります。

image-31938ab1-6302-4bfb-88ff-d50e2443ba5d.png

また関数は確認できるものの、エラーが発生した旨を警告するメッセージが出力される場合もあります。

==image_0==-1312773e-66c0-407a-84bd-45b9e99c9a7d.png

この時 Azure Functions のアクティビティ ログを確認すると、直前のトリガーの同期が失敗していることがわかります。

image-6bb326fd-1d34-4c04-b4b5-7fae36e5233d.png

さらに、こちらから手動でトリガーの同期を実行することができます。実際にトリガーの同期を行ってみると 400 BadRequest が応答されます。

image-6e6ef434-b0e5-460b-a33f-2e309c0cc4dd.png

トリガーの同期の失敗については Application Insights 上でも以下のクエリを実行することで確認できます。 本確認手順の場合には、より詳細なエラー内容を確認することができ、下記の例の場合には、ネットワーク接続によるエラーであることまで確認できます。

Application Insights で利用するクエリ例

exceptions
| where customDimensions.FormattedMessage startswith "SyncTrigger"

image-a35a2e6f-f2bf-4437-ad5e-593fda0dabc9.png

2. 従量課金プランまたは EP プランのスケーリングが動作しない

従量課金プラン及び EP プランでは、イベントドリブン スケーリングと呼ばれる動作で Azure Functions プラットフォームにてスケール イン/アウトが行われます。この際に Azure Functions のスケール コントローラーと呼ばれるコンポーネントが動作しスケール イン/アウトの決定をしてますが、このスケール コントローラーも Azure Functions のメタデータを利用します。

キュー トリガーを例とすると、対象のキューの長さを基にスケール コントローラーがスケール イン/アウトの決定をします。トリガーの同期が失敗している場合には、そもそもスケール コントローラーが対象のキューの長さを参照するように動作せず、スケール イン/アウトの決定を行いません。結果として、多量のキュー メッセージがあるにもかかわらず、スケール アウトされない(性能上のボトルネック)や、従量課金プランの場合には 0 インスタンスとなる場合があるため、いつまで経ってもキュー メッセージが処理されないことが発生し得ます。

3. アプリ キーの更新が反映されない

更新したアプリ キーの反映にはキーを格納している Blob ストレージへの更新操作と、Azure Functions のキャッシュ情報を更新するためのトリガーの同期が行うことで実現しています。トリガーの同期が失敗している場合にはこの更新状態の不整合が生じ、更新したアプリ キーでアクセスするとアクセス エラーとなります。

対策

動作シーケンスの通りトリガーの同期の通信が通るように通信許可設定を追加します。 前述の NSG によって通信が拒否されている場合には、AppService のサービスタグを通信許可ルールとして追加します。AzureFirewall などを利用の場合には、*.azurewebsites.net の FQDN で 80 番及び 443 番ポートの外部通信を許可します。 またプライベート エンドポイントをご利用いただいている場合には、サービス タグの許可ではなく、IP アドレスの許可にてプライベート エンドポイントに対する通信を許可ルールに追加します。

NSG の送信ルール例

image-c22289ef-2b81-459f-a953-57b9e050a74b.png

また、一時的なネットワークによる失敗である場合には手動にてトリガーの同期を行うことも有効となります。

以上が Azure Functions におけるトリガーの同期の解説となります。Azure Functions にアプリケーションをデプロイしたけど、ポータルで参照できないなどトラブルシューティングにお役に立てば幸いです。





2026 年 04 月 01 日時点の内容となります。
本記事の内容は予告なく変更される場合がございますので予めご了承ください。



関連記事