Azure Functions サービスの監視

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

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 Functions App Service を基にしています。 Azure Functions と Azure App Services のインストールおよび設定手順は同じです。

Windows に Instana Azure Functions のトレーサーをインストールするには、以下の手順を実行してください：

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

2. インスツルメントする Azure 関数を見つけます。

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

   

4. 「拡張機能」ページで、 「 Instana Tracing AppService 」拡張機能を追加してください。 「 Instana Tracing AppService 」拡張機能をインストールしたら、その拡張機能を使用するように設定してください。

5. Go 「拡張機能」ページに移動し、「 Instana Tracing AppService 」拡張機能の「 URL 」をクリックします。 「 Instana のApp Services用トレース」ダイアログが表示されます。

   

   1. 「 Instana の AppServices 用トレース」ウィンドウで、 「トレースを有効にする」 をオンに設定します。

   2. オプション: 「64 ビットを有効にする (Enable 64 bit)」 をオンに設定します。

   3. 「 エージェントキー 」フィールドに、 Instana ホストエージェントのライセンスキーを入力してください。

   4. 「エンドポイントの URL 」フィールドで、次のいずれかの操作を実行します：

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

   5. 「ログ・レベル」 フィールドに、使用する以下のいずれかのログ・レベルを入力します。

      • なし
      • DEBUG
      • INFO
      • WARN
      • ERROR

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

   6. 「構成の更新」をクリックします。 Azure 機能の情報が保存されます。

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

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

Azure のFunctionアプリケーションで Instana を動作させるには、次の行を: に追加してください。 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 』のドキュメントを参照してください。

Azure の関数アプリケーションを Azure に`--no-nuget-packages Docker Container `オプションを使用してデプロイする場合、 Instana のNugetパッケージをインストールして使用する必要はありません。 その代わりに、すべての Instana NuGetパッケージを、 Azure 上でアプリケーションがデプロイされているreleaseフォルダにコピーする必要があります。

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

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

ダウンロード・プロセスが終了したら、以下のファイルを Azure Function アプリケーション内のいくつかのフォルダーにコピーします。これらのフォルダーには、 Dockerfileから簡単にアクセスできます。

• 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 上のリリース・フォルダーにコピーします。

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	関数の固有 ID。
名前	Functions サービス・インスタンスの名前。
タイプ	関数サービス・タイプ。
Location	インスタンスが配置されているリージョン。
サブスクリプション	Functions サービス・インスタンスのサブスクリプション ID。
リソース・グループ	Functions サービス・インスタンスのリソース・グループ。