モニタリング Azure ファンクション・サービス

Azure Functionsセンサーは無効にすることができ、タグやリソースグループでフィルタリングすることができる。 <agentinstall_dir>/etc/instana/configuration.yaml のエージェント設定を使用して、 Azure Functions センサーを設定できます：

com.instana.plugin.azure.functionapp:
  # Valid values: true, false
  enabled: false # enabled (true) by default
  # Comma separated list of tags in key:value format
  include_tags:
  # Comma separated list of tags in key:value format
  exclude_tags:
  # Comma separated list of resource groups
  include_resource_groups:
  # Comma separated list of resource groups
  exclude_resource_groups:

Azure Functionsサービスの監視を無効にするには、以下の設定を使用します：

com.instana.plugin.azure.functionapp:
  enabled: false

複数のタグとリソースグループを定義することができ、それらはカンマで区切られる。 タグは、コロン(:)で区切られたキーと値のペアとして提供される必要がある。設定を簡単にするために、どのタグとリソースグループをディスカバリーに含めるか、またはディスカバリーから除外するかを定義することができます。 タグまたはリソースグループを両方のリスト（インクルードとエクスクルード）で定義する場合、エクスクルードリストの方が優先順位が高くなります。 サービス・フィルタリングが必要なければ、コンフィギュレーションを定義する必要はない。 フィルタリングを有効にするために、すべての値を定義する必要はない。

タグによるサービスをディスカバリーに含めるには、以下の設定を使用する：

com.instana.plugin.azure.functionapp:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

タグによるサービスをディスカバリーから除外するには、以下の設定を使用する：

com.instana.plugin.azure.functionapp:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

リソースグループによるサービスをディスカバリーに含めるには、以下の設定を使用する：

com.instana.plugin.azure.functionapp:
  include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)

リソースグループの発見によってサービスを除外するには、以下の設定を使用します：

com.instana.plugin.azure.functionapp:
  exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)

すべての Azure サービスに対して、グローバル・レベルでディスカバリー・フィルタリングを構成できます。 Azure Functionsサービスにフィルタを定義すると、グローバルフィルタがオーバーライドされます。 グローバル Azure サービス・ディスカバリー・フィルタリングの詳細については、 Azure 設定を参照のこと。

Azure ファンクションは に基づいている。 App Service Azure Functions と Azure App Services のインストールと設定プロセスは同じです。

Instana Azure Functions トレーサーを Windows にインストールするには、次の手順を実行します：

1. Microsoft Azure ポータルにログオンする。

2. 計測したい Azure Function を探す。

3. 開発ツールパネルの拡張機能をクリックします。

   

4. 拡張機能ページで、 Instana Tracing AppService 拡張機能を追加します。 Instana Tracing AppService エクステンションをインストールしたら、エクステンションを使用するように設定します。

5. エクステンション ページに移動し URLAppService をクリックします。 Instana Tracing for App Services] ダイアログが表示されます。

   

   1. Instana Tracing for AppServices ウィンドウで、 Enable Tracing をオンに設定します。

   2. オプション： 64ビットを有効にするをオンに設定する。

   3. エージェントキー] フィールドに、Instana ホストエージェントのライセンスキーを入力します。

   4. Endpoint URL ］フィールドで、以下の手順のいずれかを実行します：

      • SaaS: サーバーレス監視用のエンドポイント URL を入力する。
      • セルフホスト： https://<IP address of the Instana backend>/serverless 形式でエンドポイントを入力し、 INSTANA_DISABLE_CA_CHECK パラメータを true または 1 に設定する。

   5. Log-Level フィールドに、使用したい以下のログレベルのいずれかを入力する：

      • なし
      • DEBUG
      • INFO
      • WARN
      • ERROR

      ログ情報は、 Azure 関数アプリケーションのルートフォルダに生成されます。

   6. Update Configをクリックします。 この情報は、 Azure 関数のために保存される。

