3.2. 속성 매핑

Loki Operator를 openshift-logging 모드로 설정하면 Loki Operator가 기본 속성 매핑 세트를 자동으로 적용합니다. 이러한 매핑은 특정 OTLP 속성을 스트림 레이블 및 Loki의 구조화된 메타데이터와 정렬합니다.

일반적인 설정의 경우 이러한 기본 매핑만으로도 충분합니다. 그러나 다음과 같은 경우 속성 매핑을 사용자 지정해야 할 수 있습니다.

사용자 지정 수집기 사용: 설정에 저장하지 않으려는 추가 속성을 생성하는 사용자 지정 수집기가 포함된 경우 매핑을 사용자 지정하여 Loki에서 해당 속성을 삭제하도록 하는 것이 좋습니다.
특성 세부 정보 수준 조정: 기본 특성 세트가 필요 이상으로 자세히 설명하는 경우 필수 속성으로만 줄일 수 있습니다. 이로 인해 과도한 데이터 스토리지를 방지하고 로깅 프로세스를 간소화할 수 있습니다.

3.2.1. OpenShift의 사용자 정의 속성 매핑
링크 복사

openshift-logging 모드에서 Loki Operator를 사용하는 경우 속성 매핑은 OpenShift 기본값을 따르지만 기본값을 조정하도록 사용자 정의 매핑을 구성할 수 있습니다. openshift-logging 모드에서는 모든 테넌트 또는 필요에 따라 개별 테넌트에 대해 사용자 정의 속성 매핑을 전역적으로 구성할 수 있습니다. 사용자 지정 매핑을 정의할 때 OpenShift 기본값에 추가됩니다. 기본 레이블이 필요하지 않은 경우 테넌트 구성에서 해당 레이블을 비활성화할 수 있습니다.

참고

Loki Operator와 Loki의 주요 차이점은 상속 처리입니다. Loki는 default_resource_attributes_as_index_labels 만 기본적으로 테넌트에 복사하는 반면 Loki Operator는 openshift-logging 모드의 각 테넌트에 전체 글로벌 구성을 적용합니다.

LokiStack 내에서 속성 매핑 구성은 limits 설정을 통해 관리됩니다. 다음 예제 LokiStack 구성을 참조하십시오.

# ...
spec:
  limits:
    global:
      otlp: {} 
    tenants:
      application:
        otlp: {}

# ...
spec:
  limits:
    global:
      otlp: {}


    tenants:
      application:
        otlp: {}

Copy to Clipboard

Toggle word wrap

1: 글로벌 OTLP 특성 구성을 정의합니다.
2: openshift-logging 모드 내에서 애플리케이션 테넌트에 대한 OTLP 속성 구성을 정의합니다. 애플리케이션 테넌트 외에도 인프라 및 감사 테넌트를 구성할 수도 있습니다.

참고

특성을 스트림 레이블에 매핑하는 데 글로벌 및 테넌트별 OTLP 구성을 모두 사용할 수 있습니다.

스트림 레이블은 LokiStack 리소스 구조가 반영하는 리소스 수준 속성에서만 파생됩니다. 다음 LokiStack 예제 구성을 참조하십시오.

spec:
  limits:
    global:
      otlp:
        streamLabels:
          resourceAttributes:
          - name: "k8s.namespace.name"
          - name: "k8s.pod.name"
          - name: "k8s.container.name"

spec:
  limits:
    global:
      otlp:
        streamLabels:
          resourceAttributes:
          - name: "k8s.namespace.name"
          - name: "k8s.pod.name"
          - name: "k8s.container.name"

Copy to Clipboard

Toggle word wrap

로그 항목에서 리소스, 범위 또는 로그 유형의 특성을 삭제할 수 있습니다.

# ...
spec:
  limits:
    global:
      otlp:
        streamLabels:
# ...
        drop:
          resourceAttributes:
          - name: "process.command_line"
          - name: "k8s\\.pod\\.labels\\..+"
            regex: true
          scopeAttributes:
          - name: "service.name"
          logAttributes:
          - name: "http.route"

# ...
spec:
  limits:
    global:
      otlp:
        streamLabels:
# ...
        drop:
          resourceAttributes:
          - name: "process.command_line"
          - name: "k8s\\.pod\\.labels\\..+"
            regex: true
          scopeAttributes:
          - name: "service.name"
          logAttributes:
          - name: "http.route"

Copy to Clipboard

Toggle word wrap

regex: true 를 설정하여 정규식을 사용하여 유사한 이름으로 속성에 대한 구성을 적용할 수 있습니다.

중요

데이터 볼륨이 증가할 수 있으므로 스트림 레이블에는 정규식을 사용하지 마십시오.

스트림 레이블로 명시적으로 설정되지 않거나 항목에서 삭제된 속성은 기본적으로 구조화된 메타데이터로 저장됩니다.

3.2.2. OpenShift 기본값 사용자 정의
링크 복사

openshift-logging 모드에서는 특정 속성이 필요하며 OpenShift 함수에서 역할로 인해 구성에서 제거할 수 없습니다. 성능에 영향을 미치는 경우 권장되는 기타 속성은 삭제될 수 있습니다. 특성에 대한 자세한 내용은 OpenTelemetry 데이터 모델 특성을 참조하십시오.

사용자 정의 속성 없이 openshift-logging 모드를 사용하는 경우 OpenShift 툴과 즉시 호환성을 얻을 수 있습니다. 스트림 레이블 또는 일부 속성을 삭제해야 하는 경우 사용자 지정 구성을 사용합니다. 사용자 지정 구성은 기본 구성과 병합할 수 있습니다.

3.2.3. 권장 속성 제거
링크 복사

openshift-logging 모드에서 기본 속성을 줄이려면 권장 속성을 비활성화합니다.

# ...
spec:
  tenants:
    mode: openshift-logging
    openshift:
      otlp:
        disableRecommendedAttributes: true

# ...
spec:
  tenants:
    mode: openshift-logging
    openshift:
      otlp:
        disableRecommendedAttributes: true

Copy to Clipboard

Toggle word wrap

1: 기본 속성을 필수 속성 또는 스트림 레이블로 제한하는 권장 속성을 제거하려면 disableRecommendedAttributes: true 를 설정합니다.
참고
이 설정은 기본 스트림 레이블을 제거하므로 쿼리 성능에 부정적인 영향을 미칠 수 있습니다. 쿼리에 필수 속성을 유지하려면 이 옵션을 사용자 지정 특성 구성과 페어링해야 합니다.

3.2. 속성 매핑

3.2.1. OpenShift의 사용자 정의 속성 매핑
링크 복사

3.2.2. OpenShift 기본값 사용자 정의
링크 복사

3.2.3. 권장 속성 제거
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

3.2. 속성 매핑

3.2.1. OpenShift의 사용자 정의 속성 매핑링크 복사링크가 클립보드에 복사되었습니다!

3.2.2. OpenShift 기본값 사용자 정의링크 복사링크가 클립보드에 복사되었습니다!

3.2.3. 권장 속성 제거링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

3.2.1. OpenShift의 사용자 정의 속성 매핑
링크 복사

3.2.2. OpenShift 기본값 사용자 정의
링크 복사

3.2.3. 권장 속성 제거
링크 복사