インストーラ・スクリプトを使用して 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をインストールすることもできます。

前提条件

含まれるパッケージ

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

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

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

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

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

  2. ホスト上で以下のPowerShellコマンドを実行し、環境に応じて以下の変数を置き換えます：

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を有効化する必要がある場合は、次のコマンドを使用します：

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

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

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

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

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 プロパティを指定します。

次のステップ