토리맘의 한글라이즈 프로젝트 logo 토리맘의 한글라이즈 프로젝트

프로메테우스 공식 레퍼런스를 한글로 번역한 문서입니다.

전체 목차는 여기에 있습니다.


이 문서에서 제시하는 메트릭과 레이블 컨벤션들은 프로메테우스를 사용하는 데 반드시 필요한 건 아니지만 스타일 가이드이자 베스트 프랙티스라고 봐주면 된다. 사용하는 조직에 따라, 이 중 네이밍 컨벤션같은 일부 프랙티스는 다르게 가져갈 수도 있다.

목차


Metric names

메트릭명은…

경험상 모든 차원dimension에서 sum()이나 avg()를 계산했을 때 의미가 있는 (항상 유용한 건 아니지만) 데이터를 하나의 메트릭으로 두는 게 좋다. 계산해도 별 의미가 없다면 데이터를 여러 메트릭으로 분할해라. 예를 들어, 다양한 대기열들의 용량을 하나의 메트릭으로 저장하는 것은 괜찮지만, 현재 대기열에 있는 요소 갯수를 대기열 용량과 같이 저장하는 것은 좋지 않다.


Labels

측정하는 대상의 특성들은 레이블을 이용해 구분해라:

메트릭명에는 레이블 이름을 넣지 마라. 굳이 중복으로 넣을 필요도 없으며, 레이블들을 모아 집계한다면 오히려 더 혼란스러울 거다.

주의: 고유한 키-값 레이블 쌍 조합마다 다른 시계열을 나타낸다는 점을 기억해두자. 레이블을 어떻게 사용하느냐에 따라 저장하는 데이터 양이 극단적으로 늘어날 수도 있다. 사용자 ID, 이메일 주소같이 값에 제한이 없는 데이터처럼, 카디널리티가 매우 높은 (레이블 값이 매우 다양한) 데이터는 레이블을 이용해 차원을 나누면 안 된다.


Base units

프로메테우스는 어떤 단위도 하드 코딩하지 않는다. 호환성을 지키려면 기본 단위를 사용해야 한다. 다음은 기본 단위와 함께 몇 가지 메트릭 패밀리를 정리해둔 테이블이다. 이 목록에 있는 게 전부는 아니다.

Family Base unit Remark
Time seconds  
Temperature celsius 실용적인 면에서 켈빈kelvin보단 섭씨celsius를 선호한다. 색온도같은 특이 케이스나 절대 온도를 측정해야 하는 경우엔 켈빈을 기본 단위로 사용할 수 있다.
Length meters  
Bytes bytes  
Bits bytes 비트가 더 흔히 보인다고 하더라도, 다른 메트릭들을 혼용해서 헷갈리는 것 보단, 항상 바이트를 사용하는게 좋다.
Percent ratio 값에는 0–1을 사용한다 (0–100이 아니다). ratiodisk_usage_ratio같이, 이름의 suffix로만 사용한다. 일반적인 메트릭 이름은 A_per_B 패턴을 따른다.
Voltage volts  
Electric current amperes  
Energy joules  
Power   카운터는 줄joule로 익스포트하고 싶다면, rate(joules[5m])을 이용하면 와트 단위 전력을 계산할 수 있다.
Mass grams kilo는 프리픽스 문제가 있기 때문에 kilograms보단 grams를 선호한다.

Next :
Consoles and dashboards
대시보드 베스트 프랙티스

전체 목차는 여기에 있습니다.

<< >>

TOP