Windows でのバックエンドアプリケーションのゼロコードインストルメンテーション

OpenTelemetry .NET のオートディスカバリは、Windows で実行されている .NET アプリケーションのゼロコードインストルメンテーションをアクティブ化します。 デフォルトでは、ゼロコードインストルメンテーションは IIS アプリケーションでのみオンになっています。他のアプリケーションおよびサービスタイプをアクティブ化するには、「Splunk Distribution of OpenTelemetry .NET を手動でインストールする」を参照してください。パッケージのインストール後、インストルメンテーションする .NET アプリケーションのいずれかを起動または再起動する必要があります。

はじめに

Windows のゼロコードインストルメンテーションを始めるには、以下の手順に従ってください:

  1. パッケージをインストールする

  2. .NETインストルメンテーションの設定

  3. (オプション)パッケージをアップグレードする

パッケージをインストールする

デフォルトでは、インストーラスクリプトは Collector のみをインストールします。with_dotnet_instrumentation パラメータを追加すると、スクリプトは Splunk Distribution of OpenTelemetry .NET もダウンロードしてインストールします。

次の例に示すように、with_dotnet_instrumentation パラメータを指定して PowerShell スクリプトを実行します:

& {Set-ExecutionPolicy Bypass -Scope Process -Force; `
$script = ((New-Object System.Net.WebClient).DownloadString('https://dl.signalfx.com/splunk-otel-collector.ps1')); `
$params = @{access_token = "<access_token>"; realm = "<realm>"; mode = "agent"; with_dotnet_instrumentation = "`$true"; deployment_env = "<environment_name>"}; `
Invoke-Command -ScriptBlock ([scriptblock]::Create(". {$script} $(&{$args} @params)"))}

コマンドをカスタマイズするには次のようにします:

  • <environment_name> をターゲット環境のラベルに置き換えます。

  • <access_token> を有効な Splunk Observability Cloud アクセストークンに置き換えます。アクセストークンを取得するには、「Splunk Observability Cloud を使用したユーザー API アクセストークンの取得と管理」を参照してください。

  • <realm> を Splunk Observability Cloud レルム、たとえば us0で置き換えます。アカウントのレルム名を確認するには、Splunk Observability Cloud のナビゲーションメニューを開き、[Settings] を選択し、ユーザー名を選択します。レルム名は Organizations セクションに表示されます。

.NETインストルメンテーションの設定

.NET インストルメンテーションを設定するには、「Splunk Distribution of OpenTelemetry .NET を設定する」を参照してください。

(オプション)パッケージをアップグレードする

新しいバージョンの Splunk Distribution of OpenTelemetry .NET をインストールすることで、パッケージをアップグレードできます。「.NET アプリケーションを Splunk Observability Cloud(OpenTelemetry)にインストルメンテーションする」を参照してください。

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______