기능 토글 구성
기능 토글 구성 (Configure feature toggles)
기능 토글(feature flags라고도 함)은 Grafana에서 기능을 활성화하거나 비활성화하는 데 사용해요. 개발·테스트 환경에서 새 기능을 시험해 보려면 기능 토글을 켤 수 있습니다. 이 페이지는 사용 가능한 기능 토글 목록을 제공합니다.
출처: 문서
본문
기능 토글(feature flags라고도 함)은 Grafana에서 기능을 활성화·비활성화하는 데 사용합니다. 개발·테스트 환경에서 새 기능을 시험해 보려면 기능 토글을 켤 수 있어요.
기능 토글을 켜는 방법은 Configure Grafana 문서를 참고하세요. 기능 토글은 Grafana Cloud Advanced 고객에게도 제공됩니다. Grafana Cloud Advanced를 사용한다면 지원 티켓을 열어 활성화하려는 기능 토글과 스택을 지정할 수 있어요.
기능 릴리스 단계에 대한 자세한 내용은 Release life cycle for Grafana Labs와 Manage feature toggles를 참고하세요.
일반 제공(General availability) 기능 토글
대부분의 일반 제공(generally available) 기능은 기본적으로 활성화됩니다. 설정에서 기능 플래그를 "false"로 설정해 비활성화할 수 있어요.
| 기능 토글 이름 | 설명 | 기본 활성화 |
|---|---|---|
| featureHighlights | Grafana Enterprise 기능 하이라이트 | |
| cloudWatchCrossAccountQuerying | CloudWatch 데이터 소스에서 계정 간 쿼리 활성화 | 예 |
| lokiQuerySplitting | 큰 간격 쿼리를 더 작은 시간 간격의 하위 쿼리로 분할 | 예 |
| renderAuthJWT | 원격 캐시 대신 JWT 기반 인증을 렌더링에 사용 | 예 |
| awsDatasourcesTempCredentials | Grafana Cloud 고객을 위한 AWS 플러그인의 임시 보안 자격 증명 지원 | 예 |
| provisioningFolderMetadata | 프로비저닝된 폴더의 폴더 메타데이터 설정 허용 | 예 |
| awsAsyncQueryCaching | Redshift·Athena의 비동기 쿼리 캐싱 활성화. 데이터 소스에 캐싱·비동기 쿼리 지원이 필요 | 예 |
| useKubernetesShortURLsAPI | 프론트엔드의 short URL 요청을 /api에서 /apis 엔드포인트로 라우팅. kubernetesShortURLs에 의존 | 예 |
| cloudWatchBatchQueries | CloudWatch 메트릭 쿼리를 별도 배치로 실행 | |
| annotationPermissionUpdate | 주석 권한을 폴더·대시보드로 스코프하도록 변경 | 예 |
| dashboardNewLayouts | 새 대시보드 레이아웃 활성화 | 예 |
| alertingQueryOptimization | 데이터 소스 부하를 줄이기 위해 적격 쿼리 최적화 | |
| sqlExpressions | 데이터 소스 결과에 대해 SQL 쿼리를 실행할 수 있는 SQL Expressions 활성화 | 예 |
| cloudWatchNewLabelParsing | CloudWatch 라벨 파싱을 더 정확하게 업데이트 | 예 |
| queryLibrary | 저장된 쿼리(쿼리 라이브러리) 기능 활성화 | 예 |
| playlistsRBAC | 플레이리스트용 RBAC 활성화 | |
| savedQueriesRBAC | 저장된 쿼리(쿼리 라이브러리) RBAC 권한 활성화 | 예 |
| newSavedQueriesExperience | 새 저장된 쿼리(쿼리 라이브러리) 모달 경험 활성화 | 예 |
| alertingListViewV2 | 새 알림 목록 뷰 디자인 활성화 | 예 |
| alertingNavigationV2 | 메뉴 그룹핑이 개선된 새 Alerting 내비게이션 구조 활성화 | 예 |
| pluginProxyPreserveTrailingSlash | 플러그인 프록시 후행 슬래시 보존 | |
| azureMonitorPrometheusExemplars | Azure Monitor를 Prometheus exemplars를 제공하는 데이터 소스로 구성 허용 | 예 |
| cloudWatchRoundUpEndTime | 누락 데이터 방지를 위해 메트릭 쿼리의 종료 시간을 다음 분으로 올림 | 예 |
| alertingQueryAndExpressionsStepMode | 알림 쿼리·표현식의 step 모드 활성화 | 예 |
| improvedExternalSessionHandling | OAuth 외부 세션에 대한 개선된 지원 활성화. 활성화 후 사용자는 재인증이 필요할 수 있음 | 예 |
| useSessionStorageForRedirection | 로그인 후 리다이렉션 처리에 세션 스토리지 사용 | 예 |
| pluginsSriChecks | 플러그인 자산의 SRI 검사 활성화 | |
| azureMonitorDisableLogLimit | true일 때 Azure Monitor의 로그 제한 비활성화. 제한은 기본 활성화 | |
| enableSCIM | 사용자·그룹 관리용 SCIM 지원 활성화 | 예 |
| alertingUIOptimizeReducer | 새 알림 규칙 생성과 instant query 사용 시 알림 UI에서 리듀서 제거 활성화 | 예 |
| azureMonitorEnableUserAuth | Azure Monitor 데이터 소스 전용 사용자 인증 활성화 | 예 |
| alertingNotificationsStepMode | 알림 섹션에서 단순화된 step 모드 활성화 | 예 |
| lokiLabelNamesQueryApi | Loki /labels API를 /series 대신 기본 사용 |
예 |
| improvedExternalSessionHandlingSAML | SAML 외부 세션에 대한 개선된 지원 활성화. SAML Single Logout이 제대로 작동하려면 NameID 형식이 올바르게 구성되어야 함 | 예 |
| alertingMigrationUI | 데이터 소스 관리 규칙을 Grafana 관리 규칙으로 마이그레이션하는 알림 마이그레이션 UI 활성화 | 예 |
| alertingImportYAMLUI | Prometheus 파일에서 규칙을 Grafana 관리 규칙으로 가져오는 UI 기능 활성화 | 예 |
| unifiedNavbars | 통합 내비게이션 바 활성화 | |
| grafanaAssistantInProfilesDrilldown | Profiles Drilldown에서 Grafana Assistant 통합 활성화 | 예 |
| newClickhouseConfigPageDesign | Clickhouse 데이터 소스 구성 페이지의 새 디자인 활성화 | 예 |
| azureResourcePickerUpdates | 업데이트된 Azure Monitor 리소스 피커 활성화 | 예 |
| profilesExemplars | profiles drilldown에서 프로파일 exemplars 지원 활성화 | 예 |
| react19 | 새 React 19 런타임 사용 여부 | 예 |
| grafana.newPreferencesPage | 새 SharedPreferences 기능 컴포넌트 사용 여부 | 예 |
| datasources.useNewStackInfoToSettingsCache | datasource.StackInfoToSettings용 새 캐시 사용, 백엔드 플래그 | |
| preferences.rerouteLegacyAPIs | 레거시 preferences API에 K8s 클라이언트 구현 사용 | 예 |
| grafana.queryVarEditorRedesign | 분할-창 미리보기와 정적 옵션을 관리하는 스프레드시트가 있는 재설계된 쿼리 변수 편집기 활성화 | 예 |
| grafana.dashboardSettingsRedesign | 대시보드 설정 페이지를 모달 창의 Advanced Settings로 재설계 | 예 |
| grafana.unifiedDataSourcePicker | @grafana/runtime이 플러그인에 노출하는 DataSourcePicker 뒤에 핵심 Grafana 데이터 source 피커 렌더링 | 예 |
공개 미리보기(Public preview) 기능 토글
Public preview 기능은 지원 팀이 지원하지만 활성화, 구성, 일부 문제 해결로 제한될 수 있어요.
| 기능 토글 이름 | 설명 |
|---|---|
| panelTitleSearch | 패널 제목으로 대시보드 검색 |
| faroDatasourceSelector | Frontend Observability의 Frontend Apps 섹션 내 데이터 소스 선택기 활성화 |
| provisioning.readmes | Git Sync 프로비저닝 폴더의 README.md를 대시보드 목록 아래에 인라인 렌더링 |
| provisioning.gitConventions | Git Sync의 커밋 메시지, 브랜치 이름, PR 제목 규칙 구성 가능 |
| provisioning.userAttribution | Git Sync 커밋을 동작하는 Grafana 사용자로 작성 |
| externalServiceAccounts | 플러그인용 자동 서비스 계정·토큰 설정 |
| feedbackButton | 대시보드 편집 사이드바의 피드백 버튼 활성화 |
| pdfTables | 보고에서 테이블 데이터를 PDF로 생성 활성화 |
| canvasPanelPanZoom | 캔버스 패널에서 팬·줌 허용 |
| timeComparison | 지원 패널에서 시간 비교 옵션 활성화 |
| secretsManagementAppPlatformUI | secrets 관리 앱 플랫폼 UI 활성화 |
| dashboardTemplates | 템플릿에서 새 대시보드를 시작하는 흐름 활성화 |
| alertRuleRestore | 알림 규칙 복원 기능 활성화 |
| azureMonitorLogsBuilderEditor | Azure Monitor 데이터 소스의 logs builder 모드 활성화 |
| alertingListViewV2PreviewToggle | 알림 목록 뷰 v2 미리보기 토글 활성화 |
| interactiveLearning | 대화형 학습 앱 활성화 |
| panelTimeSettings | 새 패널 시간 설정 드로어 활성화 |
| transformationsEmptyPlaceholder | 빈 변환 상태에서 변환 퀵스타트 카드 표시 |
| pyroscopeUTF8LabelNames | Pyroscope 라벨 선택기에서 UTF-8 라벨 이름 지원 활성화 |
| queryEditorNext | 차세대 쿼리 편집기 경험 활성화 |
| grafana.viewPanelPane | 패널 뷰 모드에서 새 토글·옵션이 있는 사이드바 창 활성화 |
| flameGraphWithCallTree | Call Tree 뷰가 포함된 새 Flame Graph UI 활성화 |
| splashScreen | 첫 세션에 새 Grafana 기능을 소개하는 스플래시 화면 모달 활성화 |
| grafana.dynamicTraceToLogs | Trace View에서 링크 시 로그 존재 확인 |
개발(Development) 기능 토글
다음 토글은 활성화하기 전에 Grafana의 app mode 를 'development'로 명시적으로 설정해야 해요. 이러한 기능은 실험적인 경향이 있습니다.
| 기능 토글 이름 | 설명 |
|---|---|
| grafanaAPIServerWithExperimentalAPIs | 모든 데이터 소스를 포함한 실험적 API를 k8s API 서버에 등록 |