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

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 は、インストール方法によって以下の 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ターミナルを使用してインストールする 🔗

以下の手順に従ってください:

  1. PowerShellターミナルを開きます。

  2. 以下のコマンドを実行してください。PATH_TO_MSI はダウンロードしたパッケージのフルパスです。例えば、C:\your\download\folder\splunk-otel-collector-0.4.0-amd64.msi

    Start-Process -Wait msiexec "/i PATH_TO_MSI /qn"
    
  3. 以下の表に示す変数を使用してCollectorを設定します:

    Start-Process -Wait msiexec "/i PATH_TO_MSI /qn SPLUNK_ACCESS_TOKEN=<my_access_token>"
    

MSIデプロイの方法で以下のインストール設定を使用します:

Name

説明

デフォルト

SPLUNK_ACCESS_TOKEN

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

SPLUNK_API_URL

Splunk API URL。

https://api.[SPLUNK_REALM].signalfx.com

SPLUNK_BUNDLE_DIR

Smart Agentバンドルのパス。

[INSTALLDIR]\OpenTelemetry Collector\agent-bundle

SPLUNK_COLLECTD_DIR

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

オプション。msiexecコマンドに渡された場合のみ追加されます。

SPLUNK_CONFIG

Collectorカスタム設定ファイルの宛先パス。

[CommonAppDataFolder]Splunk\OpenTelemetry Collector\[SPLUNK_SETUP_COLLECTOR_MODE]_config.yaml

SPLUNK_GATEWAY_URL

ゲートウェイモードのURL

オプション。msiexecコマンドに渡された場合のみ追加されます。

SPLUNK_HEC_TOKEN

Splunk HEC認証トークン。

[SPLUNK_ACCESS_TOKEN]

SPLUNK_HEC_URL

Splunk HECエンドポイントURL。

https://ingest.[SPLUNK_REALM].signalfx.com/v1/log

SPLUNK_INGEST_URL

SplunkインジェストURL。

https://ingest.[SPLUNK_REALM].signalfx.com

SPLUNK_LISTEN_INTERFACE

エージェントレシーバーがリッスンするネットワーク・インターフェイス。

オプション。msiexecコマンドに渡された場合のみ追加されます。

SPLUNK_MEMORY_LIMIT_MIB

これを使用して、memory_limiter プロセッサーのメモリ制限を設定します。

オプション。msiexecコマンドに渡された場合のみ追加されます。

SPLUNK_MEMORY_TOTAL_MIB

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

オプション。msiexecコマンドに渡された場合のみ追加されます。

SPLUNK_REALM

Splunkレルム。

us0

SPLUNK_SETUP_COLLECTOR_MODE

Collectorのデプロイモードを agent または gateway に設定するプロパティをインストールします。詳しくは Collector のデプロイモード を参照してください。

agent

SPLUNK_TRACE_URL

SplunkトレースエンドポイントURL。

https://ingest.[SPLUNK_REALM].signalfx.com/v2/trace

  1. システムを再起動するか、PowerShellターミナルで以下のコマンドを実行して、splunk-otel-collector サービスを開始します:

Start-Service splunk-otel-collector

PowerShellを使用した高度な設定オプション(Service Loggingを含む)については、以下のドキュメントを参照してください:

ログ収集用にFluentd MSIをインストールする 🔗

ターゲットホストのログを収集したい場合は、FluentdがCollectorインスタンスにインストールされ、有効になっていることを確認します。

注釈

Fluentd でログ収集を設定するには、管理者である必要があります。

以下の手順を実行して、Fluentd をインストールし、collected ログイベントを Collector に転送します:

  1. Fluentd MSI バージョン4.0以上をインストールしてください。

  2. ログイベントを収集し、Collector に転送するように Fluentd を設定します:

    • オプション 1: 必要なログイベントを収集し、 127.0.0.1:8006 に転送するように、\opt\td-agent\etc\td-agent\td-agent.conf にある Fluentd MSI によって提供されるデフォルトの設定ファイルを更新します。

    • オプション 2: インストールされた Collector パッケージは、Windows イベントログ \Program Files\Splunk\OpenTelemetry Collector\fluentd\conf.d\eventlog.conf からログイベントを収集し、 127.0.0.1:8006 に転送するために、カスタム Fluentd 設定ファイル \Program Files\Splunk\OpenTelemetry Collector\fluentd\td-agent.conf を提供します。

    これらのファイルを使用するには、 \opt\td-agent\etc\td-agent ` ディレクトリをバックアップし、\Program Files\Splunk\OpenTelemetry Collector\fluentd ` から \opt\td-agent\etc\td-agent ` に内容をコピーします。

  3. Fluentd の設定ファイルに加えられた変更を適用するには、システムを再起動するか、fluentdwinsvc を再起動します。

- Stop-Service fluentdwinsvc
- Start-Service fluentdwinsvc
  1. \opt\td-agent\td-agent.log で、Fluentd のサービスログとエラーを表示します。

一般的な Fluentd の設定の詳細については、公式 Fluentd ドキュメント を参照してください。

カスタムMSI URL 🔗

デフォルトでは、Collector MSI は https://dl.signalfx.com からダウンロードされ、Fluentd MSI は https://packages.treasuredata.com からダウンロードされます。

これらのダウンロードにカスタムURLを指定するには、COLLECTOR_MSI_URLFLUENTD_MSI_URL をインストールするMSIパッケージのURLに置き換えます:

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

Chocolateyパッケージを使用してCollectorをインストールする 🔗

Chocolatey パッケージ をダウンロードしてインストールし、以下の PowerShell コマンドで Collector と Fluentd を設定することができます:

choco install splunk-otel-collector --params="'/SPLUNK_ACCESS_TOKEN:MY_SPLUNK_ACCESS_TOKEN /SPLUNK_REALM:MY_SPLUNK_REALM'"

次のステップ 🔗

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

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