NerdGraph 튜토리얼: 태그 보기 및 추가

NerdGraph API 를 사용하여 데이터에 태그 를 추가하여 데이터 구성 및 검색 가능성을 개선할 수 있습니다.

개요

이 문서는 NerdGraph API를 사용하여 태그를 추가하고 관리하는 방법을 설명합니다. 이것은 태그를 추가하는 한 가지 방법일 뿐입니다. 다른 방법은 태그 추가 방법 을 참조하십시오. CLI 도구를 사용하여 태그를 자동화하는 방법은 개발자 사이트 를 참조하십시오.

엔터티에 대한 태그 읽기

이러한 쿼리를 구성하고 응답을 보려면 다음을 수행합니다.

api.newrelic.com/graphiql에서 NerdGraph GraphiQL 탐색기로 이동합니다.
entitySearch() 을 사용하여 항목을 찾은 다음 해당 태그를 가져옵니다.
NerdGraph의 태그 API를 사용하여 기존 태그와 해당 값을 읽으십시오.

이 예에서 엔티티는 Cookie Checkout 이라는 브라우저 앱입니다.

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

실제 값은 데이터에 따라 다릅니다. New Relic GraphiQL 탐색기 를 사용하여 쿼리를 실험해 보십시오.

엔터티에 대한 태그 추가

엔터티에 대한 새 태그를 추가하려면:

api.newrelic.com/graphiql에서 NerdGraph GraphiQL 탐색기로 이동합니다.
entitySearch() 을 사용하여 태그를 지정하려는 항목의 GUID를 찾습니다.
taggingAddTagsToEntity 변형을 사용하여 값이 있는 태그를 항목에 추가합니다.
에이전트의 경우 새 태그를 추가한 후에는 다시 시작해야 합니다.

이 예에는 UI 팀이 소유한 Cookie Checkout 이라는 브라우저 애플리케이션이 있습니다. 이 인스턴스에 값이 ui 인 team 태그를 추가하려고 합니다. 태그가 추가되면 team:ui 태그로 필터링하고 New Relic UI에서 Cookie Checkout 앱을 찾을 수 있습니다.

mutation {
  taggingAddTagsToEntity(
    guid: "ENTITY_GUID"
    tags: { key: "team", values: ["ui"] }
  ) {
    errors {
      message
    }
  }
}

엔터티에서 태그 제거

엔터티에서 태그 및 연결된 모든 값을 삭제하려면 다음을 수행합니다.

api.newrelic.com/graphiql에서 NerdGraph GraphiQL 탐색기로 이동합니다.
entitySearch() 을 사용하여 제거하려는 태그가 있는 항목의 GUID를 찾습니다.
taggingDeleteTagFromEntity 돌연변이를 사용합니다.
에이전트의 경우 태그를 변경한 후에는 다시 시작해야 합니다.

다음 예시 변형은 항목에서 team 태그를 제거합니다.

mutation {
  taggingDeleteTagFromEntity(guid: "ENTITY_GUID", tagKeys: ["team"]) {
    errors {
      message
    }
  }
}

항목의 특정 태그 값 삭제

전체 태그와 해당 값을 모두 삭제하는 대신 단일 태그 값을 삭제할 수 있습니다.

api.newrelic.com/graphiql에서 NerdGraph GraphiQL 탐색기로 이동합니다.
entitySearch() 을 사용하여 제거하려는 태그가 있는 항목의 GUID를 찾습니다.
taggingDeleteTagValuesFromEntity 돌연변이를 사용합니다.

다음 예시 변형은 tag 키에서 ui 값을 삭제합니다.

mutation {
  taggingDeleteTagValuesFromEntity(
    guid: "ENTITY_GUID"
    tagValues: [{ key: "team", value: "ui" }]
  ) {
    errors {
      message
    }
  }
}

tagValues 은 배열이므로 하나의 변형으로 단일 항목에서 여러 특정 값을 삭제할 수 있습니다.

엔터티의 모든 태그 값 바꾸기

엔티티의 전체 태그 세트를 제공된 태그 세트로 바꾸려면:

api.newrelic.com/graphiql에서 NerdGraph GraphiQL 탐색기로 이동합니다.
entitySearch() 을 사용하여 제거하려는 태그가 있는 항목의 GUID를 찾습니다.
taggingReplaceTagsOnEntity 돌연변이를 사용합니다.

이 예에서 Cookie Checkout 브라우저 애플리케이션은 ui 팀에서 cookie-dev 팀으로 이전되었습니다. team 의 태그 값을 다음 변형으로 바꿀 수 있습니다.

mutation {
  taggingReplaceTagsOnEntity(
    guid: "ENTITY_GUID"
    tags: { key: "team", values: ["cookie-dev"] }
  ) {
    errors {
      message
    }
  }
}

사용자의 편의를 위해 제공되는 기계 번역입니다.