뉴렐릭의 OpenTelemetry 리소스

OpenTelemetry의 모든 데이터는 리소스 와 연결됩니다. 자원은 텔레메트리를 자원 속성으로 생산하는 엔터티의 표현입니다. 리소스 속성은 New Relic의 엔터티 개념에 리소스를 적용하는 데 사용됩니다.

수신된 데이터는 엔터티 합성 이라는 프로세스를 통해 엔터티와 연결되며, 이에 따라 존재하는 리소스 속성은 데이터가 연결될 엔터티 유형을 결정하는 규칙과 일치됩니다. OpenTelemetry에서 가져온 데이터의 경우 엔터티 합성 규칙은 OpenTelemetry 리소스 의미 규칙을 따르도록 설계되었습니다.

자원 의미론적 규칙은 다양한 유형의 엔터티를 설명하기 위한 다양한 규칙 본문을 정의합니다. 예를 들어 서비스 및 호스트 규칙은 각각 서비스 또는 호스트 인스턴스를 설명하는 리소스 속성을 정의합니다.

지원되는 엔터티 유형

OpenTelemetry 사용 시 지원되는 뉴웰릭 엔터티 유형에 대해 설명합니다. 지원되는 각 엔터티 유형에는 다음이 포함됩니다.

• 엔터티 합성에 필요한 리소스 속성입니다.
• 뉴렐릭 UI 의 특정 측면을 구동하는 권장 속성입니다.
• 존재하는 경우 엔터티 태그 가 되는 속성입니다.

서비스

서비스 엔터티는 OpenTelemetry 서비스 를 설명하는 자원 의미론적 규칙을 준수하여 합성됩니다.

OpenTelemetry를 사용하여 서비스 엔터티를 모니터링하려면 설명서와 예제를 참조하세요.

필수 속성

• service.name: UI에 표시되는 서비스 이름은 이 값에서 나옵니다.

권장 속성

• service.instance.id: 동일한 서비스의 여러 인스턴스 간에 패싯을 활성화합니다.
• telemetry.sdk.language: 존재하는 경우 이 값은 Java 애플리케이션용 JVM 런타임 페이지와 같은 런타임 관련 UI의 표시를 구동합니다.

엔터티 태그

• service.namespace
• telemetry.sdk.language (언어 태그로 추가됨)
• telemetry.sdk.version
• k8s.cluster.name
• k8s.namespace.name
• k8s.deployment.name

호스트

호스트 엔터티는 호스트 를 설명하는 OpenTelemetry 리소스 의미 규칙을 준수하여 합성됩니다.

자세한 내용은 인프라 모니터링을 위한 수집기 의 호스트 모니터링 예를 참조하세요.

필수 속성

• host.name: UI에 표시되는 호스트 이름은 이 값에서 나옵니다.
• host.id

엔터티 태그

• cloud.provider
• cloud.account.id
• cloud.region
• cloud.availability_zone
• cloud.platform
• host.id
• host.name
• host.type
• host.arch
• host.image.name
• host.image.id
• host.image.version

Redis 인스턴스

Redis 인스턴스는 Redis Receiver 수집기에서 방출된 데이터를 사용하여 합성됩니다. 불행하게도 현재 Redis 제외에 대한 의미론적 규칙이 없거나 Redis 수신기가 내보내는 지표에 속성을 식별하는 방법이 없습니다. 따라서 사용자는 아래 설명된 속성을 수동으로 포함해야 합니다.

자세한 내용은 인프라 모니터링을 위한 수집기 의 Redis 예제를 참조하세요.

필수 속성

• server.address: UI에 표시되는 Redis 인스턴스 이름은 이 값에서 나옵니다.
• server.port

엔터티 태그

• redis.version
• redis.role
• host.type
• cloud.provider
• cloud.account.id
• cloud.region
• instrumenation.name
• server.address
• server.port

지원되는 엔터티 관계

뉴렐릭은 OpenTelemetry 에서 소스로 제공되는 엔터티 간의 관계를 지원합니다. 이러한 관계는 적절한 관계 기준이 충족되면 자동으로 합성됩니다. 다음은 현재 지원되는 관계와 필수 기준입니다.

호스트에 대한 서비스

서비스와 호스트 엔터티 간의 관계에서는 서비스에 host.id 리소스 속성이 포함되어야 하고 서비스가 실행 중인 호스트의 host.id 과 일치해야 합니다.

엔터티에 사용자 정의 태그 추가

태그를 사용하여 UI에서 엔터티를 구성하고 필터링할 수 있습니다. 태그는 모니터링되는 앱 및 호스트와 같은 다양한 데이터 세트에 추가되는 키-값 쌍(예 team: operations)입니다. 특정 중요한 속성은 계정 ID와 같은 태그로 자동으로 제공됩니다. UI에서 직접 또는 아래 방법 중 하나를 사용하여 나만의 맞춤 태그를 추가할 수도 있습니다.

접두사가 tags 인 리소스 속성을 추가하면 뉴렐릭의 엔터티에 태그가 표시됩니다. 예를 들어, tags.mytag=myvalue 속성을 추가하면 엔터티 태그 mytag=myvalue 가 생성됩니다.