Parca 템플릿 변수
Parca 템플릿 변수 (Parca template variables)
프로파일링 쿼리에서 라벨 값을 하드코딩하는 대신 템플릿 변수를 사용해 동적이고 재사용 가능한 대시보드를 만들 수 있어요. 변수는 대시보드 상단의 드롭다운 메뉴로 나타나서, 쿼리를 편집하지 않고도 서비스·인스턴스·환경 간 전환을 쉽게 해줘요. 템플릿 변수 소개는 Variables 문서를 참고하세요.
출처: 문서
본문
Warning: 이 플러그인은 더 이상 사용되지 않으며(deprecated) 보안 업데이트만 받을 예정이에요. 지원은 2027년 1월 2일에 종료돼요.
지원되는 변수 유형
| Variable type | Supported | Notes |
|---|---|---|
| Custom | Yes | 값의 정적 목록을 수동으로 정의. |
| Text box | Yes | 대시보드 상단에 자유 형식 값을 입력. |
| Constant | Yes | 숨겨진 고정 값을 정의. |
| Data source | Yes | 이름으로 데이터 소스 인스턴스 선택. |
| Query | No | Parca는 드롭다운을 동적으로 채우는 변수 쿼리를 구현하지 않음. |
Note: Parca는 query 유형 변수를 지원하지 않아요. Parca 데이터 소스로 변수 드롭다운을 동적으로 채울 수 없으며, 커스텀 변수로 값을 수동 정의하거나 다른 데이터 소스로 쿼리 변수를 채워야 해요.
라벨 선택기에서 변수 사용
Parca 쿼리 편집기의 라벨 선택기(label selector) 필드는 템플릿 변수 보간을 지원해요. 표준 $variablename 또는 ${variablename} 문법을 사용해요. 변수는 라벨 선택기에서만 보간되며, 프로필 타입 드롭다운에서는 지원되지 않아요.
변수 문법 옵션:
| Syntax | Description |
|---|---|
| $variablename | 대부분의 경우에 대한 간단한 문법. |
| ${variablename} | 변수가 다른 텍스트에 인접할 때 사용 (예: ${host}_suffix). |
| ${variablename:format} | 변수 값에 특정 형식 적용. |
예제: 서비스별 프로필 필터링
프로파일링 대시보드에서 서비스 간 전환하는 커스텀 변수를 만들어요.
- 업데이트할 대시보드로 이동하고 Edit을 클릭해요.
- Add new element 아이콘(파란 플러스)을 클릭해요.
- Variable을 클릭해요.
- 변수 유형으로 Custom을 선택해요.
- Name(예:
service)을 입력해요. - Display 드롭다운에서 옵션을 선택해 변수가 대시보드에 표시될 위치를 제어해요.
- Open variable editor를 클릭해 Custom options 대화상자를 열어요.
- 쉼표로 구분된 값(예:
frontend, backend, api-gateway)을 입력해요. - Apply를 클릭해요.
- Save를 클릭해요.
- (선택) 변경 사항 설명을 입력해요.
- Save를 클릭해요.
- Exit edit을 클릭해요.
Parca 쿼리의 라벨 선택기에서 변수를 참조해요:
{job="$service"}
드롭다운 선택을 바꾸면 패널이 새로고침되어 선택된 서비스의 프로필을 보여줘요.
예제: 서비스와 인스턴스로 필터링
여러 차원으로 필터링하는 두 개의 커스텀 변수를 만들어요.
service변수를 커스텀 값frontend, backend, api-gateway로 만들어요.instance변수를 인스턴스 주소의 커스텀 값(예:10.0.0.1:7070, 10.0.0.2:7070, 10.0.0.3:7070)으로 만들어요.
Parca 쿼리의 라벨 선택기에서 두 변수를 참조해요:
{job="$service", instance="$instance"}
예제: 자유 형식 필터링을 위한 텍스트 박스 변수 사용
자유 형식 라벨 필터링을 위한 텍스트 박스 변수를 만들어요.
- 업데이트할 대시보드로 이동하고 Edit을 클릭해요.
- Add new element 아이콘을 클릭해요.
- Variable을 클릭해요.
- 변수 유형으로 Textbox를 선택해요.
- Name(예:
label_filter)을 입력해요. - 선택적으로 기본 Value(예:
job="my-service")를 설정해요. - Save를 클릭해요.
- (선택) 변경 사항 설명을 입력하고 Save를 클릭해요.
- Exit edit을 클릭해요.
Parca 쿼리의 라벨 선택기에서 변수를 참조해요:
{$label_filter}
이렇게 하면 패널 쿼리를 편집하지 않고도 대시보드 상단의 변수 입력에 라벨 매처를 직접 입력할 수 있어요.
제한 사항
- 쿼리 변수 미지원: 변수 옵션을 채우는 데이터 소스로 Parca를 사용할 수 없어요. 커스텀 변수로 값을 수동 정의하거나 다른 데이터 소스를 사용하세요.
- 라벨 선택기만: 변수는 라벨 선택기 필드에서만 보간돼요. 프로필 타입 드롭다운은 변수를 지원하지 않아요.
- 자유 형식 필터 없음: Parca는 자유 형식 filters를 지원하지 않아요.
다음 단계
- 템플릿 변수를 사용해 Build queries를 작성해요.
- 쿼리가 예상 데이터를 반환하지 않으면 Troubleshoot issues를 참고하세요.