Ansible for LinuxでCollectorをデプロイする 🔗
Ansibleコレクションをインストールする 🔗
以下のLinuxディストリビューションとバージョンがサポートされています:
Amazon Linux: 2, 2023。Fluentd によるログ収集は Amazon Linux 2023 ではサポートされていません。
CentOS、Red Hat、またはOracle: 7、8、9
Debian: 9, 10, 11
SUSE: 12, 15 Collector バージョン 0.34.0 以上。Fluentdによるログ収集はサポートされていません。
Ubuntu:16.04、18.04、20.04、22.04
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 設定ファイルへのパス。デフォルトの場所は |
|
リモートホストで |
Configure automatic discovery for back-end applications (Linux only) 🔗
You can automatically discover and instrument your back-end applications along with the Collector installation. Automatic discovery (formerly zero configuration auto instrumentation) removes the need to install and configure the SDKs separately. See Configure automatic discovery for Java for more information.
次の表は、この Ansible ロールに設定できる変数を示しています:
変数 |
説明 |
デフォルト値 |
---|---|---|
|
Installs or manages automatic discovery for Java, Node.js, and/or .NET back-end applications. When set to |
|
|
The automatic discovery SDKs to install and activate. Note: |
|
|
Determines the version of the |
|
|
By default, the |
|
|
By default, the |
なし |
|
Determines the path to the Splunk OpenTelemetry Java agent. The default path is provided by the |
|
|
The path to the pre-installed |
|
|
Configures the OpenTelemetry instrumentation resource attributes, for example, |
なし |
|
Explicitly sets the service name for the instrumented applications, for example, |
なし |
|
AlwaysOn CPU プロファイリングを有効または無効にします。 |
|
|
AlwaysOn Memory Profiling を有効または無効にします。 |
|
|
JVM メトリクスをアクティブまたは非アクティブにします。 |
|