Ansibleを使用してLinux用のCollectorをデプロイする
Linux に Splunk Observability Cloud OpenTelemetry Collector Ansible ロールをインストールする方法を説明します。
Ansibleコレクションをインストールする
Collector は以下のLinuxディストリビューションとバージョンをサポートしています:
-
Amazon Linux: 2、2023
-
CentOS: 7、8、9
-
Red Hat: 7、8、9
-
Oracle: 8、9
-
Debian: 11、12
-
SUSE:バージョン 0.34.0 以降の場合は 12、15
-
Ubuntu:16.04、18.04、20.04、22.04、24.04
-
Rocky Linux:8, 9
Ansibleコレクションをインストールする前に、以下を実行します:
-
Splunk アクセストークンを見つけます。
-
Splunk レルムを見つけます。
-
公開ポートを確認し、使用環境にコンフリクトがないことを確認してください。ポートはパッケージの構成で変更できます。
Ansible Galaxy は、Ansible のコンテンツを共有するための Ansible の公式ハブです。プレイブックについて、詳しくは「Ansible Collection for the Splunk Distribution of OpenTelemetry Collector」を参照してください。
以下のコマンドを実行して、Ansible GalaxyからAnsibleコレクションをインストールします:
ansible-galaxy collection install signalfx.splunk_otel_collector
ロールを使用するには、プレイブックに signalfx.splunk_otel_collector.collector role 呼び出しを含めてください。ロールにはルートアクセスが必要となります。以下の例では、必要最小限の構成を持ってプレイブック内でこのロールを使用する方法を示します:
- name: Install the Splunk Distribution of OpenTelemetry Collector
hosts: all
become: yes
tasks:
- name: "Include splunk_otel_collector"
include_role:
name: "signalfx.splunk_otel_collector.collector"
vars:
splunk_access_token: YOUR_ACCESS_TOKEN
splunk_realm: SPLUNK_REALM
次の表は、このロールに設定できる変数について説明したものです:
|
変数 |
説明 |
|---|---|
|
|
Collector バージョン 0.97.0 以降で、 |
|
|
リクエストを認証するためのSplunkアクセストークン。属性は必須です。 |
|
|
データ送信先のレルムです。この変数は、サービスのこの値で設定されます。デフォルト値は |
|
|
Splunk インジェスト URL です。 |
|
|
Splunk API の URL です。 |
|
|
Splunk トレースエンドポイント URL です。 |
|
|
Splunk HEC エンドポイント URL です。 |
|
|
インストールするパッケージのバージョンです。 |
|
|
YAML で作成される設定ファイルです。この変数を |
|
|
デフォルトのコンフィギュレーションにマージされるカスタムコンフィギュレーション。 |
|
|
|
|
|
これは、制御ホスト上の設定ファイルのソースパスで、リモートホスト上の |
|
|
バンドルディレクトリへのパスです。デフォルトのパスは、パッケージによって提供されます。指定するパスがデフォルト値から変更されている場合、パスはノード上の既存のディレクトリにする必要があります。この変数は、サービスのこの値で設定されます。デフォルトの場所は |
|
|
バンドル用の collectd 設定ディレクトリへのパスです。デフォルトのパスは、パッケージによって提供されます。指定するパスがデフォルト値から変更されている場合、パスはノード上の既存のディレクトリにする必要があります。この変数は、サービスのこの値で設定されます。デフォルトの場所は |
|
|
サービスのユーザーあるいはグループ所有権です。ユーザーまたはグループが存在しない場合は作成されます。デフォルト値は |
|
|
|
|
|
割り当てられたメモリの量(MiB 単位)です。デフォルト値は |
|
|
|
バックエンドアプリケーションのゼロコードインストルメンテーションでオートディスカバリーを設定する(Linuxのみ)
Collector のインストールと同時に、バックエンドアプリケーションを自動検出してインストルメンテーションします。自動検出(以前のゼロ構成自動インストルメンテーション)により、SDK を個別にインストールして構成する必要がなくなります。詳細は「バックエンドアプリケーションの自動ディスカバリーを設定する」を参照してください。
次の表は、この Ansible ロールに設定できる変数を示しています:
|
変数 |
説明 |
デフォルト値 |
|---|---|---|
|
|
Java、Node.js、および .NET のバックエンドアプリケーション向けに、自動検出機能をインストールまたは管理します。 |
|
|
|
インストールしてアクティブ化する自動検出 SDK です。注: |
|
|
|
|
|
|
|
デフォルトでは、ノードの |
|
|
|
デフォルトでは、ノード上の |
なし |
|
|
Splunk OpenTelemetry Java エージェントへのパスを決定します。デフォルトのパスは、 |
|
|
|
Node.js SDK をインストールするために必要な、プリインストールされた |
|
|
|
OpenTelemetry インストルメンテーションリソースの属性を設定します。例: |
なし |
|
|
インストルメンテーションされたアプリケーションのサービス名を明示的に設定します( |
なし |
|
|
AlwaysOn CPU プロファイリングを有効または無効にします。 |
|
|
|
AlwaysOn Memory Profiling を有効または無効にします。 |
|
|
|
JVM メトリクスをアクティブまたは非アクティブにします。 |
|
|
|
あらゆる有効 SDK が収集したメトリクス、トレース、ログに OTLP エンドポイントを設定します。 |
|
|
|
|
|
|
|
すべてのアクティブ化された SDK によって収集されたメトリクスのエクスポータのカンマ区切りリスト( |
|
|
|
あらゆる有効 SDK が収集したログにエクスポータを設定します( |
|
次のステップ
パッケージをインストールしたら、以下を参照してください: