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

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

• account
• accountId

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

• 자바 에이전트 태그 구성

• .NET 에이전트 태그 구성

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

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

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

  • language: (예: java 또는 python)

• 호스트 엔터티의 경우

  • awsRegion, 해당하는 경우

  클라우드 공급자 통합 (AWS, Azure 또는 Google Cloud Platform) 중 하나를 사용하는 경우 호스트에 인프라 에이전트를 설치하는 것이 좋습니다. 이렇게 하면 New Relic에서 모니터링되는 호스트 엔터티에 클라우드 환경 태그가 추가됩니다.

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

• k8s.cluster.name

• k8s.deployment.name

• k8s.namespace.name

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

• telemetry.sdk.version

• service.namespace

  이 자동 태깅은 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

예를 들어 SensitiveEntity라는 항목을 소유한 내부 팀을 찾으려면 다음을 실행하세요.

FROM SystemSample SELECT internalOwningTeam WHERE entityName = 'SensitiveEntity'

CPU가 있는 다른 인프라 엔터티에서 일부 부하 테스트를 수행하려고 한다고 가정해 보겠습니다. A 그룹의 항목에 한 가지 처리를 적용하고, B 그룹의 항목에 다른 처리를 적용하고, control group 라는 처리가 없는 하나의 항목 그룹을 유지할 수 있습니다.

New Relic UI에서 각 엔티티가 속한 실험 그룹에 매핑된 experimentGroup 라는 태그를 생성할 수 있습니다. New Relic UI에서 생성된 태그이므로 newrelic-infra.yml 구성 파일에서 생성된 사용자 정의 속성과 달리 태그 이름에 tags. 접두사를 추가해야 합니다.

다음은 cpuPercent) 선택하는 NRQL 쿼리이며 FACET CASES (...) 절을 사용하여 다양한 실험 그룹으로 분류됩니다.

FROM SystemSample SELECT cpuPercent FACET CASES (WHERE tags.experimentGroup = 'control' AS 'control group', WHERE tags.experimentGroup = 'A' AS 'given treatment A', WHERE tags.experimentGroup = 'B' AS 'given treatment B') SINCE 1 DAY AGO

인프라 태그에 대한 태그 전파를 끄려면 NerdGraph 에서 다음을 실행합니다.

mutation {
  dataManagementUpdateFeatureSettings(
    accountId: YOUR_ACCOUNT_ID
    setting: {
      enabled: false
      featureSetting: { key: "infra_tag_propagation" }
      locked: false
    }
  ) {
    enabled
    key
    locked
    name
  }
}

해당 호출은 다음 응답을 반환해야 합니다.

{
  "data": {
    "dataManagementUpdateFeatureSettings": {
      "enabled": false,
      "key": "infra_tag_propagation",
      "locked": false,
      "name": "Infra tag propagation"
    }
  }
}