インストーラ・スクリプトを使用して Collector for Windows をインストールします。

Splunk Distribution of the OpenTelemetry Collector for Windowsのインストール方法について説明します。

Splunk Distribution of the OpenTelemetry Collector for Windows は、すべてのデータタイプに対して統合された収集と転送を提供するパッケージです。インストーラスクリプトを使用してインストールする方法を学習します。

注: Splunk Distribution of the OpenTelemetry Collector にはデフォルト設定が付属しています。詳しくは「Collector for Windows default configuration」をご確認ください。この設定を変更するには、「Windowsの詳細設定」を参照してください。ログを取得するには、「Windowsの Collector を使用したログの収集」を参照してください。

または、Collector for Windowsをインストールすることもできます。

MSI を使用する場合。「MSI インストーラを使用して Collector for Windows をインストールする」を参照してください。
デプロイメントツールを使用する場合。「デプロイツールを使用して Collector for Windows をインストールする」を参照してください。
手動で行う場合。「Collector for Windows を手動でインストールする」を参照してください。

前提条件

Collectorは、インストール方法別に以下のWindowsバージョンをサポートしています：


インストール方法	対応バージョン（64ビット）
インストーラスクリプト	Windows 10 Pro および Home、Windows 11 Pro および Home、Windows Server 2016、2019、2022、2025
Windowsインストーラ（MSI）	Windows 10 Pro および Home、Windows 11 Pro および Home、Windows Server 2016、2019、2022、2025
Ansible	Windows 10 Pro および Home、Windows 11 Pro および Home、Windows Server 2016、2019、2022、2025
Chef	Windows 10 Pro および Home、Windows 11 Pro および Home、Windows Server 2019、2022
Nomad	Windows 10 Pro および Home、Windows 11 Pro および Home、Windows Server 2016、2019
Puppet	Windows 10 Pro および Home、Windows 11 Pro および Home、Windows Server 2016、2019
Docker	Windows 10 Pro および Home、Windows 11 Pro および Home、Windows Server 2019、2022

注: PowerShell 3.0以上が必要です。

含まれるパッケージ

Windows インストーラーのスクリプトは、以下のパッケージをインストールします:

Dotnet 自動インストルメンテーション（有効な場合）。「.NET アプリケーションを Splunk Observability Cloud（OpenTelemetry）にインストルメンテーションする」を参照してください。
JMX メトリクスギャザラー。
Docker 環境のみの場合、Java JDK と JRE。

インストーラ・スクリプトを使用してCollector for Windowsをインストールする

インストーラスクリプトは 64 ビット Windows 環境向けに提供されており、Windows 用の Splunk ディストリビューション OpenTelemetry Collector をデプロイおよび設定します。

インストーラ・スクリプトを使用してパッケージをインストールするには、以下の手順に従ってください：

ホストの管理者権限を持っていることを確認してください。
ホスト上で以下のPowerShellコマンドを実行し、環境に応じて以下の変数を置き換えます：
- SPLUNK_REALM：データ送信先のレルムです。デフォルトは us0 です。「レルム」を参照してください。
- SPLUNK_ACCESS_TOKEN：データ取り込みリクエストを認証するための、base64 エンコードされたアクセストークンです。アクセストークンには、取り込み承認範囲が必要です。「Splunk Observability Cloud を使用した組織のアクセストークンの作成および管理」を参照してください。

