34.8. FlowCollector 設定パラメーター

cacheActiveTimeout

string

cacheActiveTimeout は、レポーターが送信前にフローを集約する最大期間です。cacheMaxFlows と cacheActiveTimeout を増やすと、ネットワークトラフィックのオーバーヘッドと CPU 負荷を減らすことができますが、メモリー消費量が増え、フローコレクションのレイテンシーが増加することが予想されます。

cacheMaxFlows

integer

cacheMaxFlows は、集約内のフローの最大数です。到達すると、レポーターはフローを送信します。cacheMaxFlows と cacheActiveTimeout を増やすと、ネットワークトラフィックのオーバーヘッドと CPU 負荷を減らすことができますが、メモリー消費量が増え、フローコレクションのレイテンシーが増加することが予想されます。

debug

object

デバッグでは、eBPF エージェントの内部設定のいくつかの側面を設定できます。このセクションは、デバッグと、GOGC や GOMAXPROCS 環境変数などのきめ細かいパフォーマンスの最適化のみを目的としています。その値を設定するユーザーは、自己責任で行ってください。

excludeInterfaces

array (string)

excludeInterfaces には、フロートレースから除外されるインターフェイス名が含まれています。エントリーが /br-/ のようにスラッシュで囲まれている場合は、正規表現として一致します。それ以外の場合は、大文字と小文字を区別する文字列として一致します。

imagePullPolicy

string

imagePullPolicy は、上で定義したイメージの Kubernetes プルポリシーです。

interfaces

array (string)

インターフェイスには、フローが収集されるインターフェイス名が含まれます。空の場合、エージェントは ExcludeInterfaces にリストされているものを除いて、システム内のすべてのインターフェイスをフェッチします。エントリーが /br-/ のようにスラッシュで囲まれている場合は、正規表現として一致します。それ以外の場合は、大文字と小文字を区別する文字列として一致します。

kafkaBatchSize

integer

kafkaBatchSize は、パーティションに送信される前のリクエストの最大サイズをバイト単位で制限します。Kafka を使用しない場合は無視されます。デフォルト: 10MB。

logLevel

string

logLevel は、NetObserv eBPF エージェントのログレベルを定義します。

privileged

boolean

eBPF Agent コンテナーの特権モード。一般に、この設定は無視するか、false に設定できます。その場合、オペレーターはコンテナーに詳細な機能 (BPF、PERFMON、NET_ADMIN、SYS_RESOURCE) を設定して、正しい操作を有効にします。CAP_BPF を認識しない古いカーネルバージョンが使用されている場合など、何らかの理由でこれらの機能を設定できない場合は、このモードをオンにして、より多くのグローバル権限を取得できます。

resources

object

resources は、このコンテナーが必要とするコンピューティングリソースです。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

sampling

integer

フローレポーターのサンプリングレート。100 は、100 の 1 つのフローが送信されることを意味します。0 または 1 は、すべてのフローがサンプリングされることを意味します。

env

object (string)

env を使用すると、カスタム環境変数を NetObserv Agent に渡すことができます。GOGC、GOMAXPROCS など、いくつかの非常に具体的なパフォーマンスチューニングオプションを渡すのに役立ちます。これらは、エッジデバッグまたはサポートシナリオでのみ役立つため、FlowCollector 記述子の一部として公開されるべきではありません。

limits

integer-or-string

制限は、許容されるコンピュートリソースの最大量を記述します。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

requests

integer-or-string

要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

cacheActiveTimeout

string

cacheActiveTimeout は、レポーターが送信前にフローを集約する最大期間です。

cacheMaxFlows

integer

cacheMaxFlows は、集約内のフローの最大数です。到達すると、レポーターはフローを送信します。

clusterNetworkOperator

object

clusterNetworkOperator は、利用可能な場合、OpenShift Container Platform Cluster Network Operator に関連する設定を定義します。

forceSampleAll

boolean

forceSampleAll を使用すると、IPFIX ベースのフローレポーターでのサンプリングを無効にできます。クラスターが不安定になる可能性があるため、IPFIX を使用してすべてのトラフィックをサンプリングすることはお勧めしません。本当にそうしたい場合は、このフラグを true に設定してください。自己責任でお使いください。true に設定すると、"sampling" の値は無視されます。

