Windows 用 Collector のアップグレード

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

・ンストーラースクリプトは、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}

Windows 用 Collector のアップグレード

Windows インストーラのスクリプトを使用した場合は、アップグレードのために GitHub から希望の Collector バージョンの MSI を手動でダウンロードして実行することができます。

Chocolatey

Chocolatey を使用している場合、アップグレード時にパラメータを維持するために、インストール前に以下の機能を有効にする必要があります。

choco feature enable -n=useRememberedArgumentsForUpgrades

アップグレードするには、PowerShellで以下のコマンドを実行します：

choco upgrade splunk-otel-collector