18장. FlowMetric 구성 매개변수


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

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

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

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은 원하는 FlowMetricSpec을 정의합니다. 제공된 API를 사용하면 필요에 따라 이러한 메트릭을 사용자 지정할 수 있습니다.

새 메트릭을 추가하거나 기존 레이블을 수정할 때 심각한 영향을 미칠 수 있으므로 Prometheus 워크로드의 메모리 사용량을 신중하게 모니터링해야 합니다. CF https://rhobs-handbook.netlify.app/products/openshiftmonitoring/telemetry.md/#what-is-the-cardinality-of-a-metric

모든 네트워크 관찰 기능 메트릭의 카디널리티를 확인하려면 promql:count({name=~"netobserv.*"})로 (이름) 로 실행합니다.

18.1.1. .metadata

설명
표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
유형
object

18.1.2. .spec

설명

FlowMetricSpec은 원하는 FlowMetricSpec을 정의합니다. 제공된 API를 사용하면 필요에 따라 이러한 메트릭을 사용자 지정할 수 있습니다.

새 메트릭을 추가하거나 기존 레이블을 수정할 때 심각한 영향을 미칠 수 있으므로 Prometheus 워크로드의 메모리 사용량을 신중하게 모니터링해야 합니다. CF https://rhobs-handbook.netlify.app/products/openshiftmonitoring/telemetry.md/#what-is-the-cardinality-of-a-metric

모든 네트워크 관찰 기능 메트릭의 카디널리티를 확인하려면 promql:count({name=~"netobserv.*"})로 (이름) 로 실행합니다.

유형
object
필수 항목
  • type
Expand
속성유형설명

버킷

배열(문자열)

유형이 "Histogram"일 때 사용할 버킷 목록입니다. 목록은 플릿으로 패리팅할 수 있어야 합니다. 설정하지 않으면 Prometheus 기본 버킷이 사용됩니다.

charts

array

관리자 보기, Dashboards 메뉴의 OpenShift Container Platform 콘솔의 차트 구성입니다.

direction

string

수신, 송신 또는 방향 흐름에 대해 필터링합니다. Ingress 로 설정하면 FlowDirection:0|2 에서 정규식 필터를 추가하는 것과 동일합니다. Egress 로 설정하면 FlowDirection:1|2 에서 정규식 필터를 추가하는 것과 동일합니다.

divider

string

0이 아닌 경우 값의 스케일 인수(divider)입니다. metric value = Flow value / Divider.

filters

array

필터 는 고려되는 흐름을 제한하는 데 사용되는 필드 및 값 목록입니다. 사용 가능한 필드 목록에 대한 설명서를 참조하십시오. https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/network_observability/json-flows-format-reference.

flatten

배열(문자열)

flatten 은 Interfaces 또는 NetworkEvents와 같이 병합되어야 하는 배열 유형 필드 목록입니다. 병합된 필드는 해당 필드에서 항목당 하나의 메트릭을 생성합니다. 예를 들어, 바이트 카운터의 인터페이스를 병합할 때 Interfaces [br-ex, ens5]를 갖는 흐름은 br-exens5 에 대한 카운터를 늘립니다.

help

string

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

labels

배열(문자열)

labels 는 Prometheus 레이블로 사용해야 하는 필드 목록입니다(예: SrcK8S_Namespace). 레이블 선택부터 이 메트릭의 단위 수준 및 쿼리 시 사용 가능한 집계가 생성됩니다. 지표 카디널리티에 영향을 미치므로 신중하게 수행해야 합니다(cf 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

오브젝트(문자열)

생성된 지표 라벨에 흐름 필드와 다른 이름을 사용하도록 remap 속성을 설정합니다. 원본 흐름 필드를 키로 사용하고 원하는 라벨 이름을 값으로 사용합니다.

type

string

메트릭 유형: "Counter", "Histogram" 또는 "Gauge". 시간이 지남에 따라 증가하고 rates 또는 Packets와 같은 비율을 계산할 수 있는 모든 값에 "Counter"를 사용합니다. 대기 시간과 같이 독립적으로 샘플링해야하는 모든 값에 대해 "Histogram"을 사용하십시오. 시간이 지남에 따라 정확도가 필요하지 않은 다른 값에는 "Gauge"를 사용합니다. (가그들은 Prometheus가 메트릭을 가져올 때 N초마다 샘플링됩니다).

valueField

string

valueField 는 이 메트릭의 값으로 사용해야 하는 flow 필드입니다(예: Cryostats ). 이 필드에는 숫자 값이 있어야 합니다. 흐름당 특정 값이 아닌 흐름을 계산하도록 비워 둡니다. 사용 가능한 필드 목록에 대한 설명서를 참조하십시오. https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/network_observability/json-flows-format-reference.

18.1.3. .spec.charts

설명
관리자 보기, Dashboards 메뉴의 OpenShift Container Platform 콘솔의 차트 구성입니다.
유형
array

18.1.4. .spec.charts[]

설명
메트릭에 연결된 차트 / 대시보드 생성 구성
유형
object
필수 항목
  • dashboardName
  • queries
  • title
  • type
Expand
속성유형설명

dashboardName

string

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

queries

array

이 차트에 표시할 쿼리 목록입니다. typeSingleStat 이고 여러 쿼리가 제공되면 이 차트는 여러 패널(쿼리당 하나씩)에서 자동으로 확장됩니다.

sectionName

string

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

title

string

차트의 이름입니다.

type

string

차트의 유형입니다.

단위

string

이 차트의 단위입니다. 현재 몇 개의 유닛만 지원됩니다. 일반 번호를 사용하려면 비워 둡니다.

18.1.5. .spec.charts[].queries

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

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

설명
PromQL 쿼리 구성
유형
object
필수 항목
  • legend
  • promQL
  • top
Expand
속성유형설명

legend

string

이 차트에 표시되는 각 시계열에 적용되는 쿼리 범례입니다. 여러 시계열이 표시되면 각각을 구분하는 범례를 설정해야 합니다. {{ Label }} 형식으로 수행할 수 있습니다. 예를 들어 promQL 그룹이 ( Label1, Label2)의 sum(rate(rate($METRIC[2m]))과 같은 레이블당 시계열을 그룹하는 경우 Label 1={{ 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
Expand
속성유형설명

field

string

필터링할 필드의 이름입니다(예: SrcK8S_Namespace).

matchType

string

적용할 일치 유형

value

string

필터링할 값입니다. matchTypeEqual 또는 NotEqual 인 경우 $(SomeField) 와 함께 필드 삽입을 사용하여 흐름의 다른 필드를 참조할 수 있습니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동