Saltを使用してCollector for Linuxをデプロイする 🔗
式を使用して Collector をインストールおよび設定し、Linux マシンからメトリクス、トレース、ログを収集し、Splunk Observability Cloud にデータを送信することができます。Salt モジュールをダウンロードするには、GitHub リポジトリ を参照してください。
数式はあらかじめ書かれた Salt States です。Salt States と同様に自由で、パッケージのインストール、サービスの設定と開始、ユーザーやアクセス許可の設定、その他多くの一般的なタスクに使用できます。
前提条件 🔗
Salt を使うには以下のリソースが必要です:
公開されているポートをチェックして、環境に競合がないことを確認します。Collector の設定でポートを変更できます。詳細は 公開ポートとエンドポイント を参照してください。
サポートされているLinuxバージョン 🔗
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
はじめに 🔗
Saltは、ユーザー定義のデータを 「ミニオン」が利用できるようにするために、「ピラー」と呼ばれるキーバリューストアを使用します。Saltはミニオンを、マネージャーからのコマンドを聞き、要求されたタスクを実行できるSaltミニオンデーモンを実行しているサーバーと定義しています。一般的に、ミニオンはSaltを使って制御されるサーバーです。
splunk-otel-collector
ピラーですべての属性を設定することができます。例:
splunk-otel-collector:
splunk_access_token: "MY_ACCESS_TOKEN"
splunk_realm: "SPLUNK_REALM"
splunk_repo_base_url: https://splunk.jfrog.io/splunk
splunk_otel_collector_config: '/etc/otel/collector/agent_config.yaml'
splunk_service_user: splunk-otel-collector
splunk_service_group: splunk-otel-collector
Linux 対応の属性 🔗
Linuxの場合、数式は以下の表に示す属性を受け付けます:
Name |
説明 |
デフォルト値 |
---|---|---|
|
インストールする Collector パッケージのバージョン(例: |
なし |
|
Collector バージョン 0.97.0 から |
|
|
リクエストを認証する Splunk アクセストークン。この属性は必須です。 |
なし |
|
どのレルムにデータを送信するか、例えば |
なし |
|
|
|
|
|
|
|
|
|
|
|
|
|
Splunk HEC 認証トークンを設定します ( |
|
|
Smart Agentバンドルディレクトリへのパス。デフォルトのパスはCollectorパッケージによって提供されます。指定したパスをデフォルト値から変更する場合は、ノードの既存のディレクトリにする必要があります。Collectorサービスでは、 |
|
|
Smart Agent バンドルのcollectd設定ディレクトリへのパス。デフォルトのパスはCollectorパッケージによって提供されます。指定されたパスがデフォルト値から変更される場合、パスはノード上の既存のディレクトリである必要があります。Collectorサービスでは、 |
|
|
Collector に割り当てる MIB の合計メモリ。バラストサイズを自動的に計算します。Collector サービスでは、 |
|
|
|
|
|
リモートホストの |
|
|
Collector サービスのユーザーまたはグループの所有権を設定します。ユーザーまたはグループが存在しない場合は作成されます。 |
|
|
ログ収集のための Fluentd と依存関係をインストールするか管理するかどうか。Linux では、依存関係には、Linux の機能を有効にするための |
|
|
インストールする td-agent (Fluentd) パッケージのバージョン |
|
|
リモートホストの Fluentd 設定ファイルへのパス。 |
|
|
リモートホストの |
|
|
ノード上の Fluentd 設定ファイルへの宛先パス。 |
|
バックエンドアプリケーションの自動ディスカバリーを設定する 🔗
Collectorのインストールと同時に、バックエンドのアプリケーションを自動的にインストルメンテーションすることができます。自動ディスカバリーにより、OpenTelemetry SDKを個別にインストールして設定する必要がなくなります。詳細は バックエンドアプリケーションの自動ディスカバリーを設定する を参照してください。
次の表に、このSaltモジュールで設定可能な変数を示します:
Name |
説明 |
デフォルト値 |
---|---|---|
|
バックエンドアプリケーションの自動ディスカバリーをインストールまたは管理するかどうか。 |
|
|
インストールする |
|
|
|
|
|
デフォルトでは、ノード上の |
|
|
Splunk OpenTelemetry Java エージェントへのパス。デフォルトのパスは |
|
|
Node.js SDKをインストールするために必要な、プリインストールされた |
|
|
OpenTelemetryインストルメンテーションリソースの属性を設定します。例: |
|
|
すべてのインストルメンテーション対象アプリケーションのサービス名を明示的に設定します(例: |
|
|
AlwaysOn CPU プロファイリングを有効または無効にします。 |
|
|
AlwaysOn Memory Profiling を有効または無効にします。 |
|
|
インストルメンテーションメトリクスをアクティブまたは非アクティブにします。 |
|
|
すべてのアクティブ化されたSDKによって収集されたメトリクス、トレース、ログにOTLPエンドポイントを設定します。 |
|
|
すべてのアクティブ化されたSDK、たとえば、 |
|
|
すべての有効化されたSDK、たとえば |
|
|
アクティブ化されたすべてのSDK、たとえば |
|
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください: