Linux 用 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 環境変数を参照してください。

0.68.0 から 0.69.0 🔗

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

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

0.41.0 から 0.42.0 🔗

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}