メモリバラストエクステンション (非推奨) 🔗
注意
memory_ballast
エクステンションは非推奨となり、Collector バージョン 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 環境変数 を参照してください。
はじめに 🔗
メモリバラストエクステンションにより、アプリケーションは処理のためにメモリバラストを設定することができます。
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:
Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします:
次のセクションで説明するように、エクステンションを設定します。
Collector を再起動します。
サンプル構成 🔗
コンポーネントをアクティブにするには、設定ファイルの extensions
セクションに memory_ballast
を追加します:
extensions:
memory_ballast:
設定を完了するには、設定ファイルの service
セクションに拡張子を含めます:
service:
extensions: [memory_ballast]
エクステンションには以下の設定が可能です:
size_mib
. メモリバラストのサイズ。デフォルトでは
0
です。両方を同時に指定した場合は、
size_in_percentage
より優先されます。
size_in_percentage
. 総メモリ量に対するメモリバラストをパーセントで設定します。デフォルトでは
0
です。値の範囲は1から100までになります。
コンテナ環境(Docker、Kubernetes)と物理ホスト環境の両方でサポート。
設定例 🔗
この構成では、バラストに64Mibのメモリを使用します:
extensions:
memory_ballast:
size_mib: 64
この構成では、バラストに総メモリの20%を使用します:
extensions:
memory_ballast:
size_in_percentage: 20
バラストのサイズをパーセンテージで計算する 🔗
size_in_percentage
が有効な場合、ballast_size
の値は以下のように計算されます。
ターゲットホストまたはコンテナで、memory.limit_in_bytes
の値を確認して、実行中の Collector プロセスにメモリ制限があるかどうかを確認します。メモリファイルは、/sys/fs/cgroup/memory/memory.limit_in_bytesなどのパスに格納されます。
memory.limit_in_bytes
が9223372036854771712
(0x7FFFFFFFFFFFF000
) 以外の正の値の場合、ballast_size
の値は以下の式で計算されます。ballast_size
=size_in_percentage
*memory.limit_in_bytes
/ 100memory.limit_in_bytes
が9223372036854771712
(0x7FFFFFFFFFFFF000
) の場合、cgroup 内の Collector プロセスまたは実行中のコンテナにはメモリ制限が設定されておらず、ballast_size
の値は次の式で計算されます。ballast_size
=size_in_percentage
*totalMemory
/ 100ここで
totalMemory
は github.com/shirou/gopsutil/v3/memmem.VirtualMemory().total
で計算されます。
設定 🔗
以下の表は、メモリバラスト拡張の設定オプションを示しています:
トラブルシューティング 🔗
Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。
Splunk Observability Cloudをご利用のお客様
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。