Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector コンポーネント » Collectorコンポーネント: エクステンション » メモリバラストエクステンション (非推奨)

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

注意

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

はじめに 🔗

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

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

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

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

  2. 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_bytes9223372036854771712 ( 0x7FFFFFFFFFFFF000 ) 以外の正の値の場合、ballast_size の値は以下の式で計算されます。

    ballast_size = size_in_percentage * memory.limit_in_bytes / 100

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

    ballast_size = size_in_percentage * totalMemory / 100

    ここで totalMemorygithub.com/shirou/gopsutil/v3/mem mem.VirtualMemory().total で計算されます。

設定 🔗

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

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。

このページは 2024年12月12日 に最終更新されました。