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

Splunk Distribution of the OpenTelemetry Collector for Windows は、すべてのデータタイプに対して統合された収集と転送を提供するパッケージです。以下のいずれかの方法でパッケージをインストールしてください：

インストーラ・スクリプト
デプロイメントツール

または、Collector を手動でインストールすることもできます。方法については、Collector for Windows を手動でインストールするを参照してください。

注釈

Collectorにはデフォルト設定が付属しています。詳細は、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以上が必要です。

含まれるパッケージ 🔗

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

Dotnet 自動インストルメンテーション (有効な場合)。Splunk Observability Cloud (OpenTelemetry) 用 .NET アプリケーションのインストルメンテーションを参照してください。
Fluentd (有効な場合)。ログ収集のためにFluentdを設定するを参照してください。
JMX メトリクスギャザラー。
Docker 環境のみの場合、Java JDK と JRE。

スクリプトを使用してCollectorをインストールする 🔗

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

Splunk Distribution of the OpenTelemetry Collector for Windows
td-agent を介してのFluentd。デフォルトでは無効になっています。

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

ホストの管理者権限を持っていることを確認してください。
ホスト上で以下のPowerShellコマンドを実行し、環境に応じて以下の変数を置き換えます：
- SPLUNK_REALM: これはデータを送信するレルムです。デフォルトは us0 です。レルムを参照してください。
- SPLUNK_ACCESS_TOKEN:データ取り込みリクエストを認証するための、base64エンコードされたアクセストークンです。アクセストークンは ingest 認証スコープを持つ必要があります。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 レルムを見つけるには、レルムについての注意を参照してください。	`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を設定するを参照してください。	`$false`
`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`
`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 プロパティを指定します。

デフォルト設定の変更 🔗

Splunk Distribution of the OpenTelemetry Collector には、Collector for Windows のデフォルト設定にあるようなデフォルトの設定が付属しています。この設定は必要に応じて変更することができます。詳細は Windows用の高度な設定を参照してください。

Collectorの環境変数の詳細については、環境変数を参照してください。

デプロイメントツール 🔗

Splunk Observability Cloud は、このセクションで説明する設定管理オプションを提供します。

Ansible 🔗

Splunk は、Windows マシンからデータ (メトリクス、トレース、ログ) を収集し、そのデータを Splunk Observability Cloud に送信するように構成されたパッケージをインストールする Ansible ロールを提供します。ロールをダウンロードしてカスタマイズする手順については、Ansible for WindowsでCollectorをデプロイするを参照してください。

Chef 🔗

Splunk は Chef を使って Collector をインストールするための Cookbook を提供しています。インストール手順については ChefでCollectorをデプロイするを参照してください。

Nomad 🔗

Nomad を使用して Collector をデプロイします。Nomad のインストール方法については、Nomad でCollectorをデプロイするを参照してください。

Puppet 🔗

Splunk は、パッケージのインストールと設定を行うための Puppet モジュールを提供します。モジュールとは、リソース、クラス、ファイル、定義、テンプレートの集まりです。モジュールをダウンロードしてカスタマイズする方法については、Windows用Puppetを使用してコレクタをデプロイするを参照してください。

次のステップ 🔗

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

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

This page was last updated on 2024年04月23日.

Related Topics