Puppet for Linux でCollectorをデプロイする 🔗
LinuxにCollectorをインストールおよび構成するには、このモジュールを使用します。Puppet Forge からモジュールをダウンロードしてインストールします。モジュールをダウンロードした後、class パラメータを使用してカスタマイズを追加できます。
現在、以下のLinuxディストリビューションとバージョンをサポートしています：
Amazon Linux: 2, 2023。Fluentd によるログ収集は Amazon Linux 2023 ではサポートされていません。
CentOS / Red Hat / Oracle: 7, 8, 9
Debian: 9, 10, 11
SUSE: 12, 15 (注意: Collectorバージョンv0.34.0以降にのみ適用されます。Fluentdによるログ収集は現在サポートされていません)。
Ubuntu: 16.04, 18.04, 20.04, 22.04
Linuxシステムでは、puppetlabs/stdlibモジュール が必要です。
注釈
systemdはサービス管理のためにホストにインストールする必要があります。
Puppetモジュールを使用する 🔗
このモジュールを使用するには、マニフェストに splunk_otel_collector クラスをサポートされるパラメータとともに含めます (使用可能なパラメータの説明については、クラスのパラメータを変更する を参照してください)。たとえば、次のデプロイ定義は、デフォルトのパラメータを使用した最も単純なデプロイ定義です ( VERSION を希望の Collector バージョンに、SPLUNK_ACCESS_TOKEN をリクエストを認証する Splunk アクセストークンに、SPLUNK_REALM をデータ送信先のレルムに置き換えてください)：
class { splunk_otel_collector:
collector_version => 'VERSION'
splunk_access_token => 'SPLUNK_ACCESS_TOKEN',
splunk_realm => 'SPLUNK_REALM',
}
クラスのパラメータを変更する 🔗
このクラスは、以下の表に示すパラメータを受け付けます：
Name |
説明 |
デフォルト値 |
|---|---|---|
|
インストールする Collector パッケージのバージョン（例： |
なし |
|
Collector バージョン 0.97.0 から |
90% of |
|
リクエストを認証する Splunk アクセストークン。この属性は必須です。 |
なし |
|
どのレルムにデータを送信するか、例えば |
なし |
|
|
|
|
|
|
|
|
|
|
|
|
|
Splunk HEC 認証トークンを設定します ( |
|
|
Smart Agentバンドルディレクトリへのパス。デフォルトのパスはCollectorパッケージによって提供されます。指定したパスをデフォルト値から変更する場合は、ノードの既存のディレクトリにする必要があります。Collectorサービスでは、 |
|
|
Smart Agent バンドルのcollectd設定ディレクトリへのパス。デフォルトのパスはCollectorパッケージによって提供されます。指定されたパスがデフォルト値から変更される場合、パスはノード上の既存のディレクトリである必要があります。Collectorサービスでは、 |
|
|
Collector に割り当てる MIB の合計メモリ。バラストサイズを自動的に計算します。Collector サービスでは、 |
|
|
|
なし |
|
Collector 設定 YAML ファイルのソースパス。このファイルはノードの |
|
|
ノード上の Collector 構成ファイルの宛先パス。Collectorサービスでは、 |
|
|
Collector サービスのユーザーまたはグループの所有権を設定します。ユーザーまたはグループが存在しない場合は作成されます。 |
|
|
ログ収集のための Fluentd と依存関係をインストールするか管理するかどうか。Linux では、依存関係には、Linux の機能を有効にするための |
|
|
Fluentd 設定ファイルのソースパス。このファイルはノードの |
|
|
ノード上の Fluentd 設定ファイルへの宛先パス。 |
|
|
Collector と Fluentd apt/yum リポジトリが外部で管理されている場合、 |
|
Configure automatic discovery for back-end application(s) (Linux only) 🔗
You can automatically instrument your back-end applications along with the Collector installation using automatic discovery. Automatic discovery (formerly zero configuration auto instrumentation) removes the need to install and configure the OpenTelemetry SDKs separately. See Discover telemetry sources automatically for more information.
次の表に、このPuppetモジュールで設定できる変数を示します：
Name |
説明 |
デフォルト値 |
|---|---|---|
|
Whether to install or manage automatic discovery for back-end applications. When set to |
|
|
The automatic discovery SDKs to install and activate. Note: |
|
|
Version of the |
|
|
Whether to activate and configure the automatic discovery for |
|
|
By default, the |
なし |
|
Configure the OpenTelemetry instrumentation resource attributes, for example, |
なし |
|
Explicitly sets the service name for all instrumented applications, for example, |
なし |
|
AlwaysOn CPU プロファイリングを有効または無効にします。 |
|
|
AlwaysOn Memory Profiling を有効または無効にします。 |
|
|
インストルメンテーションメトリクスのエクスポートを有効または無効にします。 |
|
|
Sets the OTLP endpoint for collected metrics, traces, and logs by all activated SDKs. Only applicable if |
|
|
Sets the OTLP endpoint protocol for collected metrics, traces, and logs by all activated SDKs, for example |
|
|
Comma-separated list of exporters for collected metrics by all activated SDKs, for example |
|
|
Sets the exporter for collected logs by all activated SDKs, for example |
|
|
Splunk OpenTelemetry Java エージェントへのパス。デフォルトのパスは |
|
|
The path to the pre-installed |
|
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください：