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 スクリプトを実行します：

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）にインストルメンテーションする」を参照してください。

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.