• /
  • 로그인
  • 무료 계정

이 사이트는 현재 개발 중입니다.

여기에서 영문 버전을 확인하실 수 있습니다. 보다 자세한 내용은 이 페이지를 방문하십시오.

문제 신고

New Relic에서 엔티티란 무엇인가요?

New Relic 모니터링은 개체 의 개념을 중심으로 구축되었습니다. 이 문서에서는 엔터티를 정의하는 방법, 엔터티로 수행할 수 있는 작업, 고유한 엔터티 또는 엔터티 그룹을 만드는 방법을 배웁니다.

엔터티가 무엇인가요?

New Relic의 관점에서 엔티티 는 의도적으로 광범위한 개념입니다. 엔터티는) New Relic에 데이터를 보고하거나 우리가 액세스할 수 있는 데이터를 포함하고 b) 고유한 엔터티 ID로 식별한 모든 것입니다. 대부분의 엔터티에서 ID는 entityGuid 속성 으로 표시됩니다.

엔터티는 응용 프로그램, 호스트 또는 데이터베이스 서비스와 같은 기본 데이터 보고 구성 요소일 수 있지만 이러한 구성 요소의 더 큰 그룹을 참조할 수도 있습니다. 예를 들어 데이터 센터를 모니터링하기 위해 New Relic에서 해당 호스트를 집계하여 워크로드 (엔티티의 사용자 지정 그룹화)가 될 수 있습니다. 그 워크로드 자체도 하나의 엔터티입니다.

또한 엔티티 간의 관계 가 매우 중요합니다. 우리의 배후 관계 매핑은 엔티티가 어떻게 연결되고 서로 영향을 미치는지 이해하는 데 도움이 됩니다. 이를 통해 가져오는 데이터가 기존 엔터티와 관련되는 방식 또는 다른 엔터티와 관련되는 방식을 구성할 수 있는 권한을 제공할 수 있습니다.

엔터티 및 해당 관계에 중점을 두는 것은 중요합니다. 우리의 목표는 비즈니스에 중요한 엔터티에 대한 실용적인 정보 를 제공하고 모니터링되는 방대한 목록에서 도움이 되지 않는 방대한 데이터 스트림을 제공하는 것이 아니기 때문입니다. 엔터티 수준에서 더 많은 통찰력을 통해 복잡하고 현대적인 시스템을 더 잘 모니터링하고 문제를 해결할 수 있습니다.

엔터티 및 엔터티 데이터 찾기 및 탐색

모든 데이터 원본을 모니터링하기 위해 새 엔터티 유형을 만들 수 있습니다. 엔터티 합성에 대해 자세히 알아보세요.

