• 로그인무료 계정

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

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

문제 신고

태그를 사용하여 데이터 구성 및 찾기

소프트웨어 산업에서 태그 는 일반적으로 데이터 구성 및 검색 가능성을 개선하기 위해 데이터 세트에 추가된 메타데이터 조각을 나타냅니다.

New Relic에서 태그는 모니터링되는 앱 및 호스트, 에이전트, 대시보드 및 워크로드 와 같은 다양한 데이터 세트에 추가된 키:값 쌍(예 team: operations )입니다. 몇 가지 중요한 속성 을 태그로 제공합니다(예: 앱 이름 및 언어와 같은 앱 메타데이터, 호스트 이름 및 AWS 리전과 같은 호스트 메타데이터). 사용자 정의 태그를 추가할 수도 있습니다.

UI에서 태그를 사용하여 관련 데이터로 필터링할 수 있습니다. 다음은 예입니다.

New Relic filtering workloads using tags

여기에서 특정 계정에 대한 워크로드 를 필터링하는 데 사용되는 accountId 태그를 볼 수 있습니다.

태그는 다음을 수행하는 데 도움이 됩니다.

  • 다수의 소스 및/또는 다수의 New Relic 계정으로 들어오는 데이터를 구성합니다.
  • 누가 무엇을 담당하는지 알기 위해 팀, 역할, 환경 또는 지역을 식별합니다(예시 사용 사례 참조).
  • 대시보드와 워크로드 를 더 잘 구성하고 검색합니다.
  • 쿼리 및 차트 APM 데이터 .

태그는 높은 수준에서 데이터를 구성하는 데 유용합니다. 사용자 이름 또는 기타 높은 카디널리티 값 캡처와 같이 보다 세분화된 세부 정보를 추가하려는 경우 사용자 지정 속성 또는 사용자 지정 이벤트 가 더 나은 솔루션입니다.

태그는 이전에 New Relic UI에서 labels 이라고 불렸습니다. 때때로 코드에서 label 을 볼 수 있습니다. 예를 들어 일부 APM 에이전트 구성 파일은 태그에 label 구성 옵션을 사용합니다.

태그 형식 및 제한

태그에 대한 형식 요구 사항 및 제한:

  • UI에는 엔터티당 표시할 수 있는 총 태그 수에 제한이 있습니다.

    • 기본적으로 보고되거나 에이전트/통합 구성을 통해 추가되는 태그의 경우 100개로 제한됩니다.
    • UI 또는 API를 통해 추가된 사용자 정의 태그는 100개로 제한됩니다.
  • 다음은 태그의 최대 문자 길이입니다.

    • 키: 128자
    • 값: 256자
  • 허용되는 문자:

    • 문자는 UTF-8이어야 합니다.
    • NerdGraph를 사용하여 태그를 추가 할 때 태그 키의 대시( - )는 빼기 기호로 해석됩니다. 태그 키에 대시가 있는 경우에는 그 주위에 백틱을 사용하세요(예: `key-name` ).

모범 사례 및 팁

태그를 추가 하기 전에 기본 태그가 어떻게 작동하는지 먼저 확인하는 것이 좋습니다. 고유한 태그를 추가할 준비가 되면 다음 모범 사례 팁을 검토하여 태그를 최대한 활용하세요.

태그를 단순하게 유지하기 위한 팁:

  • 확실히 사용할 것으로 알고 있는 태그만 추가하는 것으로 시작하십시오. 사용하지 않는 태그는 노이즈를 생성하고 혼란을 가중시킬 수 있습니다.
  • 짧은 태그를 사용해 보세요. 짧은 태그는 구문 분석하기 쉽고 UI는 때때로 긴 태그를 잘릴 수 있습니다. ( 글자 제한 참조)
  • 가능하면 사람이 읽을 수 있는 키와 값을 사용하세요(예 region: EMEA is better than Param8323 : 1229072 ).
  • 다음과 같은 여러 값을 포함하지 마십시오지역: EMEA | 미국 | LATAM . region: emea , region: us region: latam 과 같이 세 가지 다른 태그를 사용하는 것이 좋습니다. 여러 태그를 일치시키려면 필터 UI의 고급 옵션을 사용하여 일치시킬 수 있습니다.

일관되게 태그를 사용하기 위한 팁:

  • 팀과 엔터티 전반에 걸쳐 태그 언어와 일관성을 유지하십시오.
  • 명명과 일관성을 유지하십시오. 예를 들어 region: emeareg: emea 를 모두 사용하지 마십시오.
  • 형식을 일관되게 유지하십시오. 예를 들어, camelCasekebab-case 를 모두 사용하지 마십시오.
  • 태그 검색은 UI 및 API에서 대소문자를 구분하지 않지만 대소문자를 일관되게 사용하십시오. 예를 들어, env: stagingenv: Staging 을 모두 사용하지 마십시오.

팀 간 구현에 대한 팁:

태그는 관찰 가능성과 비용 할당을 개선하는 데 도움이 됩니다. 이러한 이유로 태그 구현에 대한 책임은 종종 관찰 가능성 팀, SRE, 설계자 그룹 또는 팀 간 태스크 포스에 할당됩니다.

태그 구현을 담당하는 사람들은 태그 정의 방법과 사용 규칙을 설명하는 내부 정책을 충족하고 생성할 것을 권장합니다. 그 다음에:

  • 이 참조 설명서를 최신 상태로 유지하십시오.
  • New Relic 에이전트를 배포할 때 클라우드 공급자에서 또는 API 또는 Terraform과 같은 New Relic 자동화 도구를 통해 태그 정의를 자동화하십시오.
  • 태그 지정 표준을 준수하지 않는 엔터티를 식별하는 반복 보고서를 만듭니다.

태그 예

다음은 태그를 사용하여 데이터를 구성하는 일반적인 방법의 몇 가지 예입니다.

태그 추가 방법

일부 중요한 속성 은 기본적으로 태그로 사용할 수 있습니다. 예를 들어 계정 이름, 계정 ID 및 일부 기본 호스트/서버 메타데이터를 기본 태그로 사용할 수 있습니다. 이러한 기본적으로 사용 가능한 태그는 제거할 수 없습니다.

다음은 일부 특정 데이터 소스에 태그를 추가하는 방법에 대한 몇 가지 세부정보입니다.

태그를 사용하여 UI 필터링

New Relic advanced tag filter query

New Relic Explorer 상단에 있는 필터 필드를 사용하여 관심 있는 개체로 필터링하십시오. 여러 필터 조건을 사용할 수 있습니다.

태그를 사용하여 특정 엔터티로 필터링하려면:

  1. one.newrelic.com 에서 탐색기 를 클릭합니다.
  2. 사용 가능한 속성 및 태그의 드롭다운을 보려면 필터링 기준... 필드를 클릭합니다.
  3. 여러 요소로 필터링하고 고급 검색 옵션을 사용할 수 있습니다.

UI에서 엔터티의 메타데이터 및 태그를 찾으려면 다음 두 가지 옵션이 있습니다.

  • UI의 엔터티 목록에서 맨 오른쪽에 있는 엔터티의 상.

    또는

  • 엔터티를 선택합니다. 페이지 상단에서 상.

API를 사용하여 태그를 보려면 NerdGraph 문서 를 참조하십시오.

대시보드에서 태그를 사용하는 방법과 워크로드에서 태그를 사용하는 방법에 대해 알아보세요.

맞춤 쿼리, 차트 및 알림

기능마다 태그를 다르게 처리합니다. 다음은 NRQL 을 사용하여 태그 데이터를 쿼리하거나 NRQL 상태 경고 를 생성하는 방법에 대한 몇 가지 세부 정보입니다.

APM 태그에 대한 쿼리 및 경고

NRQL을 사용하여 APM 태그를 쿼리할 수 있습니다. 최소 에이전트 버전 :

  • C: 사용할 수 없음
  • Go: 2.3.0
  • Java: 4.9.0
  • .NET: 8.17
  • Node: v4.13.0
  • PHP: 사용할 수 없음
  • Python: v4.10.0.112
  • Ruby: 6.1.0.352

다음은 몇 가지 쿼리 예입니다.

속성에 대한 쿼리 및 경고

태그 소스 정보 에 설명된 대로 몇 가지 중요한 속성 이 태그로 사용됩니다. NRQL 을 사용하여 모든 속성을 쿼리하고 사용자 정의 차트를 생성하고 NRQL 경고 조건 을 생성할 수 있습니다.

Copyright © 2022 New Relic Inc.