Linux 用 Collector のアップグレード

Splunk Distribution of OpenTelemetry Collector for Linux をアップグレードします。

・ンストーラースクリプトは、aptやyumなど、サポートされているパッケージ・マネージャーのいずれかを使用してCollectorをインストールします。

公式パッケージを使用して Collector を更新する場合、構成ファイルは上書きされません。更新後に構成を更新する必要がある場合は、後方互換性が失われる前に手動で編集します。

・ンストーラースクリプトは、aptやyumなど、サポートされているパッケージ・マネージャーのいずれかを使用してCollectorをインストールします。

公式パッケージを使用して Collector を更新する場合、構成ファイルは上書きされません。更新後に構成を更新する必要がある場合は、後方互換性が失われる前に手動で編集します。

一般的なガイドライン

特定のバージョンアップのために、Collector 構成ファイルに以下の変更を適用します。

0.96.1 から 0.97.0

memory_ballast は今後有効ではありません。SPLUNK_MEMORY_TOTAL_MIB 環境変数を使用して、ソフトメモリ制限でガベージコレクションを制御できるようになりました。この制限はデフォルトで総メモリの 90% に設定されています。詳細は「環境変数」を参照してください。

以下の手順に従って、Collector インスタンスが正しく動作することを確認してください：

  • memory_ballast をカスタマイズしていない場合は、設定から削除してください。

  • SPLUNK_BALLAST_SIZE_MIB (またはextensions::memory_ballast::size_mib config )を使用して memory_ballast をカスタマイズしている場合は、memory_ballast エクステンションを削除し、GOMEMLIMIT 環境変数を使用してカスタムソフトメモリ制限を設定します：

    • ガベージコレクションの頻度を上げるには、GOMEMLIMIT を、デフォルトである総メモリの90%より高い値に設定します。

    • ガベージコレクションの頻度を減らすには、GOMEMLIMIT を、デフォルトである総メモリの90%より低い値に設定します。

    • 詳細は「Go environment variables」を参照してください。

0.68.0 から 0.69.0

resourcedetection プロセッサの gke および gce リソースディテクタが gcp リソースディテクタに置き換えられました。 resourcedetection プロセッサに gke および gce ディテクタを構成した場合、その構成に応じて更新します。

詳しくは「リソース検出プロセッサ」を参照してください。

0.41.0 から 0.42.0

The Splunk Distribution of OpenTelemetry Collector は、ユーザー設定を 2 回評価していたため、不要な環境変数の展開を防ぐために各 $ 記号を $$ でエスケープする必要がありました。この問題は 0.42.0 バージョンで修正されました。設定に $$ が出現する場合は、$ に置き換える必要があります。

0.35.0 から 0.36.0

コンフィグパラメーター exporters -> otlp -> insecure を exporters -> otlp -> tls -> insecure に移動します。

otlp エクスポーターのコンフィギュレーションは次のようになっている必要があります：

exporters:
  otlp:
    endpoint: "${SPLUNK_GATEWAY_URL}:4317"
    tls:
      insecure: true

0.34.0 から 0.35.0

ballast_size_mib パラメータを memory_limiter プロセッサーから memory_ballast エクステンションに移動し、名前を size_mib に変更します。

extensions:
  memory_ballast:
    size_mib: ${SPLUNK_BALLAST_SIZE_MIB}

Linux 用 Collector のアップグレード

Collector をアップグレードするには、システムで以下のコマンドを実行します。実行には root 権限が必要です。

Debian

debian
sudo apt-get update
sudo apt-get install --only-upgrade splunk-otel-collector
注: /etc/otel/collector のデフォルト設定ファイルが最初のインストール後に変更された場合、既存のファイルを保持するか、新しいパッケージのファイルを上書きするかを尋ねるプロンプトが表示される可能性があります。

RPM

パッケージ・マネージャーには、yum、dnf、zypperがあります。

yum
sudo yum upgrade splunk-otel-collector
dnf
sudo dnf upgrade splunk-otel-collector
zypper
sudo zypper refresh
sudo zypper update splunk-otel-collector
注: /etc/otel/collector のデフォルト設定ファイルが初期インストール後に変更された場合、 既存のファイルは保持され、新しいパッケージのファイルは .rpmnew という拡張子でインストールできます。