엔터티 데이터를 찾고 이해하기 위한 몇 가지 팁:

  • 엔티티의 entityGuid , entityName 및 기타 메타데이터를 찾으려면 New Relic Explorer 의 모니터링되는 엔티티 목록에서 엔티티의

    아이콘을 클릭하고 메타데이터 및 태그 보기 를 클릭합니다.

  • 대부분의 엔터티에서 해당 GUID는 entityGuid 속성으로 보고됩니다. 워크로드의 경우 workloadGuid 입니다. NRQL 쿼리 를 실행하여 GUID로 엔터티를 찾을 수 있습니다.

  • 엔터티 간의 연결을 보려면 다음과 같은 몇 가지 옵션이 있습니다.

  • 항목을 함께 그룹화하려면 항목 그룹화 를 참조하십시오.

  • 엔터티 정의 및 관계를 사용자 지정합니다.

  • 엔터티 유형에 대한 기술적인 세부 정보를 알아보려면 GitHub 리포지토리 를 참조하세요. 항목 유형의 definition 파일에 다음과 같은 정보가 표시됩니다.

    • domain : 예: APM 또는 Infra .
    • type : 예: Application 또는 AWSECSCONTAINERINSTANCE .
    • 기본태그 .
    • entityExpirationTime : 해당 엔티티의 데이터가 UI에서 지속되는 기간( 데이터베이스 데이터 보존 과 다릅니다.

항목 그룹화 및 구성

조직의 비즈니스 중요 관계를 반영하는 그룹에 엔터티를 배치할 수 있습니다. 예를 들어 특정 팀이나 부서와 관련되거나 특정 서비스와 관련된 모든 엔터티를 그룹화할 수 있습니다. 또는 여러 호스트를 함께 그룹화하여 데이터 센터에 그룹화를 반영할 수 있습니다.

엔터티를 그룹화하려면 다음을 참조하세요.

엔터티 합성으로 엔터티 데이터 사용자 지정

New Relic에서 기본적으로 지원하지 않는 소스의 원격 분석이 있는 경우 이에 대한 매핑을 제안할 수 있습니다. 승인되면 정의 파일과 일치하는 New Relic이 수신한 모든 원격 측정이 엔터티로 합성됩니다.

자세히 알아보려면:

  • 예약된 속성과 엔티티 관계가 정의되는 방식에 대해서는 이 문서를 계속 읽으십시오.
  • 기존 엔티티 유형을 수정하거나 새 유형을 생성하는 작업을 수행하는 방법 은 엔티티 합성에 대한 GitHub 리포지토리를 참조하세요.

합성된 엔터티에 대한 예약된 속성

이러한 속성은 우리가 수신하는 원격 측정에서 합성하기 위한 것입니다. 의미와 결과를 알고 있지 않으면 설정하지 마십시오 .

기인하다

설명

entity.guid

일반적으로 원격 분석 데이터에 이 특성 필드를 설정하면 안 됩니다. New Relic은 수집된 데이터에 이 필드를 추가하여 데이터 포인트와 연결된 엔터티의 고유 식별자를 저장할 수 있습니다. entity.guid 속성이 이미 있는 원격 측정이 도착하면 New Relic은 값을 변경하지 않습니다. 그러나 UI에서 누락된 엔터티 또는 원격 분석이 예상 엔터티와 연결되지 않는 등의 정의되지 않은 동작이 발생할 수 있습니다.

이 속성을 전달하는 한 가지 사용 사례는 수집된 원격 분석을 New Relic에서 이미 생성한 엔터티와 연결하는 것입니다. entity.guid 속성이 전송되면 값은 New Relic의 엔티티 식별 시스템(예: 엔티티 합성 정의)을 재정의하고 대신 속성을 데이터로 사용합니다.

entity.name

이 속성은 New Relic의 엔터티 식별 시스템에서 선택한 엔터티 이름을 재정의하려는 경우가 아니면 수집된 원격 분석 데이터에 적용하면 안 됩니다. New Relic은 데이터에 이미 존재하는 경우 값을 변경하지 않지만 New Relic은 데이터에 속성을 추가할 수 있습니다. 따라서 유효하지 않거나 예기치 않은 값으로 인해 UI에서 누락된 엔터티 또는 원격 분석이 예상 엔터티와 연결되지 않는 등의 정의되지 않은 동작이 발생할 수 있습니다.

수집된 원격 분석에 이 필드가 있는 경우 해당 값은 데이터 요소와 연결된 엔터티의 이름을 지정하는 데 사용됩니다. 이 이름은 New Relic의 엔티티 식별 시스템에서 선택한 이름 대신 사용됩니다(예: 엔티티 합성 정의 ). 많은 엔티티가 이름을 식별의 일부로 사용하므로 이 필드를 변경하면 새 엔티티가 생성될 수 있습니다.

entity.type

이 특성은 엔터티 유형을 구별해야 하는 특정 레거시 경우를 제외하고 수집된 원격 분석 데이터에 적용해서는 안 됩니다. 이 필드를 전달하면 특히 이 필드에서 인식할 수 없는 값이 전송되는 경우 엔터티 감지를 방해할 수 있습니다.

New Relic은 데이터에 이미 있는 경우 값을 변경하지 않지만 필드는 쿼리 시 원격 분석의 명확한 필터링을 제공한다고 보장되지 않습니다. 기존 엔터티 정의에는 이미 겹치는 값이 있으므로 원격 분석 쿼리를 필터링하기 위해 다른 필드 대신 entity.type 을 사용하지 않는 것이 좋습니다.

이 필드는 New Relic에서 사용합니다. 즉, 유효하지 않거나 예기치 않은 값으로 인해 UI에서 누락된 엔터티 또는 원격 측정이 예상 엔터티와 연결되지 않는 등 정의되지 않은 동작이 발생할 수 있습니다.

기존 엔티티 유형을 수정하거나 새 유형을 생성하는 작업을 수행하는 방법을 배우려면 엔티티 합성에 대한 GitHub 리포지토리를 참조하십시오.

엔티티 간의 연결은 원격 측정에서 추론할 수 있는 것을 기반으로 New Relic에 의해 자동으로 생성됩니다. 예를 들어, HTTP를 사용하여 통신하는 두 서비스가 New Relic으로 계측될 때 우리는 그들 사이의 "호출/호출" 관계를 추론합니다.

New Relic Explorer , Navigator 또는 Lookout에서 특정 엔티티를 볼 때 엔티티의 미니 개요에서 관련 엔티티 를 볼 수 있습니다. 이것은 현재 엔티티에 직접 연결된 다양한 엔티티의 시각화를 제공합니다. 스택의 연결된 모든 부분을 통해 이러한 관련 엔터티에 대한 중요한 메트릭을 빠르게 보고 한 엔터티에서 다른 엔터티로 이동할 수 있습니다.

엔티티가 NerdGraph API와 어떻게 관련되는지 자세히 알아보세요.

관계가 자동으로 감지되지 않으면 관련 항목의 " 관련 항목 추가/편집" 링크를 사용하여 수동으로 만들 수 있습니다.

중요

현재는 서비스 엔터티 간의 호출/발신자 관계만 수동으로 생성할 수 있습니다.

수동 관계를 관리하려면 엔터티 관계에 대한 수정 및 삭제 기능이 있어야 합니다. 관계 수정 버튼이 표시되지 않으면 계정 관리자에게 문의하세요.

어떤 관계가 생성됩니까?

엔터티 간에 생성된 관계는 다음과 같습니다.

수동으로 관계 만들기

GraphQL API인 NerdGraph 를 사용하여 추가 관계를 생성할 수 있습니다.

돌연변이 entityRelationshipUserDefinedCreateOrReplace 를 사용하여 관계를 생성하거나 교체할 수 있습니다. 이름에서 알 수 있듯이 지정된 유형으로 두 엔터티 간의 관계를 만들 수 있습니다. 두 엔터티 간에 관계가 이미 존재하는 경우 업데이트된 지정된 값(생성 시간 및 작성자 사용자 ID)으로 다시 추가됩니다.

mutation {
entityRelationshipUserDefinedCreateOrReplace(
sourceEntityGuid: "{SourceEntityGuid}"
targetEntityGuid: "{TargetEntityGuid}"
type: BUILT_FROM
) {
errors {
message
type
}
}
}

돌연변이 entityRelationshipUserDefinedDelete 를 사용하여 관계를 삭제합니다. sourcetarget 은 필수이지만 type 은 그렇지 않습니다. 돌연변이가 type 없이 실행되면 두 엔티티 간의 모든 관계가 제거됩니다.

mutation {
entityRelationshipUserDefinedDelete(
sourceEntityGuid: "{SourceEntityGuid}"
targetEntityGuid: "{TargetEntityGuid}"
type: BUILT_FROM
) {
errors {
message
type
}
}
}

관계 API 자습서 에서 관계 가져오기에 대한 정보를 찾으십시오.

몇 가지 고려 사항

  • 두 엔터티는 각 관계 유형에 대해 하나씩 여러 관계를 가질 수 있습니다.
  • 두 엔터티는 동일한 신뢰할 수 있는 계정에 속한 경우 관계를 유지할 수 있습니다.
  • 각 엔터티에 대해 최대 2000개의 관계를 수동으로 정의할 수 있습니다. 제한에 도달하면 API가 LIMIT_EXCEEDED 오류를 반환합니다.
  • 두 엔터티(소스/대상) 중 하나에 액세스할 수 없는 경우 각 변형이 실패할 수 있습니다.

관계 유형은 두 엔터티가 관련된 방식에 대한 추가 정보를 제공합니다. 지원되는 관계 유형은 다음과 같습니다.

문제 신고
Copyright © 2022 New Relic Inc.