NerdGraph 튜토리얼: 엔티티 데이터 보기

New Relic의엔터티는 원격 측정을 생성하거나 포함하는 우리가 모니터링하는 모든 것을 말합니다. 엔터티는 New Relic에서 추적하려는 데이터를 찾는 데 도움이 되며 다른 엔터티와의 관계를 이해하면 데이터에 대한 더 많은 통찰력을 얻을 수 있습니다. 다음은 엔터티의 몇 가지 예입니다.

APM 이 모니터링하는 애플리케이션.
인프라 모니터링 으로 모니터링되는 클라우드 통합, 서비스 및 호스트.

UI에서 직접 엔터티로 작업하거나( New Relic 엔터티에 대해 알아보기참조) NerdGraph API를 통해 엔터티 작업에 대한 단계를 수행할 수 있습니다. NerdGraph를 시작하는 데 도움이 필요한 경우 New Relic NerdGraph 소개를참조하세요.

중요

엔터티의 골든 메트릭 및 태그로 작업하려면 골든 메트릭 API 자습서 를참조하십시오.

시작하기 전에

엔터티로 작업하기 전에 엔터티에 대해 알아보기를 읽어 보는 것이 좋습니다.

엔터티로 작업할 때 염두에 두어야 할 몇 가지 중요한 사항은 다음과 같습니다.

고유한 GUID는 엔터티(entity.guid 또는 entityGuid)를 식별합니다.
엔터티는 특정 기간 동안 New Relic에 존재합니다.
엔터티는 특정 메트릭 및 이벤트에 대한 데이터를 탐색하거나 다른 엔터티와 관련된 데이터를 컨텍스트화하기 위한 유용한 진입점을 제공합니다.

엔터티 검색

New Relic은 속성, 주로 이름뿐 아니라 엔티티 유형 및 기타 값으로 엔티티를 검색합니다. 검색은 검색 기준과 일치하는 엔터티에 대한 기본 데이터를 반환합니다. 그런 다음 기본 쿼리 결과에서 GUID로 특정 엔터티를 쿼리할 수 있습니다.

domainType 외에 다른 일반적인 항목 속성은 다음과 같습니다.

id
accountId
name
domainId
alertSeverity
reporting

위의 속성 중 하나로 필터링할 수 있습니다. 또한 필터링을 위해 태그를 사용할 수 있습니다.

주의

사용자 지정 루트 수준 엔터티 속성으로 필터링할 수 없습니다. 사용자 지정 속성은 실제 검색 응답에서 엔터티 메타데이터의 일부로만 검색됩니다. 사용자 정의 필드로 필터링하려면 엔티티 태그로 변환하십시오.

다음 두 가지 방법 중 하나로 쿼리를 작성할 수 있습니다.

쿼리를 작성하는 데 도움이 되도록 queryBuilder 인수를 사용합니다.
자유 형식 query 인수를 사용하여 고유한 검색을 작성하십시오.

NerdGraph를 사용하여 하나 이상의 엔터티를 쿼리하려면 속성 또는 GUID로 검색할 수 있습니다.

팁

NerdGraph는 한 쿼리에서 반환할 수 있는 총 엔터티 수를 200으로 설정합니다. 쿼리에 대해 모든 엔터티를 검색해야 하는 경우 예제에 설명된 대로 커서 페이지 매김을 사용합니다.

아래 예제외에도 NerdGraph 탐색기를사용하여 API를 실험해 볼 것을 권장합니다. 쿼리 및 변형을 구성하는 데 도움이 되는 인라인 문서가 있습니다.

다음으로 검색 `queryBuilder`

queryBuilder 인수는 간단한 쿼리를 구성하는 데 유용합니다. 이를 통해 미리 정의된 속성 목록과 해당 일반 값에서 쿼리에 필터를 추가할 수 있습니다. 고급 쿼리의 경우 대신 query 인수를 사용하십시오.

NerdGraph GraphiQL 탐색기 로 이동합니다.
기본 쿼리를 실행하여 검색 기준과 일치하는 엔터티를 찾습니다. 예를 들어:

{
  actor {
    entitySearch(queryBuilder: { domain: APM, type: APPLICATION }) {
      query
      results {
        entities {
          name
          entityType
          guid
        }
      }
    }
  }
}

자유형으로 검색 `query`

이것은 더 복잡한 쿼리를 만드는 데 유용합니다.

NerdGraph GraphiQL 탐색기 로 이동합니다.
기본 쿼리를 실행하여 검색 기준과 일치하는 엔터티를 찾습니다. 예를 들어:

query($query: String!) {
  actor {
    entitySearch(query: $query) {
      count
      results {
        entities {
          name
          entityType
          guid
        }
      }
    }
  }
}

NerdGraph의 쿼리 변수 섹션에 다음 변수 를 추가합니다.

{ "query": "name LIKE 'nerd-graph' AND domainType IN ('APM-APPLICATION')" }

GUID로 엔터티 가져오기

가져오려는 항목의 GUID를 알고 있으면 entity 속성만 사용할 수 있습니다.

{
  actor {
    entity(guid: "ENTITY_GUID") {
      name
      entityType
    }
  }
}

이것은 검색 쿼리로 작성할 수도 있습니다.

{
  actor {
    entitySearch(query: "id = 'ENTITY_GUID'") {
      query
      results {
        entities {
          name
          entityType
        }
      }
    }
  }
}

또는 동시에 여러 항목을 가져오려면 entities 속성을 사용할 수 있습니다.

{
  actor {
    entities(guids: ["ENTITY_GUID_1", "ENTITY_GUID_2"]) {
      name
      entityType
    }
  }
}

그렇지 않으면 검색어를 사용하세요.

{
  actor {
    entitySearch(query: "id IN ('ENTITY_GUID_1', 'ENTITY_GUID_2')") {
      query
      results {
        entities {
          name
          entityType
        }
      }
    }
  }
}

쿼리 예시

쿼리는 데이터만 가져오기 위한 요청이며 다른 효과는 없습니다. NerdGraph 쿼리는 정적이 아닙니다. 즉, 필요에 따라 더 많거나 적은 데이터를 요청할 수 있습니다. 각 쿼리에 대해 스키마에서 지원하는 한 검색하려는 데이터를 정확히 지정할 수 있습니다.

NerdGraph의 엔터티는 개체가 공통 필드를 공유할 수 있도록 하는 개념인 GraphQL 인터페이스 에 의존합니다. 이러한 NerdGraph 쿼리 예제에서 볼 수 있듯이 인터페이스는 특정 엔터티 유형에 대한 데이터를 제공하는 데 사용됩니다.

엔터티 검색 쿼리 작성을 시작하는 방법을 잘 모르는 경우 NerdGraph를 사용하여 검색 쿼리를 작성하십시오. 다음으로, 엔터티 데이터와 빌드된 쿼리 문자열을 검색합니다.

queryBuilder 인수로 작성된 쿼리 문자열을 보려면 결과의 쿼리 필드를 요청하세요.
query 및 queryBuilder 인수를 동시에 사용할 수 없습니다.

NerdGraph GraphiQL 탐색기 를 사용하여 API를 탐색하고 인라인 문서를 사용하여 사용 가능한 쿼리 옵션을 확인하는 것이 좋습니다.

{
  actor {
    entitySearch(queryBuilder: { domain: APM, type: APPLICATION }) {
      query
      results {
        entities {
          reporting
          ... on AlertableEntityOutline {
            alertSeverity
          }
        }
      }
    }
  }
}

다양한 유형의 인프라 통합 엔터티가 있으며 다른 엔터티 유형과 별도로 나열됩니다. 탐색하려면 infrastructureIntegrationType 입력 인수를 사용하세요.

query 및 queryBuilder 인수를 동시에 사용할 수 없습니다.
type 입력 인수 대신 infrastructureIntegrationType 을 사용합니다.

NerdGraph GraphiQL 탐색기 를 사용하여 API를 탐색하고 인라인 문서를 사용하여 사용 가능한 쿼리 옵션을 확인하는 것이 좋습니다.

{
  actor {
    entitySearch(queryBuilder: { infrastructureIntegrationType: F5_NODE }) {
      query
      results {
        entities {
          entityType
          domain
        }
      }
    }
  }
}

New Relic의 경고 로 모니터링할 수 있는 개체의 경고 심각도를 가져옵니다. 이 NerdGraph 쿼리는 현재 애플리케이션에서 데이터를 수신하고 있는지 알려줍니다( reporting 필드 사용).

엔터티가 경고 가능한 유형인 경우 결과에 엔터티의 경고 심각도가 포함됩니다.

결과에 경고할 수 없는 항목이 포함된 경우 AlertableEntityOutline 필드는 포함되지 않습니다.

{
  actor {
    entitySearch(query: "name like 'nerdgraph' and alertSeverity is not null") {
      results {
        entities {
          reporting
          ... on AlertableEntityOutline {
            alertSeverity
          }
        }
      }
    }
  }
}

서로 다른 엔터티 유형에는 연결된 특정 데이터가 있습니다. 다음 NerdGraph 쿼리 예는 다음에 사용할 수 있는 필드 선택을 보여줍니다. 애플리케이션 엔티티:

쿼리에서 더 많은 요약 데이터를 요청할 수 있습니다.

다른 유형의 엔터티가 검색 결과에 반환되는 경우 이러한 필드는 포함되지 않습니다.

{
  actor {
    entitySearch(
      query: "name like 'nerdgraph' and domainType = 'APM-APPLICATION'"
    ) {
      results {
        entities {
          name
          ... on ApmApplicationEntityOutline {
            apmSummary {
              errorRate
              apdexScore
              webResponseTimeAverage
              responseTimeAverage
            }
          }
        }
      }
    }
  }
}

다양한 엔티티 유형에는 연관된 특정 데이터가 있습니다. 이 NerdGraph 쿼리 예제는 엔터티 유형에 관계없이 모든 엔터티의 이름과 APM, 브라우저 모니터링 및 모바일 엔터티에 대한 오류율을 요청합니다.

다른 유형의 엔터티가 검색 결과에 반환되면 오류율 필드가 포함되지 않습니다.

{
  actor {
    entitySearch(query: "name like 'nerdgraph'") {
      results {
        entities {
          name
          ... on ApmApplicationEntityOutline {
            apmSummary {
              errorRate
            }
          }
          ... on BrowserApplicationEntityOutline {
            browserSummary {
              jsErrorRate
            }
          }
          ... on MobileApplicationEntityOutline {
            mobileSummary {
              httpErrorRate
            }
          }
        }
      }
    }
  }
}

이 NerdGraph 쿼리 예제는 검색 결과에 반환된 모든 엔터티에 대한 태그를 가져옵니다. 자세한 내용은 NerdGraph GraphiQL 태깅 자습서 를 참조하십시오.

{
  actor {
    entitySearch(query: "name like 'nerdgraph'") {
      results {
        entities {
          name
          tags {
            key
            values
          }
        }
      }
    }
  }
}

이 NerdGraph 쿼리 예시는 INFRA 도메인에 속하고 awsRegion us-east-1 에 속하는 항목을 필터링하고 검색 결과에 해당 이름을 반환합니다.

{
  actor {
    entitySearch(
      query: "domain = 'INFRA' and tags.aws.awsRegion = 'us-east-1'"
    ) {
      results {
        entities {
          name
        }
      }
    }
  }
}

또한 주어진 태그가 있는지 여부에 따라 필터링을 수행할 수 있습니다. 다음 쿼리는 domainType BROWSER-APPLICATION 의 항목을 필터링하고 태그 clusterAgentId 를 정의합니다.

{
  actor {
    entitySearch(
      query: "domainType = 'BROWSER-APPLICATION' and tags.clusterAgentId is not null"
    ) {
      results {
        entities {
          name
        }
      }
    }
  }
}

자세한 내용은 NerdGraph GraphiQL 태깅 자습서 를 참조하십시오.

이 NerdGraph 쿼리 예시는 awsRegion us-east-1 에 속하는 domainType APM-APPLICATION 도메인의 엔터티를 필터링하고 검색 결과에 해당 이름을 반환합니다. 그런 다음 결과를 집계하여 New Relic 계정 ID별로 그룹화된 엔티티의 총 수를 가져옵니다.

{
  actor {
    entitySearch(query: "domainType = 'APM-APPLICATION'") {
      facetedCounts(facets: { facetCriterion: { facet: ACCOUNT_ID } }) {
        counts {
          count
          facet
        }
      }
    }
  }
}

또한 태그로도 집계를 수행할 수 있습니다. 다음 쿼리는 awsRegion us-east-1 에 속하는 domainType APM-APPLICATION 도메인의 항목을 필터링한 다음 결과를 집계하여 에이전트 언어별로 그룹화된 항목의 총 수를 가져옵니다.

{
  actor {
    entitySearch(
      query: "domainType = 'APM-APPLICATION' and tags.aws.awsRegion = 'us-east-1'"
    ) {
      facetedCounts(facets: { facetCriterion: { tag: "language" } }) {
        counts {
          count
          facet
        }
      }
    }
  }
}

자세한 내용은 NerdGraph GraphiQL 태깅 자습서 를 참조하십시오.

NerdGraph GraphiQL 탐색기는 엔터티 검색의 결과에 페이지를 매깁니다.

검색 기준이 단일 응답에서 API 제한인 200개 항목을 초과하고 나머지 결과를 보려면 초기 요청에서 nextCursor 을 요청하고 다른 쿼리에서 해당 값을 사용하여 검색할 수 있습니다. 다음 "페이지" 결과.

더 이상 결과가 없으면 nextCursor 은(는) null이 됩니다.

{
  actor {
    entitySearch(query: "name like 'nerd-graph'") {
      results {
        nextCursor
        entities {
          name
        }
      }
    }
  }
}

다음 검색에서 nextCursor 값을 사용합니다.

{
  actor {
    entitySearch(query: "name like 'nerd-graph'") {
      results(cursor: "next_cursor_value") {
        nextCursor
        entities {
          name
        }
      }
    }
  }
}

NerdGraph GraphiQL 탐색기를 사용하면 엔터티에 경고 가능 속성이 있을 때 표시하기 위해 경고 가능이 true|false인 엔터티를 필터링할 수 있습니다. 엔티티 정의 참조

위의 속성으로 필터링할 수 있습니다. 또한 필터링을 위해 태그를 사용할 수도 있습니다.

Alertable은 엔터티 유형 구성이므로 결과에 표시되지 않습니다.

{
  actor {
    entitySearch(query: "alertable is TRUE") {
      results {
        entities {
          name
        }
      }
    }
  }
}

쿼리에서 다른 필터와 결합할 수도 있습니다.

{
  actor {
    entitySearch(query: "domain='APM' and alertable is TRUE") {
      results {
        entities {
          name
        }
      }
    }
  }
}

NerdGraph GraphiQL 탐색기를 사용하면 보고가 true|false이고 lastReportingChangeAt 날짜 필드가 있는 엔터티를 필터링할 수 있습니다.

지난 몇 시간 동안 보고를 중지한 항목을 검색할 수 있습니다.

{
  actor {
    entitySearch(
      query: "reporting is false and lastReportingChangeAt > 1651708800000"
    ) {
      results {
        entities {
          name
        }
      }
    }
  }
}

엔터티 관계 만들기 또는 삭제

엔터티는 다른 엔터티와 관계를 가질 수 있습니다. 일부 관계는 New Relic에 의해 자동으로 생성되지만 변형을 사용하여 사용자 지정 관계를 생성하거나 삭제할 수도 있습니다. 이를 수행하는 방법에 대한 몇 가지 설명이 아래에 있지만 New Relic의 다양한 관계 유형을 이해하는 데 도움이 필요한 경우 엔터티 관계를살펴보십시오.

추가 관계를 수동으로 생성하거나 삭제하기 전에 다음 사항에 유의하십시오.

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

엔터티의 관계 나열

relatedEntities 필드를 사용하여 항목 쌍이 어떻게 상호 작용하고 관련되어 있는지 확인할 수 있습니다. 이를 통해 업스트림 및 다운스트림 서비스 문제를 해결하고 서비스 맵을 사용할 수 있는 방법과 유사하게 사소한 문제가 더 큰 영향을 미칠 수 있는 방법을 이해할 수 있습니다.

다음 예에서는 특정 GUID로 엔터티를 쿼리하는 방법을 보여줍니다.

query {
  actor {
    entity(guid: "ENTITY_GUID") {
      name
      relatedEntities {
        results {
          source {
            entity {
              guid
              name
            }
          }
          target {
            entity {
              guid
              name
            }
          }
          type
        }
      }
    }
  }
}

관계 만들기 또는 바꾸기

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

mutation {
  entityRelationshipUserDefinedCreateOrReplace(
    sourceEntityGuid: "SOURCE_ENTITY_GUID"
    targetEntityGuid: "TARGET_ENTITY_GUID"
    type: BUILT_FROM
  ) {
    errors {
      message
      type
    }
  }
}

관계 삭제

entityRelationshipUserDefinedDelete변형을 사용하여 항목 관계를 삭제합니다. 소스와 대상은 필수 항목이지만 유형은 필수 항목이 아닙니다. 유형 없이 변형을 실행하면 두 엔터티 간의 모든 관계가 제거됩니다.

mutation {
  entityRelationshipUserDefinedDelete(
    sourceEntityGuid: "SOURCE_ENTITY_GUID"
    targetEntityGuid: "TARGET_ENTITY_GUID"
    type: BUILT_FROM
  ) {
    errors {
      message
      type
    }
  }
}

항목 삭제

NerdGraph API를 사용하여 계정의 모든 항목을 수동으로 삭제할 수 있습니다. 이렇게 하려면 NerdGraph GraphiQL 탐색기 에서 엔터티의 GUID로 이 쿼리를 실행합니다.

mutation {
  entityDelete(guids: ["ENTITY_GUID_1", "ENTITY_GUID_2"]) {
    deletedEntities
    failures
  }
}

중요

현재 Nerdgraph API를 사용하여 다음 항목 유형 만 제거할 수 있습니다. APM-APPLICATION , EXT-SERVICE 및 REF-REPOSITORY .

New Relic 에이전트가 다시 색인을 생성하면 UI에서 삭제된 엔터티를 볼 수 있습니다.

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

NerdGraph 튜토리얼: 엔티티 데이터 보기

중요

시작하기 전에

엔터티 검색

주의

팁

다음으로 검색 `queryBuilder`

자유형으로 검색 `query`

GUID로 엔터티 가져오기

쿼리 예시

queryBuilder를 사용하여 엔터티 데이터 가져오기

검색 결과에서 인프라 통합 엔터티에 대한 데이터 가져오기

검색 결과에서 경고 가능한 엔터티에 대한 경고 정보 가져오기

검색 결과에서 APM 엔터티에 대한 요약 데이터 가져오기

검색 결과에서 각 항목 유형에 대한 데이터 가져오기

검색 결과의 각 항목에 대한 모든 태그 가져오기

태그를 사용하여 엔터티 결과 필터링

속성 또는 태그별로 결과 집계

페이지를 매긴 검색 결과에 대한 nextCursor 가져오기

경고 가능한 엔터티 가져오기

보고를 중지한 지 하루 이상 된 엔터티 가져오기

엔터티 관계 만들기 또는 삭제

엔터티의 관계 나열

관계 만들기 또는 바꾸기

관계 삭제

항목 삭제

중요

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

NerdGraph 튜토리얼: 엔티티 데이터 보기

중요

시작하기 전에

엔터티 검색

주의

팁

다음으로 검색 queryBuilder

자유형으로 검색 query

GUID로 엔터티 가져오기

쿼리 예시

검색 결과에서 인프라 통합 엔터티에 대한 데이터 가져오기

검색 결과에서 경고 가능한 엔터티에 대한 경고 정보 가져오기

검색 결과에서 APM 엔터티에 대한 요약 데이터 가져오기

검색 결과에서 각 항목 유형에 대한 데이터 가져오기

검색 결과의 각 항목에 대한 모든 태그 가져오기

태그를 사용하여 엔터티 결과 필터링

속성 또는 태그별로 결과 집계

페이지를 매긴 검색 결과에 대한 nextCursor 가져오기

경고 가능한 엔터티 가져오기

보고를 중지한 지 하루 이상 된 엔터티 가져오기

엔터티 관계 만들기 또는 삭제

엔터티의 관계 나열

관계 만들기 또는 바꾸기

관계 삭제

항목 삭제

중요

다음으로 검색 `queryBuilder`

자유형으로 검색 `query`