メモリバラストエクステンション (非推奨)

はじめに

メモリバラストエクステンションにより、アプリケーションは処理のためにメモリバラストを設定することができます。

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

1. Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

   • インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

   • インストーラ・スクリプトを使用して Collector for Windows をインストールします。

   • Helmを使用してCollector for Kubernetesをインストールする

2. 次のセクションで説明するように、エクステンションを設定します。

3. Collector を再起動します。

サンプル構成

コンポーネントをアクティブにするには、設定ファイルのextensions セクションに memory_ballast を追加します：

extensions:
  memory_ballast:

設定を完了するには、設定ファイルの service セクションに拡張子を含めます：

service:
  extensions: [memory_ballast]

エクステンションには以下の設定が可能です：

• size_mibします。メモリバラストのサイズ（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 / 100

• memory.limit_in_bytes が 9223372036854771712 ( 0x7FFFFFFFFFFFF000 ) の場合、cgroup 内の Collector プロセスまたは実行中のコンテナにはメモリ制限が設定されておらず、ballast_size の値は次の式で計算されます。

  ballast_size = size_in_percentage * totalMemory / 100

  ここで totalMemory は、mem.VirtualMemory().total の github.com/shirou/gopsutil/v3/mem で計算されます。

設定

以下の表は、メモリバラスト拡張の設定オプションを示しています：

トラブルシューティング