Chefを使用してCollector for Windowsをデプロイする

Chef を使用して OpenTelemetry Collector をインストールおよび設定し、Linux および Windows マシンからメトリクス、トレース、ログを収集し、Splunk Observability Cloud にデータを送信します。

Chef は、物理マシンや仮想マシン上のインフラを管理するために使われる構成管理技術です。Chef は Cookbook を使ってシナリオを定義します。

Cookbook は Chef の基本作業単位で、作業単位に関連するすべての詳細から構成され、Chef インフラストラクチャ上でノードとして構成されたシステムの設定や状態を変更する機能を持ちます。Cookbook は複数のタスクを実行できます。

前提条件

Chefを使うには以下のリソースが必要です：

Windows

次の Windows バージョン。すべてのバージョンで PowerShell 3.0 以降を使用する必要があります。

  • Windows Server 2019 64 ビット

  • Windows Server 2022 64-bit

  • Windows Server 2025 64-bit

注意: Windows では、Collector は Windows サービスとしてインストールされ、その環境変数はサービススコープで設定されるため、Collector サービスでのみ使用でき、マシン全体では使用できません。

ChefでCollectorをインストールして使う

コミュニティの Cookbook のサイトである Chef Supermarket から Chef Cookbook をダウンロードしてください。

Collector をインストールするには、splunk_otel_collector::default レシピを run_list に含め、ノードの run_state で属性を設定します。以下は、必須属性である splunk_access_token 属性と、いくつかの任意属性を設定する方法を示したサンプル構成です。

{
    "splunk-otel-collector": {
        "splunk_access_token": "<SPLUNK_ACCESS_TOKEN>",
        "splunk_realm": "<SPLUNK_REALM>",
    }
}

追加の環境変数

CollectorのサービスにCollector 設定ファイルから追加の環境変数を含めるには、collector_additional_env_varsを使用します。デフォルトでは {} です。

たとえば、Collector の設定ファイルに ${MY_CUSTOM_VAR1} と ${MY_CUSTOM_VAR2} への参照が含まれている場合、Collector サービスがこれらの変数を展開できるようにするには、次のように指定します。

collector_additional_env_vars: {'MY_CUSTOM_VAR1' => 'value1', 'MY_CUSTOM_VAR2' => 'value2'}

Linuxでは、変数/値は /etc/otel/collector/splunk-otel-collector.conf systemd環境ファイルに追加されます。

Windows では、変数/値は HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\splunk-otel-collector レジストリキーの下の Environment 値に追加されます。

次のステップ

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