MSIインストーラーを使用してCollector for Windowsをインストールする 🔗
Windows MSIインストーラーを使用してSplunk Distribution of the Collector for Windowsをインストールできます。
注釈
Splunk Distribution of the OpenTelemetry Collectorには、Collector for Windows のデフォルト設定 にあるようなデフォルトの設定が付属しています。この設定を変更するには、Windows用の高度な設定 を参照してください。
ログを取得する方法については、Collector for Windows のログを収集する を参照してください。
または、Collector for Windowsをインストールすることもできます。
インストーラ・スクリプトの使用。インストーラ・スクリプトを使用して Collector for Windows をインストールします。 を参照してください。
デプロイメントツールの使用。デプロイツールを使用して Collector for Windowsをインストールする を参照してください。
手動。Collector for Windows を手動でインストールする を参照してください。
前提条件 🔗
Collector は、インストール方法によって以下の Windows バージョンをサポートしています:
インストール方法 |
対応バージョン(64ビット) |
---|---|
インストーラ・スクリプト |
Windows 10 Pro および Home、Windows Server 2016、2019、2022、2025 |
Windowsインストーラ(MSI) |
Windows 10 Pro および Home、Windows Server 2016、2019、2022、2025 |
Ansible |
Windows 10 Pro および Home、Windows Server 2016、2019、2022、2025 |
Chef |
Windows 10 Pro および Home、Windows Server 2019、2022 |
Nomad |
Windows 10 Pro および Home、Windows Server 2016、2019 |
Puppet |
Windows 10 Pro および Home、Windows Server 2016、2019 |
Docker |
Windows 10 Pro および Home、Windows Server 2019、2022 |
注釈
PowerShell 3.0以上が必要です。
Windowsインストーラーファイルを使用してCollectorをインストールする 🔗
Windows Installerを使用してパッケージをインストールするには、Windows MSIパッケージ (64ビットのみ) を GitHubリリースサイト からダウンロードしてください。
パッケージは
\Program Files\Splunk\OpenTelemetry Collector
にインストールされます。
splunk-otel-collector
サービスは作成されますが、開始されません。デフォルトの設定ファイルがまだ存在しない場合は、
\ProgramData\Splunk\OpenTelemetry Collector\agent_config.yaml
にコピーされます。このファイルは、splunk-otel-collector
サービスを開始するために必要です。
注釈
Windowsのデフォルトでは、ProgramData
フォルダは非表示になっています。
次に、インストーラーのステップに従うか、Powershellターミナルを使ってインストールします。
グラフィカルインストーラーを使ってインストールする 🔗
ダウンロードしたパッケージを実行し、ガイドされたセットアップの指示に従ってください。
PowerShellターミナルを使用してインストールする 🔗
以下の手順に従ってください:
PowerShellターミナルを開きます。
以下のコマンドを実行してください。
PATH_TO_MSI
はダウンロードしたパッケージのフルパスです。例えば、C:\your\download\folder\splunk-otel-collector-0.4.0-amd64.msi
。Start-Process -Wait msiexec "/i PATH_TO_MSI /qn"
以下の表に示す変数を使用してCollectorを設定します:
Start-Process -Wait msiexec "/i PATH_TO_MSI /qn SPLUNK_ACCESS_TOKEN=<my_access_token>"
MSIデプロイの方法で以下のインストール設定を使用します:
Name |
説明 |
デフォルト |
---|---|---|
|
リクエストを認証するためのSplunkアクセストークン。 |
空 |
|
Splunk API URL。 |
|
|
Smart Agentバンドルのパス。 |
|
|
Smart Agent の collectd config ディレクトリへのパス。例えば |
オプション。msiexecコマンドに渡された場合のみ追加されます。 |
|
Collectorカスタム設定ファイルの宛先パス。 |
|
|
ゲートウェイモードのURL |
オプション。msiexecコマンドに渡された場合のみ追加されます。 |
|
Splunk HEC認証トークン。 |
|
|
Splunk HECエンドポイントURL。 |
|
|
SplunkインジェストURL。 |
|
|
エージェントレシーバーがリッスンするネットワーク・インターフェイス。 |
オプション。msiexecコマンドに渡された場合のみ追加されます。 |
|
これを使用して、 |
オプション。msiexecコマンドに渡された場合のみ追加されます。 |
|
Collector に割り当てるメモリの合計(MiB単位 |
オプション。msiexecコマンドに渡された場合のみ追加されます。 |
|
Splunkレルム。 |
|
|
Collectorのデプロイモードを |
|
|
SplunkトレースエンドポイントURL。 |
|
システムを再起動するか、PowerShellターミナルで以下のコマンドを実行して、
splunk-otel-collector
サービスを開始します:
Start-Service splunk-otel-collector
PowerShellを使用した高度な設定オプション(Service Loggingを含む)については、以下のドキュメントを参照してください:
カスタムMSI URL 🔗
By default, the Collector MSI is downloaded from https://dl.signalfx.com .
To specify custom URLs for these downloads, replace COLLECTOR_MSI_URL
with the URL to the desired MSI packages to install:
& {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>"; collector_msi_url = "<COLLECTOR_MSI_URL>"; Invoke-Command -ScriptBlock ([scriptblock]::Create(". {$script} $(&{$args} @params)"))}
Chocolateyパッケージを使用してCollectorをインストールする 🔗
A Chocolatey package is available to download, install, and configure the Collector with the following PowerShell command:
choco install splunk-otel-collector --params="'/SPLUNK_ACCESS_TOKEN:MY_SPLUNK_ACCESS_TOKEN /SPLUNK_REALM:MY_SPLUNK_REALM'"
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください:
「Windows Event Viewerでログとエラーを表示する」。詳細は、Microsoftのドキュメントサイト で「view logs and errors」を検索してください。