3.2. 속성 매핑

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

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

사용자 지정 수집기 사용: 설정에 추가 특성을 생성하는 사용자 지정 수집기가 포함된 경우 매핑 사용자 지정으로 이러한 특성이 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 구성 모두 속성을 스트림 레이블 또는 구조화된 메타데이터에 매핑할 수 있습니다. 로그 항목을 Loki 스토리지에 저장하려면 하나 이상의 스트림 레이블이 필요하므로 이 구성이 해당 요구 사항을 충족하는지 확인합니다.

스트림 레이블은 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:
# ...
        structuredMetadata:
          resourceAttributes:
          - name: "process.command_line"
          - name: "k8s\\.pod\\.labels\\..+"
            regex: true
          scopeAttributes:
          - name: "service.name"
          logAttributes:
          - name: "http.route"

# ...
spec:
  limits:
    global:
      otlp:
        streamLabels:
# ...
        structuredMetadata:
          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

작은 정보

Loki에서 유사한 속성을 매핑할 때 속성 이름에 regex: true 를 설정하여 정규식을 사용합니다.

중요

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

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

openshift-logging 모드에서는 특정 속성이 필요하며 OpenShift 함수에서 역할로 인해 구성에서 제거할 수 없습니다. 성능에 영향을 주는 경우 레이블이 지정된 기타 속성이 비활성화될 수 있습니다.

사용자 정의 속성 없이 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. 권장 속성 제거
링크 복사