표현식 브라우저
표현식 브라우저 (Expression browser)
프로메테우스 웹 UI에 내장된 표현식 브라우저(Expression browser)를 사용해 메트릭을 쿼리하고 그래프로 그리는 방법을 설명하는 문서예요. 별도 도구 없이 프로메테우스 서버에 접속해 PromQL을 바로 입력하고 결과를 보는 가장 간단한 방법입니다. 프로메테우스 서버의 /graph 엔드포인트에서 제공되는 화면이에요.
쿼리를 테스트하거나, 메트릭 값을 잠깐 확인하거나, 학습 목적으로 PromQL을 연습할 때 표현식 브라우저만큼 편리한 도구는 없어요. "Graph"와 "Console" 두 가지 보기 방식이 있다는 것만 알아두면 바로 쓸 수 있어요.
출처: 문서
본문
표현식 브라우저는 프로메테우스 서버가 제공하는 웹 UI의 일부예요. 서버 주소에 /graph를 붙여 접속하면 브라우저에서 바로 PromQL을 실행하고 결과를 볼 수 있어요.
기본 사용법
브라우저 상단에 Expression(표현식) 입력창이 있어요. 여기에 PromQL 쿼리를 입력하고 Execute 버튼을 누르면 쿼리가 실행돼요.
예:
rate(http_requests_total[5m])
입력창 아래에는 G (Graph), C (Console), -, + 버튼이 있어서 보기 방식을 전환할 수 있어요.
- Console 탭: 쿼리 결과를 표 형태로 보여줘요. 각 시계열과 현재 값을 목록으로 확인할 수 있어요
- Graph 탭: 쿼리 결과를 시간에 따른 그래프로 보여줘요. 시간 범위와 해상도를 조절할 수 있어요
메트릭 자동완성
표현식 입력창에서 쿼리를 입력할 때 자동완성이 제공돼요.
- 메트릭 이름을 입력하기 시작하면 일치하는 메트릭이 제안돼요
- 메트릭 이름 뒤에
{를 입력하면 해당 메트릭의 레이블 이름과 값이 자동완성돼요 - PromQL 함수 이름(예:
rate,sum,histogram_quantile)도 자동완성으로 선택할 수 있어요
이 기능 덕분에 정확한 메트릭·레이블 이름을 기억하지 않아도 바로 쿼리를 만들 수 있어요.
Graph 보기 상세
Graph 탭에서는 시간 범위를 선택할 수 있어요. 기본적으로 최근 시간 범위를 보여주고, 쿼리가 지원하면 스텝(해상도)도 조절할 수 있어요. 그래프는 Range 쿼리로 그려지며, 결과가 있을 경우 선 그래프로 표시돼요.
여러 개의 메트릭을 한곳에 표시하려면 쿼리를 여러 줄로 작성하거나 시계열 선택을 넓게 잡으면 돼요. 그래프는 전형적으로 시계열 값의 변화를 보여주므로, 카운터 메트릭은 보통 rate() 같은 함수로 감싸서 증가율을 그리는 것이 보기 좋습니다.
Console 보기 상세
Console 탭은 쿼리 결과를 표로 보여줘요. 각 행이 하나의 시계열을 나타내고, metic(메트릭), name(이름), 그리고 현재 값을 확인할 수 있어요. 익스프레션 결과의 값을 정확히 숫자로 보고 싶을 때 유용해요.
예를 들어 up 쿼리를 실행하면 각 타깃의 상태(1 또는 0)를 표로 확인할 수 있어요.