Grafana Logs Drilldown 구성

Grafana Logs Drilldown 구성 (Configure Grafana Logs Drilldown)

Configuration 페이지를 사용해 Grafana의 다른 앱·플러그인처럼 Grafana Logs Drilldown 앱을 구성할 수 있어요. 앱의 Administration 페이지에 접근하면 버전 기록, 변경 로그, 구성, 랜딩 페이지 설정, 기본 필드를 볼 수 있어요.

출처: 문서

본문

시작하기 전에 (Before you begin)

Configuration 페이지에 접근하려면 Org Admin 또는 Server Admin 역할이 필요해요. 구성 설정의 변경 사항을 저장할 수 있는 것은 Org Admin만이에요. Server Admin 단독으로는 앱 플러그인을 구성할 수 없고, 설치·제거·업데이트만 할 수 있어요.

실질적으로 이는 다음을 의미해요:

Org Admin만: 보고 구성할 수 있지만 플러그인을 설치하거나 업데이트할 수 없어요.
Server Admin만: 플러그인을 설치/업데이트할 수 있지만, Configuration 탭 설정은 읽기 전용이에요.
두 역할 모두: 구성, 설치, 업데이트, 제거까지 완전한 접근 권한.

이것은 Logs Drilldown에만 국한되지 않고 모든 앱 플러그인에 적용되는 Grafana 전역 규칙이에요. Server Admin이 구성 설정을 변경해야 한다면 관련 조직에서 Org Admin 역할을 부여받아야 해요.

자세한 내용은 Plugin management을 참고해요.

Configuration 탭 (Configuration tab)

Configuration 탭에는 팀을 위한 일관된 경험을 설정하는 관리자를 위한 네 가지 설정이 있어요:

Default data source: 사용자가 앱을 처음 열 때 도착하는 Loki 인스턴스를 선택
Default time range: 내장된 15분 기본값을 팀의 워크플로에 맞는 범위로 오버라이드
Maximum time picker interval: 사용자가 쿼리할 수 있는 과거 범위를 제한. 보통 Loki 보존 기간에 맞추거나 쿼리 성능 보호용
Disable Loki patterns: Loki 인스턴스에 패턴 수집이 활성화되지 않은 경우 Patterns 탭과 API 호출을 끄기

설정 구성 (Configure settings)

Configuration 탭을 보려면:

Administration > Plugins and data > Plugins > Grafana Logs Drilldown으로 이동해 Logs Drilldown 앱의 설정을 열어요.
Configuration 탭을 선택해요.

Note

구성 변경 사항을 적용하려면 활성 사용자가 앱을 다시 로드해야 해요.

구성할 설정을 선택해요:

Default data source는 새 사용자가 처음 Logs Drilldown을 열 때 사용되는 Loki 데이터 소스를 설정해요. 개별 사용자는 앱 안에서 다른 데이터 소스를 선택해 이를 오버라이드할 수 있어요. Loki 데이터 소스만 지원돼요.
Default time range는 URL에 이미 시간 범위가 설정되지 않은 상태로 사용자가 Logs Drilldown을 열 때 적용되는 시간 범위를 제어해요. Use custom default time range 체크박스를 선택해 이 설정을 활성화하면 From 및 To 입력 필드가 나타나요. 두 필드 모두 필수예요. 시작에는 now-15m, now-1h, now-24h 같은 상대 시간 표현을, 끝에는 now를 사용해요. 절대 날짜-시간 값도 허용돼요. From 값은 To 값보다 이전이어야 해요. 둘 중 하나가 없거나 유효하지 않으면 Save settings 버튼이 비활성화되고 인라인 오류가 표시돼요. 비활성화되면 앱은 내장 기본값인 최근 15분을 사용해요.
Maximum time picker interval은 사용자가 시간 선택기에서 선택할 수 있는 시간 범위 간격의 상한을 설정해요. 허용되는 최소 값은 1시간(60m)이에요. 예시 값: 7d, 24h, 2w. 비워 두면 사용자가 어떤 시간 범위든 선택할 수 있어요.
Disable Loki patterns는 Patterns 탭과 Loki Patterns API 엔드포인트가 Logs Drilldown에서 사용되는지 제어해요.

설정을 구성한 후 Save settings를 클릭해 변경 사항을 적용해요.

기본 필드 (Default fields, Beta)

Note

Default fields는 현재 공개 미리보기 단계예요. Grafana Labs는 제한된 지원을 제공하며, 기능이 일반 공개되기 전에 파괴적인 변경이 발생할 수 있어요. 이 기능을 사용하려면 Grafana 구성 파일에서 kubernetesLogsDrilldown 기능 토글을 활성화하거나 Support에 문의해요.

Default fields 탭을 사용하면 관리자가 전체 로그 라인 대신 또는 그 옆에 로그 시각화에서 기본적으로 표시되는 필드를 구성할 수 있어요.

Default fields는 Grafana 12.4 이상이 필요해요. 이 버전 요구 사항이 충족되지 않으면 Default fields 탭에 지원되지 않는 메시지가 표시돼요.

Default fields 작동 방식 (How Default fields work)

Default field 규칙은 특정 데이터 소스와 하나 이상의 라벨·값 쌍으로 범위가 지정돼요. 사용자가 규칙의 모든 구성 라벨과 일치하는 서비스의 로그를 볼 때, 지정된 필드가 로그 테이블 보기에서 기본적으로 표시돼요. 구성된 필드는 전체 로그 라인을 대체하거나 그 옆에 표시될 수 있어요.

규칙이 같은 라벨에 대해 여러 값을 저장하면 그 값들은 정규 표현식으로 일치되므로, 규칙이 한 번에 여러 라벨 값에 적용될 수 있어요.

Default fields 구성 (Configure Default fields)

Default fields를 구성하려면:

Administration > Plugins and data > Plugins > Grafana Logs Drilldown으로 이동해요.
Default fields 탭을 선택해요.
데이터 소스 선택기에서 Loki 데이터 소스를 선택해요.
Add를 클릭해 새 규칙을 만들어요.
이 규칙이 적용되는 서비스를 정의하려면 라벨과 라벨 값을 선택해요. Add label을 클릭해 한 규칙에 여러 라벨·값 쌍을 추가할 수 있어요.
일치하는 서비스에 표시할 열을 Add column으로 추가해요.
새 구성을 저장하려면 Create default columns를 클릭하거나, 기존 구성의 변경 사항을 저장하려면 Update default columns를 클릭해요.

다른 라벨·값 조합에 대해 다른 열을 구성하려면 여러 레코드를 추가할 수 있어요. 각 데이터 소스는 자체 규칙 집합을 가질 수 있어요.

Grafana Logs Drilldown 구성