Windows用の高度な設定 🔗
Collectorにはデフォルト設定が付属しています。詳細は、Collector for Windows のデフォルト設定 を参照してください。
Change the default configuration file for the Collector for Windows 🔗
All installation methods offer default configurations using environment variables. Before starting the splunk-otel-collector
service, replace the variables in the default configuration file with the appropriate values for your environment.
Splunk 固有の環境変数を以下の表に示します:
Name |
説明 |
デフォルト設定は? |
---|---|---|
|
リクエストを認証するための Splunk アクセストークン |
はい |
|
Splunk API URL。たとえば、https://api.us0.signalfx.com |
はい |
|
|
いいえ |
|
Smart Agent バンドルのパス。例えば |
はい |
|
Smart Agent の collectd config ディレクトリへのパス。例えば |
はい |
|
Collectorカスタム設定ファイルの保存先パス |
いいえ |
|
カスタムコンフィギュレーションYAMLを指定します。これは基礎となるファイルシステムにアクセスしにくい環境で便利です。 |
いいえ |
|
デフォルトでは、Collector は http://localhost:55554/debug/configz/effective でリッスンしている、センシティブな値を再編集するローカルコンフィグサーバーを提供し、トラブルシューティングに役立ちます。これを無効にするには、 |
いいえ |
|
Splunk HEC 認証トークン |
はい |
|
Splunk HEC エンドポイント URL。たとえば、https://ingest.us0.signalfx.com/v1/log |
はい |
|
Splunk インジェスト URL。たとえば、https://ingest.us0.signalfx.com |
はい |
|
エージェントレシーバーがリッスンするネットワーク・インターフェイス。デフォルトでは |
はい |
|
これを使用して、 |
いいえ |
|
Collector に割り当てるメモリの合計(MiB単位 |
いいえ |
|
Splunk レルム |
いいえ |
|
Splunk トレースエンドポイント URL。たとえば、https://ingest.us0.signalfx.com/v2/trace |
はい |
SPLUNK_*_URL
環境変数は自動的に SPLUNK_REALM
から派生します。例えば、SPLUNK_INGEST_URL
= https://ingest.SPLUNK_REALM.signalfx.com。
注釈
追加設定を構成する場合は、サービス、プロセス、またはターミナルスコープを使用します。
Based on the specified installation parameters, the environment variables are saved to the HKLM:\SYSTEM\CurrentControlSet\Services\splunk-otel-collector
registry key and set on the Environment
entry.
設定値を変更するには、regedit
を実行し、パスをブラウズします。
メモリ割り当てを設定する 🔗
メモリ割り当てを設定するには、環境変数 SPLUNK_MEMORY_TOTAL_MIB
を設定する memory
パラメータを使用します。
デフォルトでは、Collector は 512 MiB のメモリを使用するように設定されています。
この設定を変更するには、
SPLUNK_MEMORY_TOTAL_MIB
を希望の整数値に置き換えます。
& {Set-ExecutionPolicy Bypass -Scope Process -Force; $script = ((New-Object System.Net.WebClient).DownloadString('https://dl.signalfx.com/splunk-otel-collector.ps1')); $params = @{access_token = "SPLUNK_ACCESS_TOKEN"; realm = "SPLUNK_REALM"; memory = "SPLUNK_MEMORY_TOTAL_MIB"}; Invoke-Command -ScriptBlock ([scriptblock]::Create(". {$script} $(&{$args} @params)"))}
Collector のサイズについて詳しくは サイジングとスケーリング を参照してください。
プロキシ設定を構成する 🔗
OpenTelemetry Collector をインストールして実行するためのプロキシ設定を行うには、Collectorのプロキシ設定を構成する を参照してください。
コマンドラインオプション 🔗
splunk-otel-collector
サービスのコマンドラインオプションを追加または削除するには、regedit
を実行し、HKLM:\SYSTEM\CurrentControlSet\Services\splunk-otel-collector
レジストリキーの ImagePath
の値を変更します。
あるいは、OPTIONS
を希望のコマンドラインオプションに置き換えて、以下のPowerShellコマンドを実行します:
Set-ItemProperty -path "HKLM:\SYSTEM\CurrentControlSet\Services\splunk-otel-collector" -name "ImagePath" -value "C:\Program Files\Splunk\OpenTelemetry Collector\otelcol.exe OPTIONS"
たとえば、Collector のデフォルトの公開メトリクスアドレスを 0.0.0.0:9090
に変更するには、次のPowerShellコマンドを実行します:
Set-ItemProperty -path "HKLM:\SYSTEM\CurrentControlSet\Services\splunk-otel-collector" -name "ImagePath" -value "C:\Program Files\Splunk\OpenTelemetry Collector\otelcol.exe --metrics-addr 0.0.0.0:9090"
変更を適用する 🔗
設定ファイルまたはレジストリキーを変更したら、システムを再起動するか、以下のPowerShellコマンドを実行して変更を適用します:
Stop-Service splunk-otel-collector
Start-Service splunk-otel-collector
利用可能なコマンドラインオプション 🔗
利用可能なコマンドラインオプションをすべて表示するには、以下のPowerShellコマンドを実行します:
& 'C:\Program Files\Splunk\OpenTelemetry Collector\otelcol.exe' --help