메트릭과 태그 이름을 지정할 때 참고할 수 있는 모범 사례가 있나요?

Datadog은 메트릭, 태그, 서비스 이름 지정과 관련해 모범 사례를 제공합니다.

메트릭 이름 지정에 관한 규칙 및 모범 사례

  • 메트릭 이름은 문자로 시작해야 합니다.
  • ASCII 영숫자, 밑줄, 마침표만 사용할 수 있습니다. 다른 문자는 밑줄로 변환됩니다.
  • 200자를 초과할 수 없습니다 (UI를 고려해 100자 미만으로 하는 것이 좋습니다).
  • 유니코드는 지원되지 않습니다.
  • 띄어쓰기는 사용하지 않는 것이 좋습니다.

에이전트가 보고하는 메트릭은 의사 계층적 점선 형식입니다 (예:http.nginx.response_time). 의사 계층 구조인 이유는 실제로 계층을 적용하는 것이 아니라 특정 관계를 유추하기 때문입니다 (예: “호스트A와 호스트B가http.nginx.*를 보고하므로, 웹 프론트엔드일 것이다”).

참고: Datadog에서 메트릭 이름은 대소문자를 구분합니다.

태그 이름 지정에 관한 규칙과 모범 사례

Datadog에서는 태그를 할당할 때 통합 서비스 태깅을 사용하시길 모범 사례로 권장합니다. 통합 서비스 태깅은 표준 태그 3가지(env, service, version)를 사용하여 Datadog 원격 측정 데이터와 결합합니다. 사용자의 환경에서 통합형 태깅을 설정하는 방법을 자세히 알아보려면 [통합 서비스 태깅][8] 가이드를 참조하세요.

  • 태그는 문자로 시작해야 합니다.
  • 영문자, 밑줄, 빼기 기호, 콜론, 마침표, 슬래시를 사용할 수 있습니다. 다른 문자는 밑줄로 변환됩니다.
  • 변환된 문자이든 본래 태그 값이든, 후행 밑줄은 모두 제거됩니다.
  • 연속된 밑줄은 하나의 밑줄로 축소됩니다.
  • 태그 이름은 최대 200자까지 지정할 수 있으며, 유니코드를 지원합니다.
  • 태그는 소문자로 변환됩니다.
  • 최적의 기능을 위해 key:value 구문을 사용하는 것이 좋습니다.

일반적으로 많이 사용되는 메트릭 태그 키는 instance, name, role입니다.

참고 자료

Additional helpful documentation, links, and articles: