View a markdown version of this page

지표 파이프라인 프로세서 - Amazon CloudWatch
add_attributes 프로세서delete_attributes 프로세서rename_attributes 프로세서rename_metrics 프로세서substitute_attribute_values 프로세서전체 예프로세서 호환성 및 제한 사항

지표 파이프라인 프로세서

지표 파이프라인 프로세서는 수집 중 OTel 지표 데이터 포인트를 변환합니다. 지표 파이프라인에는 정의된 순서대로 순차적으로 적용되는 최대 20개의 프로세서가 있을 수 있습니다.

프로세서는 OTTL 경로 표현식을 사용하여 다양한 범위의 속성을 대상으로 지정합니다.

경로 범위 예제

resource.attributes["key"]

리소스 수준

resource.attributes["service.name"]

instrumentation_scope.attributes["key"]

범위 속성

instrumentation_scope.attributes["library"]

datapoint.attributes["key"]

데이터 포인트 수준

datapoint.attributes["status_code"]

attributes["key"]

데이터 포인트에 대한 짧은 형식

attributes["environment"]

add_attributes 프로세서

지표 데이터 포인트에 속성을 추가하거나 덮어씁니다. 모든 시간 유형에 사용할 수 있습니다.

OTTL에 상응: set(attributes["key"], "value")

구성

다음 파라미터를 사용하여 add_attributes 프로세서를 구성합니다.

processor:
  - add_attributes:
      attributes:
        - key: resource.attributes["team"]
          value: "payments"
        - key: attributes["environment"]
          value: "production"
        - key: instrumentation_scope.attributes["version"]
          value: "1.0"
          overwrite_if_key_exists: true
파라미터
attributes(필수)

추가할 속성 객체의 배열입니다.

attributes[].key(필수)

속성을 추가할 위치를 지정하는 OTTL 속성 경로입니다.

attributes[].value(필수)

할당할 문자열 값입니다.

attributes[].overwrite_if_key_exists (선택 사항)

부울. true인 경우 기존 값을 덮어씁니다. 기본값은 false입니다. true로 설정하면 이 작업은 파괴적인 것으로 간주되며 누적 지표 또는 판매 지표에는 적용되지 않습니다.

delete_attributes 프로세서

지표 데이터 포인트에서 특정 속성을 제거합니다. 누적 지표 또는 판매 지표에는 적용되지 않습니다.

OTTL에 상응: delete_key(attributes, "key")

구성

다음 파라미터를 사용하여 delete_attributes 프로세서를 구성합니다.

processor:
  - delete_attributes:
      with_keys:
        - resource.attributes["obsolete"]
        - attributes["temp"]
        - datapoint.attributes["debug"]
파라미터
with_keys(필수)

제거할 OTTL 속성 경로의 배열입니다.

rename_attributes 프로세서

지표 데이터 포인트의 속성 키 이름을 바꿉니다. 누적 지표 또는 판매 지표에는 적용되지 않습니다.

OTTL에 상응: set() + delete_key()

구성

다음 파라미터를 사용하여 rename_attributes 프로세서를 구성합니다.

processor:
  - rename_attributes:
      attributes:
        - from_key: resource.attributes["old_key"]
          to_key: resource.attributes["new_key"]
          overwrite_if_to_key_exists: true
파라미터
attributes(필수)

이름 바꾸기 작업의 배열입니다.

attributes[].from_key(필수)

소스 OTTL 속성 경로입니다.

attributes[].to_key(필수)

대상 OTTL 속성 경로입니다.

attributes[].overwrite_if_to_key_exists (선택 사항)

부울. true인 경우 대상 키가 있으면 덮어씁니다. 기본값은 false입니다.

rename_metrics 프로세서

지표 이름을 바꿉니다. 누적 지표 또는 판매 지표에는 적용되지 않습니다.

OTTL에 상응: set(name, "new.metric.name") where name == "old.metric.name"

구성

다음 파라미터를 사용하여 rename_metrics 프로세서를 구성합니다.

processor:
  - rename_metrics:
      metrics:
        - from: "old.metric.name"
          to: "new.metric.name"
파라미터
metrics(필수)

이름 바꾸기 작업의 배열입니다.

metrics[].from(필수)

현재 지표 이름입니다.

metrics[].to(필수)

새 지표 이름입니다.

substitute_attribute_values 프로세서

조회 테이블을 사용하여 속성 값을 매핑합니다. 누적 지표 또는 판매 지표에는 적용되지 않습니다.

OTTL에 상응: replace_match()

구성

다음 파라미터를 사용하여 substitute_attribute_values 프로세서를 구성합니다.

processor:
  - substitute_attribute_values:
      attributes:
        - key: resource.attributes["region"]
          from: "us-east-1a"
          to: "us-east-1"
파라미터
attributes(필수)

대체 작업의 배열입니다.

attributes[].key(필수)

일치시킬 OTTL 속성 경로입니다.

attributes[].from(필수)

일치시킬 값입니다.

attributes[].to(필수)

대체 값입니다.

전체 예

다음 예제에서는 단일 파이프라인에서 5개의 프로세서를 모두 사용합니다.

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'metric.name == "CPUUtilization"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["env"]
            value: "prod"
            overwrite_if_key_exists: true
    - delete_attributes:
        with_keys:
          - resource.attributes["internal.trace"]
    - rename_attributes:
        attributes:
          - from_key: resource.attributes["old_key"]
            to_key: resource.attributes["new_key"]
    - rename_metrics:
        metrics:
          - from: "CPUUtilization"
            to: "system.cpu.utilization"
    - substitute_attribute_values:
        attributes:
          - key: resource.attributes["environment"]
            from: "dev"
            to: "development"
  sink:
    - cloudwatch_metrics: {}

프로세서 호환성 및 제한 사항

최대 프로세서

지표 파이프라인 1개는 프로세서를 20개까지 포함할 수 있습니다.

파괴적 프로세서 및 시간성

파괴적 프로세서(delete_attributes, rename_attributes, rename_metrics, substitute_attribute_values 및 overwrite_if_key_exists: true가 설정된 add_attributes)는 누적 지표나 판매 지표에 적용되지 않습니다. 이러한 지표는 변경 없이 그대로 전달됩니다.

판매 지표 보호

파괴적 프로세서는 instrumentation_scope.name이 cloudwatch.aws/로 시작하는 지표를 수정할 수 없습니다. 이러한 지표는 변경 없이 그대로 전달됩니다.