• /
  • 로그인
  • 무료 계정

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

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

문제 신고

대시보드 API 마이그레이션: Insights API에서 NerdGraph로

Insights Dashboard API 는 더 이상 사용되지 않지만 NerdGraph (GraphQL API)를 사용하여 대시보드를 만들고 구성할 수 있습니다.

이전 Insights API에서 마이그레이션하지 않는 경우 이 문서를 건너뛰고 새 Dashboards API 로 이동할 수 있습니다.

왜 새로운 대시보드 API입니까?

데이터를 쿼리하고 차트 및 대시보드를 생성하는 방법이었던 Insights 제품은 더 이상 사용되지 않으며 해당 기능 집합이 New Relic One 플랫폼 의 핵심 부분으로 이전되었습니다. 이 전환 및 새로운 기능에 대한 자세한 내용은 Insights to New Relic One 마이그레이션 가이드를 참조하십시오.

Insights Dashboard API는 2021년 7월에 더 이상 사용되지 않습니다. 그때까지 Insights Dashboard API를 사용하는 경우 NerdGraph를 사용하도록 전환을 시도해야 합니다. ( Insights 쿼리 API 는 더 이상 사용되지 않지만 NerdGraph가 선호됩니다.) NerdGraph를 시작하는 방법과 동등한 작업에 대해 알아보려면 계속 읽으십시오.

NerdGraph 시작하기

NerdGraph 는 New Relic 데이터의 NRQL 쿼리를 만드는 데 선호되는 API입니다. NerdGraph를 사용하는 모든 사용자는 자신의 사용자 키 가 필요합니다.

NerdGraph를 사용할 때 대시보드 가 모니터링되는 앱, 호스트 및 서비스와 같은 다른 엔터티의 데이터를 보고하는 엔터티 임을 이해하는 데 도움이 됩니다.

NerdGraph 및 GraphQL을 처음 사용하는 경우 먼저 NerdGraph 소개 및 일부 NerdGraph로 대시보드 생성 을 읽고 싶을 수 있습니다.

NerdGraph API 탐색기는 api.newrelic.com/graphiql 에 있습니다.

작업 매핑 테이블

아래 표는 모든 Insights API 작업을 새 대시보드 API에 매핑합니다.

Insights API 작업NerdGraph API 쿼리/변이Notes
List (GET)entitySearch()필터와 일치하는 페이지를 매긴 대시보드 목록을 봅니다.
Show (GET)entity()엔터티 guid가 지정된 기존 대시보드를 봅니다.
Create (POST)dashboardCreate()새 대시보드를 만듭니다.
Update (PUT)dashboardUpdate()엔터티 guid가 지정된 기존 대시보드를 업데이트합니다.
Delete (DELETE)dashboardDelete()엔터티 guid가 지정된 기존 대시보드를 삭제합니다.

대시보드 속성 매핑 테이블

새 대시보드 GraphQL 스키마의 모든 필드에 대한 자세한 내용은 NerdGraph의 GraphiQL 탐색기 를 참조하십시오.

아래 표는 Insights API의 대시보드 속성을 새 대시보드 API에 매핑합니다.

Insights API 대시보드 속성NerdGraph API 대시보드 속성Notes
id유구한이제 대시보드가 나타내는 New Relic 엔터티의 ID
createdAtcreatedAt
updatedAtupdatedAt
title이름
editablepermissions동일한 개념으로 병합된 editablevisibility
visibilitypermissions동일한 개념으로 병합된 editablevisibility
descriptiondescription
metadata-GraphQL API에서 버전 관리 불필요
icon-New Relic One으로 번역되지 않음
grid_column_count-New Relic One의 기본 12열 대시보드
filter-아직 New Relic One으로 번역되지 않음

위젯 속성 매핑 테이블

새 대시보드 GraphQL 스키마의 모든 필드에 대한 자세한 내용은 NerdGraph의 GraphiQL 탐색기 를 참조하십시오.

아래 표는 Insights API의 위젯 속성을 새 대시보드 API에 매핑합니다.

Insights API 대시보드 속성NerdGraph API 대시보드 속성Notes
idid
account_id-하나가 필요한 위젯 구성으로 번역
visualizationvisualization
presentation.titletitle
Presentation.drilldown_dashboard_idlinkedEntities패싯 연결 기능을 위해 위젯을 대시보드에 연결하는 데 사용됩니다.
presentation.notes-아직 New Relic One으로 번역되지 않음
layoutlayout
dataconfiguration + rawConfiguration

모든 유형의 위젯을 빌드하는 방법을 배우려면 대시보드 위젯 만들기 를 참조하십시오.

시각화 매핑 테이블

실제로는 같지만 다른 유형의 쿼리를 통해 얻은 위젯 시각화를 그룹화하여 위젯 시각화를 단순화했습니다. 예를 들어, 라인 line_chart 은 쿼리 comparison_line_chart 에 관계없이 동일한 방식으로 표시됩니다.

Insights API 시각화NerdGraph API 시각화
uniques_listviz.table
single_eventviz.table
facet_tableviz.table
event_tableviz.table
faceted_area_chartviz.area
predefined_metric_chart.application_breakdownviz.area
predefined_metric_chart.scope_breakdownviz.area
predefined_metric_chart.browser_breakdownviz.area
predefined_metric_chart.background_breakdownviz.area
predefined_metric_chart.solr_breakdownviz.area
predefined_metric_chart.gc_runs_breakdownviz.area
facet_bar_chartviz.bar
billboardviz.billboard
attribute_sheetviz.billboard
billboard_comparisonviz.billboard
gaugeviz.bullet
event_feedviz.event-feed
funnelviz.funnel
heatmapviz.heatmap
histogramviz.histogram
inventoryinfra.inventory
raw_jsonviz.json
line_chartviz.line
comparison_line_chartviz.line
faceted_line_chartviz.line
metric_line_chartviz.line
markdownviz.markdown
facet_pie_chartviz.pie

예: REST 끝점에서 GraphQL 쿼리/변이로

GraphQL 형식 API인 NerdGraph의 주요 이점 중 하나는 API 데이터에 대한 완전하고 이해할 수 있는 설명을 제공한다는 것입니다. NerdGraph API 탐색기 를 사용하여 간단한 설명과 함께 GraphQL 유형 및 필드를 발견할 수 있습니다.

Insights API 에서 새로운 New Relic One 대시보드 API로의 마이그레이션을 용이하게 하고자 합니다. 이전 REST 엔드포인트가 새 GraphQL 쿼리 또는 변형에 매핑되는 방법을 보여주는 몇 가지 예를 아래에서 찾으십시오.

List (GET) -> entitySearch 쿼리

New Relic One의 대시보드는 엔티티 개념을 수용합니다. 그들은 이제 New Relic의 엔티티 생태계의 또 다른 엔티티입니다.

NerdGraph GraphiQL 탐색기 를 사용하여 사용해 보십시오.

표시(GET) -> 엔터티 쿼리

대시보드에서 정보를 얻으려면 고유한 엔터티 식별자 또는 엔터티 guid를 제공하기만 하면 됩니다. 그런 다음 GraphQL 쿼리에 추가하여 관심 있는 모든 대시보드 속성에 액세스할 수 있습니다.

NerdGraph GraphiQL 탐색기 를 사용하여 사용해 보십시오.

Create (POST) -> dashboardCreate 돌연변이

시스템 상태를 변경하는 작업은 GraphQL API의 돌연변이입니다. dashboardCreate 변형에 필요한 입력을 제공하여 대시보드를 생성할 수 있습니다. GraphQL API는 자체 설명을 목표로 하지만 Nerdgraph 문서는 대시보드 위젯을 빌드하는 방법에 대한 문서와 같은 필드에 대한 일부 정보를 제공할 수 있습니다.

NerdGraph GraphiQL 탐색기 를 사용하여 사용해 보십시오.

Update (PUT) -> dashboardUpdate 돌연변이

dashboardUpdate 변형을 사용하면 기존 대시보드 guid와 새 구성을 제공하여 기존 대시보드를 업데이트할 수 있습니다. 대시보드를 생성하는 것과 유사하게 변형은 자체 설명을 시도하지만 대시보드 위젯을 빌드하는 방법에 대한 문서를 찾아볼 수 있습니다.

NerdGraph GraphiQL 탐색기 를 사용하여 사용해 보십시오.

Delete (DELETE) -> dashboardDelete 삭제

dashboardDelete 변형을 사용하면 엔터티 guid를 제공하여 기존 대시보드를 삭제할 수 있습니다.

NerdGraph GraphiQL 탐색기 를 사용하여 사용해 보십시오.

문제 신고
Copyright © 2022 New Relic Inc.