긴 속성의 뉴렐릭 OTLP 처리 업데이트

긴 속성 값이 발생하는 경우 OTLP 수집 검증 논리를 덜 엄격하게 조정하고 있습니다.

뉴렐릭 OTLP 엔드포인트에는 다양한 속성 제한이 있습니다. 현재 4095자 길이 제한을 초과하는 문자열 속성을 포함하여 OTLP span, Indicator 또는 trays를 보내면 NrIntegrationError가 생성되고 전체 레코드가 삭제됩니다.

이는 누락된 데이터가 발생하는 가장 흔한 원인입니다. 다행히도 간단한 해결책이 있습니다.

이 제한을 위반하는 레코드를 삭제하는 대신, 긴 속성을 4095자로 간단히 잘라낼 것입니다.

이 변경 사항은 2025년 6월 2일 에 적용됩니다.

이것이 나에게 어떤 영향을 미칠까요?

우리는 이것이 거의 모든 경우에 환영할만한 도움이 될 것이라고 믿습니다. 누락된 데이터를 추적하고 진단하는 것은 힘든 일이며, 특히 많은 개별 팀이 관리하는 많은 구현 및 배포가 있는 환경에서는 더욱 그렇습니다. 이 변경을 통해 뉴럴릭 OTLP 저장은 "보낸 것을 저장한다"는 철학을 더 잘 구현하고 일반적인 함정 하나를 줄일 수 있습니다.

그러나 뉴렐릭의 사용 기반 가격 책정 모델을 고려할 때, 이러한 변경은 이전에 한도 초과로 인해 삭제된 기록이 이제 저장되어 계정의 데이터 사용량에 반영된다는 것을 의미합니다.

속성 제한 에 대한 OTLP 엔드포인트 문서를 따르고 있다면 아무것도 할 수 없습니다. 속성 제한을 준수한다는 것은 현재 데이터가 삭제되지 않으며, 따라서 추가 데이터가 저장되지 않는다는 것을 의미합니다.

현재 계정의 데이터가 속성 길이 제한을 초과하여 삭제되는지 확인하려면 다음 NRQL 쿼리를 실행하세요.

FROM NrIntegrationError SELECT * WHERE message like 'One or more OTLP data point(s) was dropped because the length of an attribute value was over the limit.

이 쿼리에서 결과가 반환되면 이러한 변경에 따라 사용량과 청구 방식이 변경될 수 있습니다. 정확한 금액은 기록이 한도를 위반하는 빈도에 따라 달라집니다. 추가로 발생할 수 있는 데이터 사용량을 상쇄하는 방법에 대한 조언은 완화책을 참조하세요.

완화

OpenTelemetry의 핵심 가치 제안 중 하나는 텔레메트리 와이어 파이프라인을 제어할 수 있는 도구를 제공하는 것입니다. 이에 따라 데이터 사용의 변화를 완화하는 데 도움이 되는 다양한 도구를 사용할 수 있습니다. 자세한 내용은 OpenTelemetry 데이터 수집 볼륨 관리를 참조하세요. 여기서는 특히 관련성이 높은 몇 가지 전략이 있습니다.

• 긴 속성 잘라내기
• 문제가 되는 속성을 삭제합니다
• 샘플링을 사용하여 더 적은 레코드 보내기

긴 속성 잘라내기

여기에서 보여준 것처럼 수집기 변환 프로세서와 truncate_all 편집기를 활용해 모든 속성을 알려진 한도까지 잘라냅니다. 이번 변경 이후 뉴웰릭 OTLP 엔드포인트가 수행할 작업은 다음과 같습니다. 하지만 이 기술을 사용하면 한도보다 낮은 한도를 설정하여 사용량 변화를 상쇄할 수 있습니다. 예를 들어, 옵저버빌리티 사용 사례에 처음 1000자만 필요하다고 생각되면 1000자로 제한을 설정할 수 있습니다.

transform:
  trace_statements:
    - truncate_all(span.attributes, 4095)
    - truncate_all(resource.attributes, 4095)
  log_statements:
    - truncate_all(log.attributes, 4095)
    - truncate_all(resource.attributes, 4095)
  metric_statements:
    - truncate_all(datapoint.attributes, 4095)
    - truncate_all(resource.attributes, 4095)

문제가 되는 속성을 삭제합니다

수집기 변환 프로세서와 delete_key 편집기를 활용하여 가치가 없는 속성을 삭제합니다.

transform:
  trace_statements:
    - delete_key(span.attributes, "attribute.key.to.drop")
  log_statements:
    - delete_key(log.attributes, "attribute.key.to.drop")
  metric_statements:
    - delete_key(datapoint.attributes, "attribute.key.to.drop")

특히 길어서 사용에 큰 영향을 미치는 속성 키나, 짧지만 일반적으로 유용하지 않은 속성 키를 삭제할 수 있습니다. 참고로, 다음 목록은 길이 제한을 위반하는 가장 일반적인 10가지 속성을 요약한 것입니다.

• exception.stactrace
• other - OpenTelemetry 의미 규칙에 정의되지 않은 사용자 정의 속성에 대한 포괄적인 용어
• db.statement
• process.command_line
• graphql.document
• db.operation
• db.query.text
• http.url
• exception.message
• http.target

샘플링을 사용하여 더 적은 레코드 보내기

여기에 설명된 전략 중 하나를 사용하여 샘플링 속도를 조정하여 추가 데이터를 오프셋합니다.