Monitoring Azure Functions サービス

オプションの構成

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 構成を参照してください。

Windows での Instana Azure Functions トレーサーのインストール

Azure Functions は、 App Serviceに基づいています。 Azure Functions と Azure App Services のインストールと構成のプロセスは同じです。

Windows に Instana Azure Functions トレーサーをインストールするには、以下のステップを実行します。

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

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

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

4. 「拡張機能」ページで、 Instana トレース AppService 拡張機能を追加します。 Instana トレース AppService 拡張機能をインストールした後、それを使用するように拡張機能を構成します。

5. 「拡張」ページに移動し、Instana Tracing AppService 拡張で URL をクリックします。 「アプリ・サービスの Instana トレース」ダイアログが表示されます。
   

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

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

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

   4. 「エンドポイント URL フィールドに、 serverless monitoring 用のエンドポイント URLを入力します。

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

      • なし
      • デバッグ
      • 情報
      • 警告
      • エラー

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

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

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

Instana UI でトレースを表示するには、 Azure Function エンティティーのダッシュボードを開き、 「アップストリーム/ダウンストリーム」をクリックします。 その後、このエンティティーについて収集されたトレースを確認できます。 トレースの表示について詳しくは、「 トレースおよび呼び出しの分析」を参照してください。

Instana Azure Functions トレーサーの Docker

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 資料。

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

パッケージについて詳しくは、 を参照してください。NET Tracing の資料。

最新の 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 パッケージを Azure Function Application に直接インストールしないでください。 アプリケーションのデプロイ後に重複するライブラリー・ファイルがある場合、トレースは機能しません。

次に、 Instana.Tracing.Core パッケージを削除し、このトピックで既に説明されている指示に従って、 Dockerfile内のリリース・フォルダーにライブラリー・ファイルをコピーします。

FunctionApps

関数