Deploy the Collector for Linux with Puppet 🔗
LinuxにCollectorをインストールおよび構成するには、このモジュールを使用します。Puppet Forge からモジュールをダウンロードしてインストールします。モジュールをダウンロードした後、class
パラメータを使用してカスタマイズを追加できます。
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
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 から |
|
|
リクエストを認証する 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 リポジトリが外部で管理されている場合、 |
|
バックエンドアプリケーションの自動ディスカバリーの設定(Linuxのみ) 🔗
自動ディスカバリーを使用して、Collectorのインストールと一緒にバックエンドアプリケーションを自動的にインストルメンテーションできます。自動ディスカバリー(以前はゼロコンフィギュレーション自動インストルメンテーション)により、OpenTelemetry SDKを個別にインストールして設定する必要がなくなります。詳細は App とサービスのオートディスカバリー を参照してください。
次の表に、このPuppetモジュールで設定できる変数を示します:
Name |
説明 |
デフォルト値 |
---|---|---|
|
バックエンドアプリケーションの自動ディスカバリーをインストールまたは管理するかどうか。 |
|
|
インストールおよび有効化する自動ディスカバリー SDK。注: |
|
|
インストールする |
|
|
|
|
|
デフォルトでは、ノード上の |
なし |
|
OpenTelemetryのインストルメンテーションリソースの属性を設定します。例: |
なし |
|
すべてのインストルメンテーション対象アプリケーションのサービス名を明示的に設定します(例: |
なし |
|
AlwaysOn CPU プロファイリングを有効または無効にします。 |
|
|
AlwaysOn Memory Profiling を有効または無効にします。 |
|
|
インストルメンテーションメトリクスのエクスポートを有効または無効にします。 |
|
|
すべてのアクティブ化されたSDKによって収集されたメトリクス、トレース、ログにOTLPエンドポイントを設定します。 |
|
|
すべてのアクティブ化されたSDK、たとえば、 |
|
|
すべての有効化されたSDK、たとえば |
|
|
アクティブ化されたすべてのSDK、たとえば |
|
|
Splunk OpenTelemetry Java エージェントへのパス。デフォルトのパスは |
|
|
Node.js SDKをインストールするために必要な、プリインストールされた |
|
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください: