프로메테우스 - 기본 기능

프로메테우스의 기본 페이지에 원하는 엔드포인트를 입력하면 그에 따른 정보가 나온다.

위에서는 http_server_requests_seconds_count를 입력해서 서버에 접근하는 총 소유 시간을 조회했다.

 

 

Table이 아니라 Graph를 누르면 정보를 그래프로 보여준다.

시간 설정도 할 수 있다.

맨 위에 있는 그래프는 /actuator/prometheus인데 1초에 한 번씩 보내는걸로 yml로 실행했기 때문에 계속 실행되는 것이고, 아래 그래프의 보라색은 /log uri인데, localhost:8080/log에 접근해서 해당 컨트롤러를 약 20번정도 실행하고 결과를 캡쳐한 것이다.

 

특정 시간을 선택할 수도 있다. 그 시간대의 결과만 따로 보고싶을 때 사용하면 된다.

 

 

 

 

필터

레이블(마이크로미터의 tag를 프로메테우스에서는 레이블이라 함)을 기준으로 필터를 사용할 수 있다.

필터는 중괄호 {} 문법을 사용한다.

 

 

레이블 일치 연산자

1. = 제공된 문자열과 정확히 동일한 레이블 선택
2. != 제공된 문자열과 같지 않은 레이블 선택
3. =~ 제공된 문자열과 정규식 일치하는 레이블 선택
4. !~ 제공된 문자열과 정규식 일치하지 않는 레이블 선택

 

 

1. = 문법

http_server_request_second_count 다음에 중괄호로 {uri="/log"}를 입력하면 log uri로 접근한 기록만 필터링해서 보여준다.

 

 

 

2. != 문법

actuator/prometheus는 불필요하다고 판단되면 != 를 이용해서 제외하고 조회할 수 있다.

 

 

 

3. =~ 문법

또는의 연산자는 기본적으로 | 라고 알려져있다. method="GET|POST"라고 입력하면 안되고 method=~"GET|POST"라고 입력하면 GET이나 POST 방식의 요청이 보여진다.

 

 

 

4. !~ 문법

http_server_requests_seconds_count{uri!~"/actuator.*"}를 입력하면 actuator로 시작하는 uri는 다 빠지게 된다.

 

 

 

 

 

 

연산자 쿼리와 함수

 

1. sum

각 uri 별로 결과가 분리되어서 보여지는데, 전체를 합친 결과를 보고싶으면 sum()을 하면 된다.

 

 

 

2. sum by

sum by는 grouping을 하는 연산자이다. method와 status로 그룹을 묶어서 보여준다.

 

 

 

3. count

count는 갯수를 출력해준다.

 

 

 

4. topk

topk는 상위 몇 개의 정보를 조회한다. 괄호의 첫 번째 파라미터에 숫자를 넣으면 그 숫자만큼의 상위 데이터가 조회된다.

 

 

 

5. offset

offset 10m를 뒤에 넣어주면 과거 10분 전의 데이터를 보여준다.

 

 

 

6. 벡터 범위 생성기

[1m]를 넣어주면 1분동안 수집한 데이터들을 전부 보여준다.

그래프 차트로 표현할 수는 없고 데이터로 확인할 수 있다. 차트로 표현하려면 따로 가공이 필요하다.

 

 

 

대략적으로 자주 사용되는 기능만 정리했지만, 너무 많은 기능이 있기 때문에 공식 문서 등을 참고해서 따로 공부해야지 제대로 사용할 수 있을 것 같다.