ovnKubernetes

object

ovnKubernetes は、利用可能な場合、OVN-Kubernetes CNI の設定を定義します。この設定は、OpenShift Container Platform なしで OVN の IPFIX エクスポートを使用する場合に使用されます。OpenShift Container Platform を使用する場合は、代わりに clusterNetworkOperator プロパティーを参照してください。

sampling

integer

サンプリングは、レポーターのサンプリングレートです。100 は、100 の 1 つのフローが送信されることを意味します。クラスターの安定性を確保するために、2 未満の値を設定することはできません。クラスターの安定性に影響を与える可能性があるすべてのパケットを本当にサンプリングしたい場合は、forceSampleAll を参照してください。または、IPFIX の代わりに eBPF エージェントを使用できます。

namespace

string

ConfigMap がデプロイされる namespace。

containerName

string

containerName は、IPFIX 用に設定するコンテナーの名前を定義します。

daemonSetName

string

daemonSetName は、OVN-Kubernetes Pod を制御する DaemonSet の名前を定義します。

namespace

string

OVN-Kubernetes Pod がデプロイされる namespace。

enable

boolean

コンソールプラグインのポートからサービス名への変換を有効にします

portNames

object (string)

portNames は、コンソールで使用する追加のポート名を定義します (例: portNames: {"3100": "loki"})。

default

boolean

デフォルトで、このフィルターをデフォルトで有効にするかどうかを定義します。

filter

object (string)

filter は、このフィルターが選択されたときに設定されるキーと値のセットです。各キーは、コンマ区切りの文字列を使用して値のリストに関連付けることができます (例: {"src_namespace": "namespace1,namespace2"})。

name

string

コンソールに表示されるフィルターの名前

limits

integer-or-string

制限は、許容されるコンピュートリソースの最大量を記述します。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

requests

integer-or-string

要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

kafka

object

kafka は、強化されたフローを送信するための kafka 設定 (アドレス、トピックなど) を記述します。

type

string

type は、エクスポーターのタイプを選択します。現時点では "KAFKA" のみ利用可能です。

address

string

Kafka サーバーのアドレス

tls

object

tls クライアント設定。TLS を使用する場合は、アドレスが TLS に使用される Kafka ポート (通常は 9093) と一致することを確認します。eBPF エージェントを使用する場合は、Kafka 証明書をエージェント namespace にコピーする必要があることに注意してください (デフォルトでは netobserv 特権です)。

topic

string

使用する kafka トピック。存在する必要があり、NetObserv はそれを作成しません。

cacert

object

caCert は、認証局の証明書の参照を定義します。

enable

boolean

TLS を有効にします。

insecureSkipVerify

boolean

insecureSkipVerify を使用すると、サーバー証明書のクライアント側の検証をスキップできます。true に設定すると、CACert フィールドは無視されます

userCert

object

userCert は、mTLS に使用されるユーザー証明書参照を定義します (通常の一方向 TLS を使用する場合は無視できます)。

certFile

string

certFile は、config map/シークレット内の証明書ファイル名へのパスを定義します

certKey

string

certKey は、config map/シークレット内の証明書秘密鍵ファイル名へのパスを定義します。キーが不要な場合は省略します。

name

string

証明書を含む config map またはシークレットの名前

type

string

証明書参照のタイプ: config mapまたはシークレット

certFile

string

certFile は、config map/シークレット内の証明書ファイル名へのパスを定義します

certKey

string

certKey は、config map/シークレット内の証明書秘密鍵ファイル名へのパスを定義します。キーが不要な場合は省略します。

name

string

証明書を含む config map またはシークレットの名前

type

string

証明書参照のタイプ: config mapまたはシークレット

cacert

object

caCert は、認証局の証明書の参照を定義します。

enable

boolean

TLS を有効にします。

insecureSkipVerify

boolean

insecureSkipVerify を使用すると、サーバー証明書のクライアント側の検証をスキップできます。true に設定すると、CACert フィールドは無視されます

userCert

object

