Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector for Windowsを使い始める » Collector for Windows を手動でインストールする

Collector for Windows を手動でインストールする 🔗

You can use Windows MSI to install the Splunk Distribution of the Collector for Windows.

注釈

The Splunk Distribution of the OpenTelemetry Collector comes with a default configuration, as detailed in Collector for Windows のデフォルト設定. To modify this configuration, refer to Windows用の高度な設定.

To learn how to obtain logs, see Collect logs with the Collector for Windows.

Alternatively, you can also install the Collector for Windows:

前提条件 🔗

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

インストール方法

対応バージョン（64ビット）

インストーラ・スクリプト

Windows 10 Pro および Home、Windows Server 2016、2019、2022

Windowsインストーラ（MSI）

Windows 10 Pro および Home、Windows Server 2016、2019、2022

Ansible

Windows 10 Pro および Home、Windows Server 2016、2019、2022

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以上が必要です。

Install the Collector for Windows using Docker 🔗

以下のコマンドを実行して、最新のDockerイメージをデプロイします：

$ docker run --rm -e SPLUNK_ACCESS_TOKEN=12345 -e SPLUNK_REALM=us0  `
          -p 13133:13133 -p 14250:14250 -p 14268:14268 -p 4317:4317 -p 6060:6060  `
          -p 8888:8888 -p 9080:9080 -p 9411:9411 -p 9943:9943 `
          --name=otelcol quay.io/signalfx/splunk-otel-collector-windows:latest

Install the Collector for Windows using the binary file 🔗

バイナリファイルを使用して Collector をインストールするには、以下の手順に従います：

  1. GitHub リリース から、お使いのアーキテクチャーのバイナリをダウンロードしてください。

  2. 既存の設定ファイルまたはカスタム設定ファイルを使用していない場合は、Collector 用の デフォルト設定ファイル<https://github.com/signalfx/splunk-otel-collector/tree/main/cmd/otelcol/config/collector>` をダウンロードしてください。詳細は Collector for Windows のデフォルト設定 を参照してください。

  3. コマンドラインからバイナリを実行します：

# see available command-line options
PS> & '<download dir>\otelcol_windows_amd64.exe' --help
Usage of otelcol:
    --config string          Locations to the config file(s), note that only a single location can be set per flag entry e.g. --config=/path/to/first --config=path/to/second. (default "[]")
    --feature-gates string   Comma-delimited list of feature gate identifiers. Prefix with '-' to disable the feature. '+' or no prefix will enable the feature. (default "[]")
    --no-convert-config      Do not translate old configurations to the new format automatically. By default, old configurations are translated to the new format for backward compatibility.
    --set string             Set arbitrary component config property. The component has to be defined in the config file and the flag has a higher precedence. Array config properties are overridden and maps are joined. Example --set=processors.batch.timeout=2s (default "[]")
    -v, --version                Version of the collector.

# set the SPLUNK_REALM and SPLUNK_ACCESS_TOKEN env vars required in our default config files
PS> $env:SPLUNK_REALM = "<realm>"
PS> $env:SPLUNK_ACCESS_TOKEN = "<token>"

# start the collector
PS> & '<download dir>\otelcol_windows_amd64.exe' --config=<path to config file>

# alternatively, use the SPLUNK_CONFIG env var instead of the --config command-line option
PS> $env:SPLUNK_CONFIG = "<path to config file>"
PS> & '<download dir>\otelcol_windows_amd64.exe'

# type Ctrl-c to stop the collector

カスタム設定ファイルを使用する 🔗

カスタム構成ファイルを使用する場合は、そのファイルを含むディレクトリをマウントし、SPLUNK_CONFIG=<path> 環境変数または --config=<path> コマンドライン引数を使用します。<path> をコンテナ内のカスタム・ファイルへのパスに置き換えます。

構成ファイルをWindowsコンテナにマウントするには、構成ファイルが存在するディレクトリ名を指定します。

SPLUNK_CONFIG による例 🔗

$ docker run --rm -e SPLUNK_ACCESS_TOKEN=12345 -e SPLUNK_REALM=us0 `
          -e SPLUNK_CONFIG=c:\splunk_config\gateway_config.yaml -p 13133:13133  `
          -p 14250:14250 -p 14268:14268 -p 4317:4317 -p 6060:6060 -p 8888:8888 -p 9080:9080 `
          -p 9411:9411 -p 9943:9943 -v ${PWD}\splunk_config:c:\splunk_config:RO `
          --name otelcol quay.io/signalfx/splunk-otel-collector-windows:latest

--config による例 🔗

$ docker run --rm -e SPLUNK_ACCESS_TOKEN=12345 -e SPLUNK_REALM=us0 `
    -p 13133:13133 -p 14250:14250 -p 14268:14268 -p 4317:4317 -p 6060:6060 `
    -p 8888:8888 -p 9080:9080 -p 9411:9411 -p 9943:9943 `
    -v ${PWD}\splunk_config:c:\splunk_config:RO `
    --name otelcol quay.io/signalfx/splunk-otel-collector-windows:latest `
    --config c:\splunk_config\gateway_config.yaml

次のステップ 🔗

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

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