Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector for Windowsを使い始める » Windows用の高度な設定

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_ACCESS_TOKEN

リクエストを認証するための Splunk アクセストークン

はい

SPLUNK_API_URL

Splunk API URL。たとえば、https://api.us0.signalfx.com

はい

SPLUNK_BALLAST_SIZE_MIB (非推奨)

memory_ballast は非推奨です。この変数を使用している場合は、設定の更新方法 を参照してください。

いいえ

SPLUNK_BUNDLE_DIR

Smart Agent バンドルのパス。例えば /usr/lib/splunk-otel-collector/agent-bundle

はい

SPLUNK_COLLECTD_DIR

Smart Agent の collectd config ディレクトリへのパス。例えば /usr/lib/splunk-otel-collector/agent-bundle/run/collectd

はい

SPLUNK_CONFIG

Collectorカスタム設定ファイルの保存先パス

いいえ

SPLUNK_CONFIG_YAML

カスタムコンフィギュレーションYAMLを指定します。これは基礎となるファイルシステムにアクセスしにくい環境で便利です。

いいえ

SPLUNK_DEBUG_CONFIG_SERVER

デフォルトでは、Collector は http://localhost:55554/debug/configz/effective でリッスンしている、センシティブな値を再編集するローカルコンフィグサーバーを提供し、トラブルシューティングに役立ちます。これを無効にするには、SPLUNK_DEBUG_CONFIG_SERVERtrue 以外の値に設定します。リッスンする希望のポートを設定するには SPLUNK_DEBUG_CONFIG_SERVER_PORT を使用します。

いいえ

SPLUNK_HEC_TOKEN

Splunk HEC 認証トークン

はい

SPLUNK_HEC_URL

Splunk HEC エンドポイント URL。たとえば、https://ingest.us0.signalfx.com/v1/log

はい

SPLUNK_INGEST_URL

Splunk インジェスト URL。たとえば、https://ingest.us0.signalfx.com

はい

SPLUNK_LISTEN_INTERFACE

エージェントレシーバーがリッスンするネットワーク・インターフェイス。デフォルトでは 0.0.0.0

はい

SPLUNK_MEMORY_LIMIT_MIB

これを使用して、memory_limiter プロセッサーのメモリ制限を設定します。デフォルトでは512MiB

いいえ

SPLUNK_MEMORY_TOTAL_MIB

Collector に割り当てるメモリの合計(MiB単位

いいえ

SPLUNK_REALM

Splunk レルム

いいえ

SPLUNK_TRACE_URL

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

このページは 2024年12月09日 に最終更新されました。