Deploy the Collector for Linux with Ansible 🔗
Ansibleコレクションをインストールする 🔗
Collector は以下のLinuxディストリビューションとバージョンをサポートしています:
Amazon Linux: 2, 2023.Fluentdによるログ収集は、現在Amazon Linux 2023ではサポートされていません。
CentOS: 7, 8, 9
Red Hat: 7, 8, 9
Oracle: 8, 9
Debian: 11, 12
SUSE: 12, 15 バージョン 0.34.0 以上。Fluentd によるログ収集は現在サポートされていません。
Ubuntu:16.04、18.04、20.04、22.04、24.04
Rocky Linux: 8, 9
Ansibleコレクションをインストールする前に、以下を実行します:
Splunk アクセストークン を検索します。
Splunk レルム を検索します。
公開ポート をチェックし、使用環境にコンフリクトがないことを確認してください。ポートはパッケージの設定で変更できます。
Ansible Galaxyは、Ansibleのコンテンツを共有するためのAnsible公式ハブです。プレイブックの詳細については、Splunk Distribution of OpenTelemetry Collector用のAnsibleコレクション を参照してください。
以下のコマンドを実行して、Ansible GalaxyからAnsibleコレクションをインストールします:
ansible-galaxy collection install signalfx.splunk_otel_collector
このロールを使用するには、プレイブックに signalfx.splunk_otel_collector.collector role
呼び出しを含めます。この役割にはroot権限が必要であることに注意してください。以下の例では、必要最小限の構成を持ってプレイブック内でこのロールを使用する方法を示します:
- 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)。デフォルト値は |
|
|
|
ログ収集のための Fluentd と依存関係をインストールまたは管理するオプション。依存関係には、Linux の機能を有効にするための |
|
インストールされている td-agent (Fluentd パッケージ) のバージョン。デフォルト値は、Debian jessie では |
|
リモートホスト上の Fluentd 設定ファイルへのパス。デフォルトの場所は |
|
リモートホストで |
バックエンドアプリケーションのゼロコードインストルメンテーションでオートディスカバリーを設定する(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、たとえば |
|
|
アクティブ化されたすべてのSDK、たとえば |
|
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください: