18장. FlowMetric 구성 매개변수


FlowMetric API는 수집된 네트워크 흐름 로그에서 사용자 정의 관찰성 지표를 생성하는 데 사용됩니다.

18.1. FlowMetric [flows.netobserv.io/v1alpha1]

설명
FlowMetric은 수집된 흐름 로그에서 사용자 지정 지표를 생성할 수 있는 API입니다.
유형
object
재산유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

object

표준 객체의 메타데이터. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

FlowMetricSpec은 FlowMetric의 원하는 상태를 정의합니다. 제공된 API를 사용하면 이러한 지표를 사용자의 요구 사항에 맞게 사용자 정의할 수 있습니다.

새로운 지표를 추가하거나 기존 레이블을 수정할 때는 Prometheus 워크로드의 메모리 사용량을 주의 깊게 모니터링해야 합니다. 이는 잠재적으로 큰 영향을 미칠 수 있기 때문입니다. https://rhobs-handbook.netlify.app/products/openshiftmonitoring/telemetry.md/#what-is-the-cardinality-of-a-metric 참조

모든 네트워크 관찰성 지표의 기수를 확인하려면 promql : count({ name =~"netobserv.*"}) by ( name ) 을 실행합니다.

18.1.1. .metadata

설명
표준 객체의 메타데이터. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
유형
object

18.1.2. .spec

설명

FlowMetricSpec은 FlowMetric의 원하는 상태를 정의합니다. 제공된 API를 사용하면 이러한 지표를 사용자의 요구 사항에 맞게 사용자 정의할 수 있습니다.

새로운 지표를 추가하거나 기존 레이블을 수정할 때는 Prometheus 워크로드의 메모리 사용량을 주의 깊게 모니터링해야 합니다. 이는 잠재적으로 큰 영향을 미칠 수 있기 때문입니다. https://rhobs-handbook.netlify.app/products/openshiftmonitoring/telemetry.md/#what-is-the-cardinality-of-a-metric 참조

모든 네트워크 관찰성 지표의 기수를 확인하려면 promql : count({ name =~"netobserv.*"}) by ( name ) 을 실행합니다.

유형
object
필수 항목
  • type
재산유형설명

buckets

배열(문자열)

유형 이 "히스토그램"인 경우 사용할 버킷 목록입니다. 목록은 부동 소수점으로 구문 분석될 수 있어야 합니다. 설정하지 않으면 Prometheus 기본 버킷이 사용됩니다.

charts

array

대시보드 메뉴의 관리자 보기에서 OpenShift Container Platform Console에 대한 차트 구성입니다.

방향

string

유입, 유출 또는 모든 방향의 흐름을 필터링합니다. Ingress 로 설정하면 FlowDirection : 0|2 에 정규 표현식 필터를 추가하는 것과 같습니다. Egress 로 설정하면 FlowDirection 에 정규 표현식 필터를 추가하는 것과 같습니다: 1|2 .

divider

string

0이 아닌 경우 값의 스케일 인수(divider)입니다. 메트릭 값 = 흐름 값 / 분배기.

filters

array

필터는 어떤 흐름을 고려할지 제한하는 데 사용되는 필드와 값의 목록입니다. 사용 가능한 필드 목록은 다음 문서를 참조하세요: https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/network_observability/json-flows-format-reference .

단조롭게 하다

배열(문자열)

flatten은 Interfaces나 NetworkEvents와 같이 평면화되어야 하는 배열 유형 필드의 목록입니다. 평면화된 필드는 해당 필드의 항목당 하나의 메트릭을 생성합니다. 예를 들어, 바이트 카운터에서 인터페이스를 평면화할 때 인터페이스 [br-ex, ens5]가 있는 흐름은 br-ex 에 대한 카운터 하나를 증가시키고 ens5 에 대한 카운터 하나를 증가시킵니다.

help

string

Prometheus에 표시되는 지표의 도움말 텍스트입니다.

labels

배열(문자열)

레이블은 Prometheus 레이블로 사용해야 하는 필드 목록이며 차원이라고도 합니다(예: SrcK8S_Namespace ). 레이블을 선택하면 해당 메트릭의 세분성 수준과 쿼리 시점에 사용 가능한 집계가 결정됩니다. 이는 메트릭 기수에 영향을 미치므로 신중하게 수행해야 합니다( https://rhobs-handbook.netlify.app/products/openshiftmonitoring/telemetry.md/#what-is-the-cardinality-of-a-metric 참조). 일반적으로 IP나 MAC 주소와 같이 매우 높은 기수 레이블을 설정하지 마세요. 가능한 한 "SrcK8S_OwnerName" 또는 "DstK8S_OwnerName"이 "SrcK8S_Name" 또는 "DstK8S_Name"보다 우선시되어야 합니다. 사용 가능한 필드 목록은 다음 문서를 참조하세요: https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/network_observability/json-flows-format-reference .

metricName

string

지표의 이름입니다. Prometheus에서는 자동으로 "netobserv_"라는 접두사가 붙습니다. FlowMetric 리소스 이름을 기반으로 이름을 생성하려면 비워 두세요.

remap

객체(문자열)

생성된 메트릭 레이블에 흐름 필드와 다른 이름을 사용하려면 리맵 속성을 설정합니다. 원점 흐름 필드를 키로 사용하고, 원하는 레이블 이름을 값으로 사용합니다.

type

string

지표 유형: "카운터", "히스토그램" 또는 "게이지". 시간이 지남에 따라 증가하고 비율을 계산할 수 있는 값(예: 바이트 또는 패킷)에 대해 "카운터"를 사용합니다. 대기 시간과 같이 독립적으로 샘플링해야 하는 값에는 "히스토그램"을 사용합니다. 시간 경과에 따른 정확성이 필요하지 않은 다른 값에는 "게이지"를 사용합니다(게이지는 Prometheus가 메트릭을 가져올 때 N초마다 샘플링됩니다).

valueField

string

valueField 는 이 메트릭의 값으로 사용해야 하는 흐름 필드입니다(예: 바이트 ). 이 필드는 숫자 값을 가져야 합니다. 흐름당 특정 값을 지정하는 대신 흐름을 계산하려면 비워 두세요. 사용 가능한 필드 목록은 다음 문서를 참조하세요: https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/network_observability/json-flows-format-reference .

18.1.3. .spec.charts

설명
대시보드 메뉴의 관리자 보기에서 OpenShift Container Platform Console에 대한 차트 구성입니다.
유형
array

18.1.4. .spec.charts[]

설명
메트릭과 관련된 차트/대시보드 생성을 구성합니다.
유형
object
필수 항목
  • dashboardName
  • queries
  • title
  • type
재산유형설명

dashboardName

string

포함된 대시보드의 이름입니다. 이 이름이 기존 대시보드를 참조하지 않으면 새 대시보드가 생성됩니다.

queries

array

이 차트에 표시할 쿼리 목록입니다. 유형 이 SingleStat 이고 여러 개의 쿼리가 제공되는 경우, 이 차트는 자동으로 여러 패널(쿼리당 하나)로 확장됩니다.

sectionName

string

포함된 대시보드 섹션의 이름입니다. 이 이름이 기존 섹션을 참조하지 않으면 새 섹션이 생성됩니다. sectionName 이 생략되거나 비어 있으면 차트는 글로벌 상단 섹션에 배치됩니다.

title

string

차트의 제목.

type

string

차트의 유형.

단위

string

이 차트의 단위입니다. 현재 지원되는 유닛은 일부에 불과합니다. 일반 번호를 사용하려면 비워 두세요.

18.1.5. .spec.charts[].queries

설명
이 차트에 표시할 쿼리 목록입니다. 유형 이 SingleStat 이고 여러 개의 쿼리가 제공되는 경우, 이 차트는 자동으로 여러 패널(쿼리당 하나)로 확장됩니다.
유형
array

18.1.6. .spec.charts[].queries[]

설명
PromQL 쿼리를 구성합니다.
유형
object
필수 항목
  • 전설
  • promQL
  • top
재산유형설명

전설

string

이 차트에 표현된 각 시계열에 적용되는 쿼리 범례입니다. 여러 시계열이 표시되는 경우 각 시계열을 구별하는 범례를 설정해야 합니다. 다음 형식으로 수행할 수 있습니다: {{ Label }} . 예를 들어, promQL 이 sum(rate($METRIC[2m])) by (Label1, Label2) 와 같이 레이블별로 시계열을 그룹화하는 경우 범례를 다음과 같이 작성할 수 있습니다. Label1={{ Label1 }}, Label2={{ Label2 }} .

promQL

string

Prometheus에 대해 실행할 promQL 쿼리입니다. 차트 유형 이 SingleStat 인 경우 이 쿼리는 단일 시계열만 반환해야 합니다. 다른 유형의 경우 상위 7개가 표시됩니다. $METRIC을 사용하면 이 리소스에 정의된 메트릭을 참조할 수 있습니다. 예를 들어: sum(rate($METRIC[2m])) . promQL 에 대해 자세히 알아보려면 Prometheus 설명서를 참조하세요: https://prometheus.io/docs/prometheus/latest/querying/basics/

top

integer

타임스탬프별로 표시할 상위 N개 시리즈입니다. SingleStat 차트 유형에는 적용되지 않습니다.

18.1.7. .spec.filters

설명
필터는 어떤 흐름을 고려할지 제한하는 데 사용되는 필드와 값의 목록입니다. 사용 가능한 필드 목록은 다음 문서를 참조하세요: https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/network_observability/json-flows-format-reference .
유형
array

18.1.8. .spec.filters[]

설명
유형
object
필수 항목
  • field
  • matchType
재산유형설명

field

string

필터링할 필드의 이름(예: SrcK8S_Namespace )

matchType

string

적용할 매칭 유형

value

string

필터링할 값입니다. matchType 이 Equal 또는 NotEqual 인 경우 $(SomeField) 를 사용하여 필드 주입을 사용하여 흐름의 다른 필드를 참조할 수 있습니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동