쿼리 저장·로드

쿼리 저장·로드 (Save and load queries)

현재 필터 구성을 이름 있는 쿼리로 저장해 나중에 빠르게 돌아갈 수 있어요. 특정 서비스, 오류 유형 또는 대기 시간 임계값에 대한 필터처럼 반복해서 사용하는 필터 집합이 있을 때 유용해요.

출처: 문서

본문

현재 필터 구성을 이름 있는 쿼리로 저장해 나중에 빠르게 돌아갈 수 있어요. 이것은 특정 서비스, 오류 유형 또는 대기 시간 임계값에 대한 필터처럼 반복해서 사용하는 필터 집합이 있을 때 유용해요.

저장된 쿼리는 현재 Filters 바와 data source를 캡처해요. 시간 범위, 선택된 메트릭, group-by 속성, 활성 탭 또는 기타 탐색 상태는 캡처하지 않아요.

쿼리 저장 (Save a query)

현재 필터를 저장하려면:

  1. Filters 바를 사용해 필터를 하나 이상 추가해요.
  2. 헤더 바에서 데이터 소스 선택기 옆의 Save 버튼(저장 아이콘)을 선택해요.
  3. 쿼리의 Title과 선택적 Description을 입력해요.
  4. Save를 선택해요.

현재 데이터 소스에 대해 같은 필터 표현식을 가진 저장된 쿼리가 이미 있으면 경고가 기존 항목의 제목을 보여줘요.

Note

Save 버튼은 필터가 하나 이상 적용될 때만 나타나요.

저장된 쿼리 로드 (Load a saved query)

이전에 저장한 쿼리를 로드하려면:

  1. 헤더 바에서 데이터 소스 선택기 옆의 Load 버튼(폴더 열기 아이콘)을 선택해요.
  2. 저장된 쿼리 목록을 탐색해요.
  3. 쿼리를 선택해 제목, 설명, 필터 표현식을 미리 봐요.
  4. 저장된 필터를 적용하려면 Select를 선택해요.

저장된 쿼리를 로드하면 현재 필터를 대체해요. 저장된 쿼리가 다른 데이터 소스를 사용한다면 데이터 소스가 자동으로 전환돼요.

더 이상 필요 없는 저장된 쿼리를 제거하려면 로드 모달에서 그 옆의 Delete(휴지통) 아이콘을 선택해요.

저장 (Storage)

저장된 쿼리는 Grafana 설정에 따라 두 가지 방식 중 하나로 저장돼요:

  • Saved Queries (query library): Grafana 12.4 이상에서 queryLibrary 기능 토글이 활성화되면 저장된 쿼리는 Grafana의 쿼리 라이브러리를 사용해 서버 측에 저장돼요. 이렇게 저장된 쿼리는 브라우저와 기기 간에 사용할 수 있어요.
  • Local storage: Grafana 오픈 소스, 이전 Grafana 버전, 또는 쿼리 라이브러리 토글이 활성화되지 않았을 때 저장된 쿼리는 브라우저의 로컬 스토리지에 저장돼요. 이 쿼리들은 특정 브라우저·기기에 한정되어 공유할 수 없어요.

더 알아보기 (Learn more)