Upgrade the Collector for Kubernetes and other updates 🔗

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

Collector for Kubernetes のアップグレード 🔗

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

フラグ --reuse-values を使用して、Collector のインストール時または使用時に設定した設定値を保持します：

helm upgrade splunk-otel-collector splunk-otel-collector-chart/splunk-otel-collector
--reuse-values

アップグレード中に以前の設定を上書きするには、--values config.yaml を使用します：

helm upgrade splunk-otel-collector --values config.yaml splunk-otel-collector-chart/splunk-otel-collector --reuse-values

詳しくは Helm の公式アップグレードオプションのドキュメント https://helm.sh/docs/helm/helm_upgrade/#options を参照してください。

Update the access token for the Collector for Kubernetes 🔗

注釈

Make sure you don’t update your Helm chart or Collector version in the process of updating your access token. See Step 3 for details.

To update the access token for your Collector for Kubernetes instance follow these steps:

Confirm the Helm release name and chart version. To do so, run:

helm list -f <Release_Name>

Optionally, you can check your current access token:

helm get values <Release_Name>

Deploy your new access token with Helm upgrade. This command will only update your access token, but will mantain your current Helm chart and Collector versions.

helm upgrade --reuse-values --version <Current_Chart_Version> --set splunkObservability.accessToken=<New_Access_Token> <Release_Name> splunk-otel-collector-chart/splunk-otel-collector
If you want to use the latest Helm version instead of your current one, remove '--version <Current_Chart_Version>' from the command.

Verify the value of the updated access token:

helm get values <Release_Name>

Restart the Collector’s daemonset and deployments:

If agent.enabled=true, restart the Collector’s agent daemonset:
kubectl rollout restart daemonset <Release_Name>-agent
If clusterReceiver.enabled=true, restart the Collector’s cluster receiver deployment:
kubectl rollout restart deployment <Release_Name>-k8s-cluster-receiver
If gateway.enabled=true, restart the Collector’s gateway deployment:
kubectl rollout restart deployment <Release_Name>

Verify the status of your clusters』 pods:

kubectl get pod -n <Namespace> | grep <Release_Name>

This page was last updated on 2024年05月13日.

Related Topics