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 리소스 의미 규칙을 준수하여 합성됩니다.
자세한 내용은 인프라 모니터링을 위한 수집기 의 호스트 모니터링 예를 참조하세요.
필수 속성
엔터티 태그
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 수신기 에서 방출된 데이터를 사용하여 합성됩니다. 안타깝게도 현재 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
과 일치해야 합니다.
Amazon CloudWatch Metric Streams
AWS 에서 호스팅되는 뷰는 뉴렐릭이 Amazon CloudWatch Metric Streams 와 통합되어 모니터링될 수 있습니다. 이는 인프라를 모니터링하기 위한 OpenTelemetry 솔루션이 아닙니다. 그러나 뉴렐릭은 Amazon 사용하여 렌더링된 서비스와 리소스 모니터 간의 다양한 관계를 OpenTelemetry CloudWatch Metric Streams 지원합니다.
중요
아래에 설명된 관계는 OpenTelemetry 의미 규칙을 활용합니다. 이러한 관례들 중 다수는 아직 안정적이지 않으며 계속 발전하고 있습니다. 아래 프레임워크에 대한 프레임메트리를 생성하는 측정, 로그는 의미 규칙에 대한 성숙도 및 준수 수준에 따라 다릅니다. 따라서 귀하가 사용하는 측정 시스템은 이러한 관계가 작동하는 데 필요한 속성을 방출하지 않을 수 있습니다. OpenTelemetry 의 의미 규칙에 따른 계측, 계측의 완성도에 관한 질문이 있으면 사용 중인 계측, 계측의 유지 관리자에게 문의하세요.
엘라스티캐시(Memcached)
CloudWatch Metric Streams Elasticache 용 Amazon 통합은 뉴렐릭에서 ElastiCache 분리를 생성합니다. 이 파티션 태그는 다음과 같습니다:
aws.elasticache.configurationEndpointAddress
또는aws.elasticache.endpointAddress
aws.elasticache.configurationEndpointPort
또는aws.elasticache.endpointPort
서비스에서 OpenTelemetry 측정, Memcached용 계측을 사용하는 경우 관계를 생성하려면 다음 속성을 내보내야 합니다.
db.system
: 이 속성은memcached
값을 가져야 합니다.net.peer.name
: 이 속성은 ElastiCache의 해당 부품포인트 태그와 일치해야 합니다.net.peer.port
: 이 속성은 ElastiCache의 해당 포트 태그와 일치해야 합니다.
아마존 MQ(액티브MQ)
Amazon MQ 에 대한 Amazon CloudWatch Metric Streams 통합은 뉴렐릭에서 Amazon MQ 부분을 생성합니다. 이 파티션 태그는 다음과 같습니다:
aws.mq.endpoint
서비스에서 OpenTelemetry 측정, ActiveMQ용 계측을 사용하는 경우 관계를 생성하려면 다음 속성이 필요합니다.
messaging.system
: 이 속성은activemq
값을 가져야 합니다.server.address
: 이 속성은 Amazon MQ의 해당 포인트 포인트 태그와 일치해야 합니다.span.kind
: 이 관계는span.kind
이producer
또는consumer
인 범위 데이터에서 생성됩니다.
아마존 관리형 카프카(MSK)
CloudWatch Metric Streams MSK 용 Amazon 통합은 뉴렐릭에서 MSK 부분을 생성합니다. 이 파티션 태그는 다음과 같습니다:
aws.clusterName
또는aws.kafka.ClusterName
aws.awsRegion
또는aws.region
aws.topic
또는aws.kafka.Topic
서비스에서 MSK용 OpenTelemetry 측정, 계측을 사용하는 경우 관계를 생성하려면 다음 속성이 있어야 합니다.
messaging.destination.name
: 서비스가 메시지를 생성하거나 메시지를 사용하는 MSK 토픽입니다.server.address
: 이 속성은 MSK의 부품포인트 태그와 일치해야 합니다.span.kind
: 이 관계는span.kind
이producer
또는consumer
인 범위 데이터에서 생성됩니다.
엔터티에 사용자 정의 태그 추가
태그를 사용하여 UI에서 엔터티를 구성하고 필터링할 수 있습니다. 태그는 모니터링되는 앱 및 호스트와 같은 다양한 데이터 세트에 추가되는 키-값 쌍(예 team: operations
)입니다. 특정 중요한 속성은 계정 ID와 같은 태그로 자동으로 제공됩니다. UI에서 직접 또는 아래 방법 중 하나를 사용하여 나만의 맞춤 태그를 추가할 수도 있습니다.
접두사가 tags
인 리소스 속성을 추가하면 뉴렐릭의 엔터티에 태그가 표시됩니다. 예를 들어, tags.mytag=myvalue
속성을 추가하면 엔터티 태그 mytag=myvalue
가 생성됩니다.