Deploy the Collector for Linux with Puppet 🔗
LinuxにCollectorをインストールおよび構成するには、このモジュールを使用します。Puppet Forge からモジュールをダウンロードしてインストールします。モジュールをダウンロードした後、class
パラメータを使用してカスタマイズを追加できます。
Collector は以下のLinuxディストリビューションとバージョンをサポートしています:
Amazon Linux: 2, 2023.
CentOS: 7, 8, 9
Red Hat: 7, 8, 9
Oracle: 8, 9
Debian: 11, 12
SUSE: 12, 15 for version 0.34.0 or higher.
Ubuntu:16.04、18.04、20.04、22.04、24.04
Rocky Linux: 8, 9
Linuxシステムでは、puppetlabs/stdlibモジュール が必要です。
注釈
systemdはサービス管理のためにホストにインストールする必要があります。
Puppetモジュールを使用する 🔗
To use this module, include the splunk_otel_collector
class in your manifests with the supported parameters (see クラスのパラメータを変更する for descriptions of the available parameters). For example, the following deployment definition is the simplest deployment definition with the default parameters (replace VERSION
with the desired Collector version, SPLUNK_ACCESS_TOKEN
with your Splunk access token to authenticate requests, and SPLUNK_REALM
for the realm to send the data to):
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 サービスのユーザーまたはグループの所有権を設定します。ユーザーまたはグループが存在しない場合は作成されます。 |
|
バックエンドアプリケーションの自動ディスカバリーの設定(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をインストールするために必要な、プリインストールされた |
|
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください: