Windows でのバックエンドアプリケーションのゼロコードインストルメンテーション
OpenTelemetry .NET のオートディスカバリは、Windows で実行されている .NET アプリケーションのゼロコードインストルメンテーションをアクティブ化します。 デフォルトでは、ゼロコードインストルメンテーションは IIS アプリケーションでのみオンになっています。他のアプリケーションおよびサービスタイプをアクティブ化するには、「Splunk Distribution of OpenTelemetry .NET を手動でインストールする」を参照してください。パッケージのインストール後、インストルメンテーションする .NET アプリケーションのいずれかを起動または再起動する必要があります。
はじめに
Windows のゼロコードインストルメンテーションを始めるには、以下の手順に従ってください:
パッケージをインストールする
デフォルトでは、インストーラスクリプトは 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)にインストルメンテーションする」を参照してください。
トラブルシューティング
__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____
_________ __ ______ _____________ _____ _________
-
______ _ ____ __ ___ ______ _______ _______
-
_______ ______ ________
_________ __ ___________ _________ ___ ____ _____ _____
-
___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
-
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______