6. Restart をクリックして Azure 機能を再起動する。 Azure 関数を実行すると、Instana リライターがアプリケーションにアタッチされ、Instana はトレースの収集を開始します。

Instana UI でトレースを表示するには、 Azure Function エンティティのダッシュボードを開き、 Upstream/Downstream をクリックします。 そして、このエンティティに対して収集されたトレースを見ることができる。 トレースの表示に関する詳細については、 「トレースとコールの分析」 を参照してください。

インスタナを Azure ファンクション・アプリケーションで動作させるには、次の行を Dockerfile に追加する：

DOTNET_STARTUP_HOOKS="[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.dll" \
CORECLR_ENABLE_PROFILING=1 \
CORECLR_PROFILER="{cf0d821e-299b-5307-a3d8-b283c03916dd}" \
CORECLR_PROFILER_PATH="[AzureWebJobsScriptRoot]/bin/instana_tracing/CoreProfiler.so" \
INSTANA_ENDPOINT_URL="[Serverless-ingress-URL-for-your-region]" \
INSTANA_AGENT_KEY="[Your-Instana-agent-key]"

INSTANA_ENDPOINT_URL の値は地域によって異なる。 詳細については、 サーバーレス監視のためのエンドポイントのドキュメントを参照してください。

.NET Core での Instana の設定に関する詳細については、.NET Core ドキュメントを参照してください。

Docker Container オプションを使用して Azure に Azure Function Application をデプロイする場合、Instana Nuget パッケージをインストールして使用する必要はありません。 代わりに、Instana Nuget パッケージをすべて、アプリケーションがデプロイされるリリースフォルダ Azure にコピーする必要があります。

パッケージの詳細については、.NET トレースのドキュメントを参照してください。

をダウンロードして、最新バージョンを使用していることを確認してください。 Instana.Tracing.Core パッケージ、 Instana.Tracing.Core.Sdk Instana.Tracing.Core.Rewriter.Linux パッケージをダウンロードしてください。

ダウンロードが完了したら、以下のファイルを Dockerfile から簡単にアクセスできる Azure Function Application 内のフォルダにコピーしてください：

• Instana.Tracing.Core.dll
• Instana.Tracing.Core.Common.dll
• Instana.Tracing.Core.Instrumentation.dll
• Instana.Tracing.Core.Transport.dll
• Instana.Tracing.Api.dll
• CoreProfiler.so
• instrumentation.json

次に、これらのファイルを Azure の release フォルダに以下のようにコピーする：

COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.Common.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.Common.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.Instrumentation.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.Instrumentation.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.Transport.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.Transport.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Api.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Api.dll"
COPY "/[path-to-your-patch-folder]/CoreProfiler.so" "[AzureWebJobsScriptRoot]/bin/instana_tracing/CoreProfiler.so"
COPY "/[path-to-your-patch-folder]/instrumentation.json" "[AzureWebJobsScriptRoot]/bin/instana_tracing/instrumentation.json "

その後、 Instana.Tracing.Core パッケージを削除し、このトピックで既に説明されている手順に従って、ライブラリファイルを Dockerfile 内の release フォルダにコピーしてください。

FunctionApp サービス内容	説明
ID	ファンクションアプリのユニークなID。
名前	FunctionApp インスタンスの名前。
タイプ	FunctionApp。
Location	インスタンスが配置されているリージョン。
種別	FunctionApp 口座の種類を示す。
サブスクリプション	FunctionApp サービスインスタンスのサブスクリプション ID。
リソース・グループ	FunctionApp サービスインスタンスのリソースグループ。
状態	インスタンスの現在のデプロイメント状態。

機能 サービス内容	説明
ID	FunctionのユニークID。
名前	Functionsサービスのインスタンス名。
タイプ	機能 サービスタイプ
Location	インスタンスが配置されているリージョン。
サブスクリプション	FunctionsサービスインスタンスのサブスクリプションID。
リソース・グループ	Functionsサービスインスタンスのリソースグループ。