13장. FlowMetric 구성 매개변수


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

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

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

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

13.1.1. .metadata

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

13.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
필수 항목
  • metricName
  • type
속성유형설명

버킷

배열(문자열)

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

charts

array

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

방향

string

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

Divider

string

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

filters

array

필터 는 고려되는 흐름을 제한하는 데 사용되는 필드 및 값 목록입니다. 종종 이러한 필터를 사용하여 중복을 제거해야합니다. != "true"FlowDirection = "0". 사용 가능한 필드 목록에 대한 설명서를 참조하십시오. https://docs.openshift.com/container-platform/latest/observability/network_observability/json-flows-format-reference.html.

labels

배열(문자열)

labels 는 Prometheus 레이블로 사용해야 하는 필드 목록으로, 차원이라고도 합니다. 레이블 선택부터 이 메트릭의 단위 수준 및 쿼리 시 사용 가능한 집계가 생성됩니다. 지표 카디널리티에 영향을 미치므로 신중하게 수행해야 합니다(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.openshift.com/container-platform/latest/observability/network_observability/json-flows-format-reference.html.

metricName

string

메트릭의 이름입니다. Prometheus에서는 자동으로 "netobserv_" 접두사가 지정됩니다.

type

string

메트릭 유형: "Counter" 또는 "Histogram". 시간이 지남에 따라 증가하고 rates 또는 Packets와 같은 비율을 계산할 수 있는 모든 값에 "Counter"를 사용합니다. 대기 시간과 같이 독립적으로 샘플링해야하는 모든 값에 대해 "Histogram"을 사용하십시오.

valueField

string

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

13.1.3. .spec.charts

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

13.1.4. .spec.charts[]

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

dashboardName

string

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

queries

array

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

sectionName

string

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

title

string

차트의 이름입니다.

type

string

차트의 유형입니다.

단위

string

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

13.1.5. .spec.charts[].queries

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

13.1.6. .spec.charts[].queries[]

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

범례

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 차트 유형에는 적용되지 않습니다.

13.1.7. .spec.filters

설명
필터 는 고려되는 흐름을 제한하는 데 사용되는 필드 및 값 목록입니다. 종종 이러한 필터를 사용하여 중복을 제거해야합니다. != "true"FlowDirection = "0". 사용 가능한 필드 목록에 대한 설명서를 참조하십시오. https://docs.openshift.com/container-platform/latest/observability/network_observability/json-flows-format-reference.html.
유형
array

13.1.8. .spec.filters[]

설명
유형
object
필수 항목
  • field
  • matchType
속성유형설명

field

string

필터링할 필드의 이름

matchType

string

적용할 일치 유형

value

string

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

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

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

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

Red Hat 소개

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

© 2024 Red Hat, Inc.