& {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"}; Invoke-Command -ScriptBlock ([scriptblock]::Create(". {$script} $(&{$args} @params)"))}

PowerShellでTLSを有効化する必要がある場合は、次のコマンドを使用します：

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

注意: バージョン 0.89 以降、Splunk Distribution of the OpenTelemetry Collector for Windows のインストーラは、グローバルレベルではなくサービスレベルで環境変数を使用して設定を行います。追加設定を構成する場合は、サービス、プロセス、またはターミナルスコープを使用します。

Collector 実行ファイルを手動で起動します。

予期しない起動失敗が発生した場合は、Collector実行ファイルを手動で起動してみてください。

そのためには、管理者として以下のPowerShellコマンドを実行します：

& 'C:\Program Files\Splunk\OpenTelemetry Collector\otelcol.exe' --config 'C:\ProgramData\Splunk\OpenTelemetry Collector\agent_config.yaml'

Windows用インストーラ・スクリプトのオプション

Windowsインストーラ・スクリプトは、以下のオプションをサポートしています：


オプション	説明	デフォルト値
`access_token`	メトリクスデータを Splunk に送信する際に使用するトークン。
`realm`	使用する Splunk レルム。インジェスト、API、トレース、HEC のエンドポイント URL は、この値を使用して自動的に生成されます。Splunk レルムを見つけるには、「Note about realms」を参照してください。	`us0`
`memory`	Collector に割り当てるメモリの合計（MiB単位）。バラストサイズを自動的に計算します。詳細については「サイジングとスケーリング」を参照してください。	`512`
`mode`	Collectorserviceをホストモニタリング（ `agent` ）またはデータ転送（ `gateway` ）で実行するように構成します。	`agent`
`network_interface`	Collector レシーバーがリッスンするネットワーク・インターフェイス。	`0.0.0.0`
`ingest_url`	指定されたレルムから推測されるURLの代わりに、ベースとなるインジェストURLを明示的に設定します。	`https://ingest.REALM.signalfx.com`
`api_url`	指定したレルムから推測されるURLの代わりに、ベースAPIのURLを明示的に設定します。	`https://api.REALM.signalfx.com`
`trace_url`	指定されたレルムから推測されるエンドポイントではなく、明示的にトレースエンドポイント URL を設定します。	`https://ingest.REALM.signalfx.com/v2/trace`
`hec_url`	指定されたレルムから推測されるエンドポイントではなく、明示的に HEC エンドポイント URL を設定します。	`https://ingest.REALM.signalfx.com/v1/log`
`hec_token`	HEC トークンが、指定した Splunk アクセストークンと異なる場合に設定します。
`with_dotnet_instrumentation`	.NETアプリケーショントレースをローカルコレクタに転送するために、.NETトレースをインストールして構成するかどうか。	`$false`
`deployment_env`	.NET インストルメンテーションで使用されるシステム全体の環境タグ。`SIGNALFX_ENV` 環境変数を設定します。 `-with_dotnet_instrumentation` が `false` に設定されている場合は無視されます。
`bundle_dir`	モニター機能用のSmart Agent バンドルの場所。	`C:\Program Files\Splunk\OpenTelemetry Collector\agent-bundle`
`insecure`	true の場合、リソースのダウンロード時に証明書はチェックされません。	`$false`
`collector_version`	インストールする Collector の特定のバージョンを指定します。	最新バージョン利用可能
`stage`	[`test`、`beta`、`release`] からインストールするパッケージステージ。	`release`
`collector_msi_url`	Collector をインストールする際に、パッケージをダウンロードする代わりに、このローカルパスの Splunk OpenTelemetry Collector MSI パッケージを使用します。指定した場合、`-collector_version`と `-stage` パラメータは無視されます。	`https://dl.signalfx.com/splunk-otel-collector/` `msi/release/splunk-otel-collector-<version>-amd64.msi`
`msi_path`	パッケージをダウンロードする代わりに、インストールする Splunk OpenTelemetry Collector MSI パッケージのローカルパスを指定します。指定した場合、`-collector_version`と `-stage` パラメータは無視されます。
`msi_public_properties`	Splunk OpenTelemetry Collector MSI パッケージをインストールする際に使用するパブリック MSI プロパティを指定します。

次のステップ

パッケージをインストールしたら、以下を参照してください：

Collector for Linux のデフォルト設定。
Windows用の高度な設定。
Collector を使用します：一般的なタスクの実行方法。
Splunk Infrastructure Monitoring でナビゲーターを使用する。
Windows Event Viewer でログとエラーを表示します。詳細は、Microsoft のドキュメントサイトで「view logs and errors」を検索してください。