뉴렐릭 옵저빌리버티는 entities 개념을 기반으로 구축되었습니다. 이 문서에서는 엔터티를 정의하는 방법, 엔터티로 수행할 수 있는 작업, 고유한 엔터티 또는 엔터티 그룹을 만드는 방법에 대해 설명합니다.
팁
New Relic 플랫폼 소개를 원하십니까? 플랫폼 알아보기 를참조하십시오.
엔터티가 무엇인가요?
뉴렐릭 관점에서 볼 때 entity 의도적으로 광범위한 개념입니다. 엔터티는 a) 뉴렐릭에 데이터를 보고하거나 우리가 액세스할 수 있는 데이터를 포함하고 b) 고유한 엔터티 ID로 식별되는 모든 것입니다. 대부분의 엔터티에서 ID는 entityGuid 속성 으로 표시됩니다.
엔터티는 응용 프로그램, 호스트 또는 데이터베이스 서비스와 같은 기본 데이터 보고 구성 요소일 수 있지만 이러한 구성 요소의 더 큰 그룹을 참조할 수도 있습니다. 예를 들어 데이터 센터를 모니터링하기 위해 New Relic에서 해당 호스트를 워크로드 (엔터티의 사용자 지정 그룹화)로 집계할 수 있습니다. 그 워크로드 자체도 하나의 엔터티입니다. 우리는 당신에게 자신의 엔터티를 생성 할 수 있는 능력을 제공합니다.
또한 엔터티 간의 관계도 매우 중요합니다. 배후의 관계 매핑은 엔터티가 어떻게 연결되어 있고 서로에게 어떤 영향을 미치는지 이해하는 데 도움이 됩니다. 이를 통해 가져오는 데이터가 기존 엔터티와 관련되는 방식 또는 다른 엔터티와 관련되는 방식을 구성할 수 있는 권한을 제공할 수 있습니다.
모니터링되는 서비스 및 시스템의 방대한 목록에서 도움이 되지 않는 대규모 데이터 스트림을 제공하는 것이 아니라 practical information about your business-important entities 제공하는 것이 우리의 목표이기 때문에 엔터티와 해당 관계에 중점을 두는 것이 중요합니다. 엔터티 수준의 더 많은 인사이트를 통해 복잡하고 현대적인 시스템을 더 효과적으로 모니터링하고 문제를 해결할 수 있습니다.
one.newrelic.com: 뉴렐릭을 열면 모니터 엔터티의 개요를 제공하는 All entities 페이지로 이동하게 됩니다. 이 페이지에서 엔터티에 대한 메타데이터를 보거나 엔터티를 클릭하여 성능 세부 정보를 볼 수 있습니다.
엔터티 필터링 및 탐색
엔터티 필터 표시줄은 UI 기본 엔터티 목록 보기, APM UI대시보드 UI 등을 포함한 여러 뉴렐릭 페이지에서 사용할 수 있습니다. 필터 표시줄을 사용하여 엔터티를 탐색하고 유용한 필터를 저장하는 방법을 알아보려면 엔터티 필터를 참조하세요.
엔터티에 대해 알아보기
엔터티의 GUID 및 기타 메타데이터를 UI 에서 찾으려면 : 임의 의 엔터티 목록 에서 엔터티의 아이콘을 클릭하고 See metadata & tags을 클릭합니다.
모든 엔티티에는 entityGuid 속성으로 보고되는 New Relic 고유의 ID 번호가 있습니다. GUID를 사용하여 엔터티의 NRQL 쿼리를 실행할 수 있습니다.
엔터티 간의 관계에 대해 알아보기
다음은 모니터링 대상 간의 관계를 이해하기 위한 몇 가지 옵션입니다.
- UI 에서 엔터티를 볼 때는 Related entities UI 사용하세요.
- 서비스 맵을 사용하여 연결의 시각적 표현을 확인하십시오.
- 분산 추적을 사용하여 엔터티가 트랜잭션에서 서로를 호출하는 방식을 확인합니다.
- 관계 정보를 보려면 NerdGraph API를 사용하세요.
엔터티에 대한 기술 세부 정보 알아보기
엔터티 유형에 대한 기술 세부 정보를 알아보려면 엔터티 유형에 대한 GitHub 리포지토리를 참조하세요. 예를 들어 APM 모니터링 엔터티에 대한 자세한 내용은 APM 애플리케이션 을 참조하십시오.
각 엔터티에는 데이터를 보고하는 방법을 제어하는 여러 파일이 포함되어 있습니다. 예를 들어 golden_metrics 파일에는 일반적으로 UI 환경에서 강조표시되는 가장 중요한 측정항목에 대한 정보가 포함되어 있습니다. 다음은 APM 모니터링 항목에 대한 golden_metrics.yml 파일 입니다.
항목의 definition 파일에는 다음과 같은 정보가 포함됩니다.
domain: 예:APM또는Infra.type: 예:Application또는AWSECSCONTAINERINSTANCE.- 기본태그 .
entityExpirationTime: 이에 대한 자세한 내용은 엔티티 만료를 참조하세요.
엔티티 만료
각 항목 유형에 대해 definition 파일에 설정된 entityExpirationTime 에 의해 결정되는 다른 항목 유형에는 서로 다른 TTL(수명) 기간이 있습니다. 이 만료 시간은 엔터티가 데이터 보고를 중지한 후 해당 엔터티에 대한 레코드가 New Relic에 존재하는 기간을 제어합니다.
New Relic은 수많은 엔터티를 모니터링하며 이러한 엔터티 중 다수는 수명이 짧습니다(예: Kubernetes 컨테이너). 이러한 이유로 보고 데이터를 중지한 엔터티 레코드를 정기적으로 삭제해야 합니다.
이 만료 시간은 엔터티 자체의 기록과 관련되며 원격 측정 데이터 와는 관련이 없습니다 . 다른 말로 하면 모니터링 대상에서 보고한 원격 측정 데이터는 데이터 보존 설정 에 따라 NRDB에서 찾을 수 있고 NRQL을 통해 사용할 수 있습니다. 그러나 개체 자체의 기록은 일단 만료되면 더 이상 New Relic에 존재하지 않습니다.
엔터티 만료 시간에 대한 옵션은 다음과 같습니다.
FOUR_HOURSDAILY(24 시간)EIGHT_DAYS:definition파일에 기한이 정의되지 않은 경우 기본값이 적용됩니다.QUARTERLY(3 개월)MANUAL: 이 설정은 생성 및 삭제가 수동으로 제어되는 엔터티(예: 워크로드 및 대시보드)에만 적용됩니다.
항목 그룹화 및 구성
조직의 비즈니스 중요 관계를 반영하는 그룹에 엔터티를 배치할 수 있습니다. 예를 들어 특정 팀이나 부서와 관련되거나 특정 서비스와 관련된 모든 엔터티를 그룹화할 수 있습니다. 또는 여러 호스트를 함께 그룹화하여 데이터 센터에 그룹화를 반영할 수 있습니다.
엔터티를 그룹화하려면 다음을 참조하세요.
- 엔터티에 태그를 지정 합니다.
- 비즈니스에 중요한 엔터티 집합을 그룹화할 수 있는 워크로드를 만듭니다 .
- 엔터티 생성 및 엔터티 데이터 사용자 지정
엔터티 합성으로 나만의 엔터티 생성 및 관리
New Relic에서 기본적으로 지원하지 않는 소스의 원격 분석이 있는 경우 이에 대한 매핑을 제안할 수 있습니다. 승인되면 정의 파일과 일치하는 New Relic이 수신한 모든 원격 측정이 엔터티로 합성됩니다.
자세히 알아보려면:
- 예약된 속성과 엔티티 관계가 정의되는 방식에 대해서는 이 문서를 계속 읽으십시오.
- 기존 엔티티 유형을 수정하거나 새 유형을 생성하는 작업을 수행하는 방법 은 엔티티 합성에 대한 GitHub 리포지토리를 참조하세요.
합성된 엔터티에 대한 예약된 속성
이러한 속성은 우리가 받는 텔레메트리에서 합성되도록 되어 있습니다. 그 의미와 결과를 알지 못하는 경우에는 설정하지 마세요.
기인하다 | 설명 |
|---|---|
| 일반적으로 원격 분석 데이터에 이 특성 필드를 설정하면 안 됩니다. New Relic은 수집된 데이터에 이 필드를 추가하여 데이터 포인트와 연결된 엔터티의 고유 식별자를 저장할 수 있습니다. 이 특성을 전달하는 한 가지 사용 사례는 수집된 원격 분석을 이미 모니터링하는 엔터티와 연결하는 것입니다. |
| 엔터티 식별 시스템에서 선택했을 엔터티 이름을 재정의하지 않는 한 수집된 원격 분석 데이터에 이 특성을 지정하면 안 됩니다. 데이터에 이미 있는 값은 변경하지 않지만 데이터에 속성을 추가할 수 있습니다. 따라서 유효하지 않거나 예상치 못한 값은 UI에서 엔터티 누락 또는 예상 엔터티와 연결되지 않은 원격 분석과 같은 정의되지 않은 동작을 유발할 수 있습니다. 이 필드가 수집된 원격 분석에 있는 경우 해당 값은 데이터 요소와 연결된 엔터티의 이름을 지정하는 데 사용됩니다. 이 이름은 엔터티 식별 시스템에서 선택한 이름(예: 엔터티 합성 정의) 대신 사용됩니다. 많은 엔티티가 식별의 일부로 이름을 사용하므로 이 필드를 변경하면 새 엔티티가 생성될 수 있습니다. |
| 이 특성은 엔터티 유형을 구별해야 하는 특정 레거시 경우를 제외하고 수집된 원격 분석 데이터에 적용해서는 안 됩니다. 이 필드를 전달하면 특히 이 필드에서 인식할 수 없는 값이 전송되는 경우 엔터티 감지를 방해할 수 있습니다. New Relic은 데이터에 이미 있는 경우 값을 변경하지 않지만 필드는 쿼리 시 원격 분석에 대한 명확한 필터링을 제공한다고 보장되지 않습니다. 기존 항목 정의에는 이미 겹치는 값이 있으므로 원격 분석 쿼리를 필터링하기 위해 다른 필드 대신 이 필드는 New Relic에서 사용합니다. 즉, 유효하지 않거나 예기치 않은 값으로 인해 UI에서 누락된 엔터티 또는 원격 측정이 예상 엔터티와 연결되지 않는 등 정의되지 않은 동작이 발생할 수 있습니다. |
기존 엔티티 유형을 수정하거나 새 유형을 생성하는 작업을 수행하는 방법을 배우려면 엔티티 합성에 대한 GitHub 리포지토리를 참조하십시오.
계측되지 않은 엔터티
원격 분석을 사용하여 지금은 계측되지 않지만 애플리케이션에서 사용되는 엔터티를 감지할 수 있습니다. 예를 들어 계측된 엔터티 중 하나가 현재 New Relic에서 계측되지 않은 Amazon RDS 데이터베이스를 호출할 수 있으므로 모니터링 또는 알림과 같은 도구를 제공할 수 없습니다.
이 경우 계측된 항목과의 관계와 함께 소위 "계측되지 않은 엔터티"를 만듭니다. 구성된 엔터티의 서비스 맵 에 표시됩니다. 엔터티를 클릭하기만 하면 표시되는 명확한 계측 지침을 제공합니다.
엔티티 관계
엔티티 간의 연결은 원격 측정에서 추론할 수 있는 것을 기반으로 New Relic에 의해 자동으로 생성됩니다. 예를 들어, HTTP를 사용하여 통신하는 두 서비스가 New Relic으로 계측될 때 우리는 그들 사이의 "호출/호출" 관계를 추론합니다.
엔터티 탐색기, 내비게이터 및 Lookout 보기에서 엔터티를 볼 때 오른쪽 창에 해당 Related entities 가 표시됩니다. 현재 엔터티에 직접 연결된 다양한 엔터티를 시각화해 줍니다. 관련 엔터티에 대한 중요한 지표를 빠르게 보고 그리드의 연결된 모든 부분을 통해 한 엔터티에서 다른 엔터티로 이동할 수 있습니다.
팁
NerdGraph API를 사용하여 엔터티 관계를 더 깊이 파고드는 방법을 알아보세요.
엔터티 관계 유형
엔터티는 다양한 방식으로 서로 관련될 수 있습니다. 아래 축소기는 지원되는 엔터티 관계를 나열합니다. 가능한 관계를 이해했으면 자동으로 생성된 관계 목록을 살펴보거나 사용자 지정 엔터티 관계를 생성할지 여부를 고려하십시오.
자동으로 생성되는 관계는 무엇입니까?
엔터티가 보고하는 원격 분석을 기반으로 자동 관계가 생성됩니다. 이러한 관계에는 TTL(Time To Live)이 있습니다. 즉, 관계를 생성하는 데 사용된 측정항목이 지정된 기간 동안 보고되지 않으면 자동으로 삭제됩니다. 관계의 기본 TTL은 75분 입니다. TTL은 관계 유형에 따라 10분에서 최대 3일까지 다양합니다.
다음은 자동으로 생성되는 엔터티 간의 관계입니다.
사용자 지정 엔터티 관계 만들기
관계가 자동으로 감지되지 않으면 NerdGraph API 사용하여 수동으로 생성하거나 뉴렐릭 UI 에서 Related entities의 Add/edit related entities 링크를 사용하여 생성할 수 있습니다. 현재는 서비스 엔터티 간의 호출/호출자 관계를 수동으로만 생성할 수 있습니다.
팁
수동 관계를 관리하려면 엔터티 관계에 대한 수정 및 삭제 기능이 있어야 합니다. 관계 수정 버튼이 표시되지 않으면 계정 관리자에게 문의하세요.