Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector for Windowsを使い始める » インストーラ・スクリプトを使用して Collector for Windows をインストールします。

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

Splunk Distribution of the OpenTelemetry Collector for Windowsは、すべてのデータタイプに対して統合された収集と転送を提供するパッケージです。複数のデプロイツールでインストールする方法については、続きをお読みください。

注釈

Splunk Distribution of the OpenTelemetry Collectorには、Collector for Windows のデフォルト設定 にあるようなデフォルトの設定が付属しています。この設定を変更するには、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 for Windowsをインストールする 🔗

このインストーラスクリプトは、Windows 64ビット環境で利用可能で、以下の展開と設定を行う:

  • Splunk Distribution of the OpenTelemetry Collector for Windows

  • td-agent を介してのFluentd。デフォルトでは無効になっています。

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

  1. ホストの管理者権限を持っていることを確認してください。

  2. ホスト上で以下の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 = "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 レルムを見つけるには、レルムについての注意 を参照してください。

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_fluentd

ログイベントをコレクタに転送するために fluentd をインストールして設定するかどうか。詳細は FluentdによりWindowsログを収集する を参照してください。

$false

with_dotnet_instrumentation

.NETアプリケーショントレースをローカルコレクタに転送するために、.NETトレースをインストールして構成するかどうか。

$false

deployment_env

.NET インストルメンテーションで使用されるシステム全体の環境タグ。SIGNALFX_ENV 環境変数を設定します。-with_dotnet_instrumentationfalse に設定されている場合は無視されます。

bundle_dir

モニター機能用のSmart Agent バンドルの場所。

C:\Program Files\Splunk\OpenTelemetry Collector\agent-bundle

insecure

trueの場合、リソースのダウンロード時に証明書はチェックされません。

$false

collector_version

インストールする Collector の特定のバージョンを指定します。

最新バージョン利用可能

stage

[ testbetarelease ] からインストールするパッケージ・ステージ。

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

fluentd_msi_url

インストールするFluentd MSIパッケージのURLを指定します。

https://packages.treasuredata.com/4/windows/td-agent-4.1.0-x64.msi

msi_path

パッケージをダウンロードする代わりにインストールする Splunk OpenTelemetry Collector MSI パッケージへのローカルパスを指定します。指定した場合、-collector_version-stage パラメータは無視されます。

msi_public_properties

Splunk OpenTelemetry Collector MSI パッケージをインストールする際に使用するパブリック MSI プロパティを指定します。

次のステップ 🔗

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

このページは 2025年01月15日 に最終更新されました。