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
          }
        }
      }
    }
  }

  복사