userCert は、mTLS に使用されるユーザー証明書参照を定義します (通常の一方向 TLS を使用する場合は無視できます)。

certFile

string

certFile は、config map/シークレット内の証明書ファイル名へのパスを定義します

certKey

string

certKey は、config map/シークレット内の証明書秘密鍵ファイル名へのパスを定義します。キーが不要な場合は省略します。

name

string

証明書を含む config map またはシークレットの名前

type

string

証明書参照のタイプ: config mapまたはシークレット

certFile

string

certFile は、config map/シークレット内の証明書ファイル名へのパスを定義します

certKey

string

certKey は、config map/シークレット内の証明書秘密鍵ファイル名へのパスを定義します。キーが不要な場合は省略します。

name

string

証明書を含む config map またはシークレットの名前

type

string

証明書参照のタイプ: config mapまたはシークレット

cacert

object

caCert は、認証局の証明書の参照を定義します。

enable

boolean

TLS を有効にします。

insecureSkipVerify

boolean

insecureSkipVerify を使用すると、サーバー証明書のクライアント側の検証をスキップできます。true に設定すると、CACert フィールドは無視されます

userCert

object

userCert は、mTLS に使用されるユーザー証明書参照を定義します (通常の一方向 TLS を使用する場合は無視できます)。

certFile

string

certFile は、config map/シークレット内の証明書ファイル名へのパスを定義します

certKey

string

certKey は、config map/シークレット内の証明書秘密鍵ファイル名へのパスを定義します。キーが不要な場合は省略します。

name

string

証明書を含む config map またはシークレットの名前

type

string

証明書参照のタイプ: config mapまたはシークレット

certFile

string

certFile は、config map/シークレット内の証明書ファイル名へのパスを定義します

certKey

string

certKey は、config map/シークレット内の証明書秘密鍵ファイル名へのパスを定義します。キーが不要な場合は省略します。

name

string

証明書を含む config map またはシークレットの名前

type

string

証明書参照のタイプ: config mapまたはシークレット

env

object (string)

env を使用すると、カスタム環境変数を NetObserv Agent に渡すことができます。GOGC や GOMAXPROCS などの非常に具体的なパフォーマンスチューニングオプションを渡すのに役立ちます。これらは、エッジデバッグおよびサポートシナリオでのみ有用であるため、FlowCollector 記述子の一部として公開すべきではありません。

disableAlerts

array (string)

disableAlerts は、無効にする必要があるアラートのリストです。可能な値は次のとおりです: NetObservNoFlows。これは、一定期間フローが観察されなかった場合にトリガーされます。NetObservLokiError: Loki エラーが原因でフローがドロップされるとトリガーされます。

ignoreTags

array (string)

ignoreTags は、無視するメトリックを指定するタグのリストです

server

object

Prometheus スクレイパーの metricsServer エンドポイント設定

port

integer

プロメテウス HTTP ポート

tls

object

TLS 設定。

provided

object

TLS 設定。

type

string

エンドポイントに TLS を設定しない場合は "DISABLED" (デフォルト)、証明書ファイルとキーファイルを手動で提供する場合は "PROVIDED"、注釈を使用して OpenShift Container Platform の自動生成された証明書を使用する場合は AUTO を選択します。

certFile

string

certFile は、config map/シークレット内の証明書ファイル名へのパスを定義します

certKey

string

certKey は、config map/シークレット内の証明書秘密鍵ファイル名へのパスを定義します。キーが不要な場合は省略します。

name

string

証明書を含む config map またはシークレットの名前

type

string

証明書参照のタイプ: config mapまたはシークレット

limits

integer-or-string

制限は、許容されるコンピュートリソースの最大量を記述します。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

requests

integer-or-string

要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。これは空の文字列である可能性があります。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].gitopsdGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドは空ではない可能性があります。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

CamelCase または foo.example.com/CamelCase の条件のタイプ。--- 多くの.condition.type 値は、Available などのリソース全体で一貫していますが、任意の条件が役立つ可能性があるため (.node.status.conditions を参照)、徐々に縮小する機能が重要です。一致する正規表現は (dns1123SubdomainFmt/)?(qualifiedNameFmt) です。