01
전체 표현식부터 분석
PromQL 모드에서 괄호와 함수의 중첩을 확인하세요. 오류는 행과 열을 알려 주며 추측해서 고친 출력은 제공하지 않습니다.
로그와 관측성
PromQL 포맷터대시보드 전에 쿼리부터 확인
표현식의 구문을 확인하거나 선택자 샘플 및 RE2 검사 모드로 전환하세요. 실제 시계열 쿼리를 실행하지 않습니다.
PromQL 포맷터
브라우저에서만 처리하며 Prometheus에 연결하거나 쿼리를 보내지 않습니다.
표현식을 입력하거나 예제를 불러오세요.
그래프가 비어 있을 때 구문 오류와 레이블 불일치는 다른 문제입니다. PromQL 포맷터로 표현식이 분석되는지 살핀 뒤, 손에 있는 샘플에 선택자가 맞는지 따로 확인할 수 있습니다.
입력한 쿼리는 그대로 남습니다. 정리 기능은 분석기가 확인한 경계의 공백만 조정하므로 경보 규칙에 옮기기 전에 원문과 비교하기 쉽습니다.
PromQL 포맷터가 필요한 이유
구문 통과와 실제 데이터 조회를 혼동하지 않고 세 가지 질문을 나눕니다.
선택자가 고르는 샘플 확인
PromQL 포맷터는 순수 벡터 선택자를 붙여넣은 메트릭 줄에 적용합니다. status=~"5.."가 500과 503을 고르고 200을 제외하는지 한 줄씩 확인할 수 있습니다.
Prometheus의 RE2 규칙으로 검사
JavaScript 정규식의 근사 결과 대신 RE2로 레이블 값 전체를 검사합니다. PromQL 포맷터는 지원하지 않는 전후방 탐색을 성공으로 처리하지 않습니다.
세 모드를 올바르게 쓰는 순서
완전한 쿼리와 샘플 선택자는 같은 계산이 아닙니다.
02
선택자만 샘플에 적용
http_requests_total{job="api"} 같은 순수 선택자를 입력하고 메트릭을 한 줄씩 붙여넣으세요. 끝의 숫자는 레이블 일치 판단에 쓰지 않습니다.
03
정규식은 값 전체에 시험
RE2 모드에 패턴과 값을 줄마다 넣으세요. 5..는 500에 일치하지만 1500 안의 일부만 맞는 경우는 일치하지 않습니다.
로컬 결과가 뜻하는 것
텍스트 구조, 샘플 레이블, RE2 일치를 별개로 표시합니다.
PromQL 구문과 구조
PromQL 문법을 분석한 다음 보수적인 정리 결과와 구문 트리를 보여 줍니다. 오류가 나거나 결과가 오래되면 내보낼 수 없습니다.
붙여넣은 레이블 샘플
PromQL 레이블 선택자는 =, !=, =~, !~ 조건을 함께 적용합니다. 없는 레이블은 빈 문자열로 비교하고 실패한 레이블을 줄마다 표시합니다.
완전 일치 RE2 검사
PromQL 정규식은 RE2로 컴파일합니다. 역참조와 전후방 탐색 같은 문법은 거부하고 각 값의 전체 일치 여부를 보여 줍니다.
결과를 재사용하기 전 한계
구문이 맞아도 배포 환경에 해당 메트릭이 있다는 뜻은 아닙니다.
- 실제 시계열은 조회하지 않음
- PromQL 포맷터는 TSDB나 Prometheus API에 연결하지 않습니다. 그래프, 실제 값, 온라인 시리즈 수 또는 존재하는 메트릭 목록을 알 수 없습니다.
- 샘플에는 순수 선택자만
- rate(), sum by, 조인이나 범위 쿼리는 샘플에서 계산하지 않습니다. 전체 표현식은 PromQL 모드에서 구문만 확인하세요.
- 유효하지 않은 출력은 막음
- RE2가 거부한 패턴이나 구문 오류를 자동으로 고치지 않습니다. 입력이 바뀌면 새 검사가 끝날 때까지 복사와 다운로드가 비활성화됩니다.
PromQL 포맷터에 관한 자주 찾는 질문
문법, 정규식, 집계와 레이블에 관한 검색어를 질문으로 정리했습니다.
PromQL 문법은 어떻게 확인하나요?
PromQL 포맷터에 표현식을 붙여넣으면 브라우저에서 분석하고 오류 행과 열을 표시합니다. 서버의 메트릭 존재 여부까지 확인하는 기능은 아닙니다.
PromQL이란 무엇인가요?
Prometheus에서 시계열을 선택하고 집계하는 쿼리 언어입니다. 이 페이지는 표현식 텍스트를 다루며 쿼리 평가 엔진을 실행하지 않습니다.
sum by 집계 결과도 볼 수 있나요?
구문 구조는 볼 수 있지만 집계값은 실제 시계열이 있어야 계산됩니다. 샘플 모드는 순수 벡터 선택자의 레이블만 비교합니다.
label_replace로 샘플 레이블을 바꿀 수 있나요?
아니요. 함수 호출의 구문은 검사할 수 있지만 단일 샘플의 레이블을 바꾸거나 시계열 함수를 평가하지 않습니다.
PromQL 포맷터는 잘못된 쿼리를 고치나요?
아니요. 유효한 식의 공백만 정리합니다. 구문이 틀리면 오류 위치를 보여 주고 잘못된 수정본을 다운로드하지 못하게 합니다.
빠진 PromQL 사례가 있나요?