第14章 FlowMetric 設定パラメーター
FlowMetric
は、収集されたフローログからカスタムメトリクスを作成することを可能にする API です。
14.1. FlowMetric [flows.netobserv.io/v1alpha1]
- 説明
- FlowMetric は、収集されたフローログからカスタムメトリクスを作成することを可能にする API です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーは、クライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
|
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 |
|
|
FlowMetricSpec は、FlowMetric の目的の状態を定義します。提供されている API を使用すると、ニーズに応じてこれらのメトリクスをカスタマイズできます。
新しいメトリクスを追加したり、既存のラベルを変更したりする場合は、大きな影響を与える可能性があります。そのため、Prometheus ワークロードのメモリー使用量を注意深く監視する必要があります。https://rhobs-handbook.netlify.app/products/openshiftmonitoring/telemetry.md/#what-is-the-cardinality-of-a-metric
すべての Network Observability メトリクスのカーディナリティーを確認するには、 |
14.1.1. .metadata
- 説明
- 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。
- 型
-
object
14.1.2. .spec
- 説明
FlowMetricSpec は、FlowMetric の目的の状態を定義します。提供されている API を使用すると、ニーズに応じてこれらのメトリクスをカスタマイズできます。
新しいメトリクスを追加したり、既存のラベルを変更したりする場合は、大きな影響を与える可能性があります。そのため、Prometheus ワークロードのメモリー使用量を注意深く監視する必要があります。https://rhobs-handbook.netlify.app/products/openshiftmonitoring/telemetry.md/#what-is-the-cardinality-of-a-metric
を参照してください。すべての Network Observability メトリクスのカーディナリティーを確認するには、
promql
:count({name=~"netobserv.*"}) by (name)
を実行します。- 型
-
object
- 必須
-
metricName
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
|
|
|
| 管理者ビューの Dashboards メニューにある OpenShift Container Platform コンソールのチャート設定。 |
|
|
Ingress、Egress、または任意の方向のフローをフィルタリングします。 |
|
| ゼロ以外の場合、値の換算係数 (除数)。メトリクス値 = フロー値/除数。 |
|
|
|
|
|
|
|
| メトリクスの名前。Prometheus では、自動的に "netobserv_" という接頭辞が付けられます。 |
|
|
生成されるメトリクスラベルにフローフィールドとは異なる名前を使用するには、 |
|
| メトリクスタイプ ("Counter" または "Histogram")。"Counter" は、バイト数やパケット数など、時間の経過とともに増加し、レートを計算できる値に使用します。"Histogram" は、遅延など、個別にサンプリングする必要がある値に使用します。 |
|
|
|
14.1.3. .spec.charts
- 説明
- 管理者ビューの Dashboards メニューにある OpenShift Container Platform コンソールのチャート設定。
- 型
-
array
14.1.4. .spec.charts[]
- 説明
- メトリクスに関連するグラフ/ダッシュボード生成を設定します。
- 型
-
object
- 必須
-
dashboardName
-
queries
-
title
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 配置先のダッシュボードの名前。この名前が既存のダッシュボードを示すものでない場合は、新しいダッシュボードが作成されます。 |
|
|
このグラフに表示するクエリーのリスト。 |
|
|
配置先のダッシュボードセクションの名前。この名前が既存のセクションを示すものでない場合は、新しいセクションが作成されます。 |
|
| グラフのタイトル。 |
|
| グラフの種類。 |
|
| このグラフの単位。現在サポートされている単位はごく少数です。一般的な数字を使用する場合は空白のままにします。 |
14.1.5. .spec.charts[].queries
- 説明
-
このグラフに表示するクエリーのリスト。
type
がSingleStat
で、複数のクエリーが指定されている場合、このグラフは複数のパネル (クエリーごとに 1 つ) に自動的に展開されます。 - 型
-
array
14.1.6. .spec.charts[].queries[]
- 説明
- PromQL クエリーを設定します。
- 型
-
object
- 必須
-
legend
-
promQL
-
top
-
プロパティー | 型 | 説明 |
---|---|---|
|
|
このグラフに表示する各時系列に適用するクエリーの凡例。複数の時系列を表示する場合は、それぞれを区別する凡例を設定する必要があります。これは |
|
|
Prometheus に対して実行する |
|
|
タイムスタンプごとに表示する上位 N 個の系列。 |
14.1.7. .spec.filters
- 説明
-
filters
は、考慮されるフローを制限するために使用するフィールドと値のリストです。多くの場合、重複を排除するために、Duplicate != "true"
およびFlowDirection = "0"
というフィルターを使用する必要があります。使用可能なフィールドのリストについては、ドキュメント https://docs.openshift.com/container-platform/latest/observability/network_observability/json-flows-format-reference.html を参照してください。 - 型
-
array
14.1.8. .spec.filters[]
- 説明
- 型
-
object
- 必須
-
field
-
matchType
-
プロパティー | 型 | 説明 |
---|---|---|
|
| フィルタリングするフィールドの名前 |
|
| 適用するマッチングのタイプ |
|
|
フィルタリングする値。 |