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

New Relic은 계정 정보를 포함하는 엔터티에 특정 태그를 자동으로 적용합니다. 이러한 태그에는 다음이 포함됩니다.

• account
• accountId

New Relic 에이전트는 데이터에서 생성된 엔터티에 태그를 적용하도록 구성할 수 있습니다. 구성 옵션은 다소 에이전트마다 다르지만 일반적으로 labels 키를 사용합니다. 몇 가지 예:

• Java 에이전트 태그 구성

• .NET 에이전트 태그 구성

  적용된 태그 에이전트의 배포된 각 인스턴스가 서로 다른 값을 보내도록 구성할 수 있기 때문에 에이전트 구성은 지정된 엔터티의 지정된 태그 키에 대해 여러 값을 생성할 수 있습니다.

New Relic 에이전트는 환경에 따라 특정 태그를 서비스 엔터티에 자동으로 적용합니다. 여기에는 다음이 포함됩니다(이에 국한되지 않음).

• 서비스/애플리케이션 엔터티용

  • language: 값은 예를 들어 java , python 등입니다.

• 호스트 엔터티의 경우

  • awsRegion, 해당하는 경우

특정 OpenTelemetry 리소스 속성은 엔티티 태그로 자동 적용됩니다. 서비스 엔터티와 연결된 범위 데이터에 다음 속성이 있으면 해당 엔터티에 연결됩니다.

• k8s.cluster.name

• k8s.deployment.name

• k8s.네임스페이스.이름

• telemetry.sdk.언어: 라는 이름의 태그로 저장됩니다. language

• 원격 측정.sdk.버전

• 서비스.네임스페이스

  이 자동 태깅은 GitHub 에 문서화된 New Relic 엔티티 합성을 사용하여 수행됩니다. OpenTelemetry 서비스의 경우 태깅 정의는 ext-service 엔터티에 있습니다.

1. 조건으로 이동합니다.

2. 양식 상단의 조건 이름 근처에서 태그 관리 를 클릭합니다.

3. 팝업 메뉴에서 태그를 추가하거나 삭제합니다.

   NerdGraph API를 통해 경고 조건에 엔터티로 태그를 추가할 수도 있습니다('태그 관리' 화면에서 조건의 엔터티 GUID 활용).

   NerdGraph API를 통한 데이터 태그 지정 에 대한 자세한 내용은 자습서를 참조하십시오.

CLI 도구를 사용하여 태그를 자동화하는 방법에 대한 가이드는 개발자 사이트 를 참조하십시오.

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

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

• 다음은 태그의 최대 문자 길이입니다.

  • 키: 128자
  • 값: 256자

• 허용되는 문자:

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

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

• 확실히 사용할 것으로 알고 있는 태그만 추가하는 것으로 시작하십시오.사용하지 않는 태그는 노이즈를 생성하고 혼란을 가중시킬 수 있습니다.

• 짧은 태그를 사용해 보세요. 짧은 태그는 구문 분석하기 쉽고 UI는 때때로 긴 태그를 잘릴 수 있습니다. ( 글자 제한 참조)

• 가능하면 사람이 읽을 수 있는 키와 값을 사용하세요(예: region: EMEA 가 Param8323 : 1229072 보다 좋음).

• 단일 태그에 regions: EMEA | US | LATAM 과 같은 여러 값을 포함하지 마십시오. region: emea , region: us 및 region: latam 과 같이 세 가지 다른 태그를 사용하는 것이 좋습니다. 여러 태그를 일치시키려면 필터 UI의 고급 옵션을 사용하여 일치시킬 수 있습니다.

  • 경고 인시던트 에 대한 주의 사항: 이는 하나의 키 이름 인스턴스만 지원합니다. 여러 키 이름을 사용하는 경우 해당 인시던트에 추가할 키 이름이 무작위로 선택됩니다.

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

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

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

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

팀 이름에 대한 태그를 생성하면 성능 문제를 야기한 변경에 대해 책임이 있는 팀, 그룹, 부서 또는 지역을 이해하는 데 도움이 될 수 있습니다.

### Team tags
team: backend
team: frontend
team: db
### Role tags
roles: architecture
roles: devops
roles: pm
### Region tags
region: emea
region: america
region: asia

그들이 속한 환경에 대한 엔티티를 생성할 수 있습니다.예를 들어:

env: production
env: qa
env: development
env: staging

중요도 수준과 관련된 태그를 생성하여 가장 중요한 문제를 더 쉽게 추적할 수 있습니다.예를 들어:

layer: level1
layer: level2
layer: level3

9개의 샤드에 분산된 서비스가 주어지면 각 샤드는 environment 으로 할당되므로 다음과 같은 와일드카드 쿼리를 사용하여 모든 샤드의 트랜잭션 처리량을 그릴 수 있습니다.

SELECT rate(count(apm.service.transaction.duration), 1 minute)
  FROM Metric WHERE appName LIKE 'MyApp (%' AND transactionType = 'Other'
  FACET tags.Environment TIMESERIES

특정 팀의 서비스당 트랜잭션 수를 보려면 다음과 같은 쿼리를 사용할 수 있습니다.

FROM Transaction SELECT count(*)
  WHERE tags.Team = 'team-a'
  FACET tags.Project TIMESERIES

각 서비스에 대한 규칙을 만들지 않고도 서비스의 오류율에 대한 쿼리를 사용하여 경고를 설정할 수 있습니다. 다음은 team-b 이라는 팀의 모든 서비스에 대한 오류율입니다. 그리고 이 경고는 팀 태그로 추가된 모든 새 앱 이름을 자동으로 모니터링합니다.

FROM Metric SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE tags.Team = 'team-b' FACET appName

이와 관련하여 여러 환경에 배포된 특정 서비스에 대한 일반 규칙을 생성하여 각 환경을 개별적으로 모니터링하는 단일 서비스에 대한 경보를 생성할 수 있습니다.

From Metric SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE tags.Project = 'MyProject' FACET tags.Environment