Graphite 쿼리 편집기
Graphite 쿼리 편집기 (Graphite query editor)
Grafana에는 Graphite 전용 쿼리 편집기가 있어서 쿼리 작성을 도와줘요. 쿼리 편집기로 메트릭 공간을 빠르게 탐색하고, 함수를 추가하고, 함수 파라미터를 바꿀 수 있어요. 쿼리 참조(query references)를 통한 복잡한 중첩 쿼리를 포함해 다양한 Graphite 쿼리를 지원합니다.
출처: 문서
본문
데이터 소스 쿼리에 대한 일반 문서는 쿼리와 데이터 변환을 참고하세요.
쿼리 편집기 요소
- Series - Graphite의 시리즈는 특정 메트릭 이름과 타임스탬프 값으로 표현되는 고유한 시계열 데이터셋이에요. select metric을 클릭해 드롭다운에서 메트릭을 선택하세요.
- Functions - Graphite는 함수로 데이터를 조작해요. + 기호를 클릭해 드롭다운에서 함수 목록을 보세요. 여러 함수로 쿼리를 만들 수 있습니다.
오른쪽 상단의 연필 아이콘으로 원시 쿼리를 볼 수 있고, 다시 클릭하면 시리즈·함수 추가를 계속할 수 있어요.
쿼리할 메트릭 선택
Select metric을 클릭해 사용 가능한 메트릭을 탐색하세요. 마우스나 화살표 키로 이동하고 와일드카드도 선택할 수 있어요.
함수
Function 옆 + 기호를 클릭해 함수를 추가하세요. 함수 이름의 첫 몇 글자로 검색도 가능해요. 함수 선택 후 Grafana가 자동으로 첫 파라미터 필드에 커서를 놓아줘요. 파라미터를 클릭하면 편집 가능한 텍스트 상자가 열리고, 함수를 클릭한 뒤 위에 나타나는 X 아이콘으로 제거할 수 있어요.
aliasByNode 같은 일부 함수는 선택적 두 번째 인자를 지원해요. 인자 위에 마우스를 올리면 대화상자가 나타나 추가할 수 있고, 두 번째 선택적 파라미터를 클릭해 삭제할 수도 있습니다. 자세한 내용은 Graphite 문서의 Functions를 참고하세요.
경고: 일부 함수는 시리즈를 반환하는 다른 함수를 두 번째 인자로 받을 수 있어요. 함수인 두 번째 인자를 추가해야 한다면, 함수를 직접 임베드하는 대신 두 번째 쿼리의 시리즈 참조를 사용하는 것을 권장합니다. 현재 쿼리 편집기는 쿼리 빌더와 코드 편집기 사이를 전환할 때 두 번째 함수 인자 파싱을 지원하지 않아요.
라벨 정렬
여러 그래프에 같은 라벨이 있으면 다르게 정렬되고 다른 색이 할당될 수 있어요. 일관된 정렬·색상화를 위해 sortByName() 함수로 라벨을 알파벳순 정렬하세요.
테이블·차트에서 메트릭 이름 수정
Grafana 테이블·그래프에서 메트릭 이름을 바꾸려면 aliasByNode()나 aliasSub() 같은 alias 함수를 사용하세요.
데이터 포인트 통합
Grafana는 그래프에 있는 픽셀 수보다 많은 데이터 포인트를 Graphite가 반환하지 않도록 모든 Graphite 메트릭을 통합(consolidate)해요. 기본적으로 avg 함수로 통합하고, consolidateBy() 함수로 통합 방식을 제어할 수 있어요.
참고: Grafana는
max,min,total같은 범례 요약 값을 클라이언트 측에서 데이터 계산 후에 계산해요. 사용한 통합 함수에 따라 이 중 하나나 둘만 동시에 정확할 수 있어요.
시계열 결합
시계열을 결합하려면 Functions 목록에서 Combine을 클릭하세요.
태그로 데이터 선택·탐색
Graphite에서는 모든 것이 태그입니다. 데이터를 탐색할 때 이전에 선택한 태그가 남은 결과 집합을 필터링해요. 데이터 선택에는 태그 표현식(=, !=, =~, !=~)을 받는 seriesByTag 함수를 쓰세요. 태그를 선택하면 Grafana 쿼리 빌더가 자동으로 처리해줘요.
참고: 정규 표현식 검색은 높은 카디널리티 태그에서 느릴 수 있으니, 먼저 다른 태그로 범위를 줄이세요. 특정 이름·네임스페이스로 먼저 필터링하면 결과 줄이기에 도움이 됩니다.
중첩 쿼리
쿼리 문자로 다른 쿼리를 참조할 수 있어요(스프레드시트의 셀 참조와 유사). 두 번째 쿼리를 추가하고 쿼리 A의 결과를 기반으로 만들려면 #A로 참조하세요. 이를 통해 복합·중첩 쿼리를 만들 수 있고 패널이 더 유연·관리하기 쉬워져요.
와일드카드로 쿼리 수 줄이기
같은 그래프에 여러 시계열을 표시하려면 쿼리에 와일드카드를 사용해 매칭되는 모든 시리즈를 한 번에 가져오세요. 예: cpu.percent.*.g. 각 시리즈마다 별도 쿼리를 쓰는 것보다 효율적이에요.
어노테이션 적용
어노테이션은 그래프 위에 풍부한 이벤트 정보를 겹쳐 보여줘요. 대시보드 툴바의 Add new element 아이콘(파란 더하기)에서 Annotation query를 선택해 추가할 수 있어요. Graphite는 두 가지 방법으로 어노테이션을 쿼리해요:
- Graphite query 텍스트박스를 쓰는 일반 메트릭 쿼리
- Graphite event tags 텍스트박스(태그·와일드카드·빈 값 포함)를 쓰는 Graphite 이벤트 쿼리
Loki와의 통합
Explore에서 데이터 소스를 Loki로 바꾸면 Graphite 쿼리가 자동으로 Loki 쿼리로 변환돼요. Loki 라벨 이름·값은 Graphite 데이터 소스 구성에 정의된 매핑 정보를 기반으로 추출됩니다. seriesByTags()를 사용하는 태그 쿼리는 추가 설정 없이 자동 변환돼요.