Advanced settings in OpenSearch Dashboards
출처: 문서
본문
OpenSearch Dashboards의 고급 설정
Advanced settings 페이지에서 OpenSearch Dashboards 동작을 제어하는 설정을 수정할 수 있어요. 이 설정을 사용하면 애플리케이션의 모양과 느낌을 커스터마이즈하거나, 일부 기능의 동작을 바꾸는 등 다양한 설정이 가능해요. 인터페이스 모습은 다음 이미지에서 볼 수 있어요.
{: width="700" }
Advanced settings에 접근하려면 Dashboards Management로 이동한 다음 Advanced settings를 선택하세요. 페이지는 General, Appearance, Discover, Notifications, Search, Timeline, 그리고 Visualization 섹션으로 나뉘어요. 각 섹션에는 해당하는 설정들이 모여 있어요. 필드를 편집하면 이 설정들을 수정할 수 있고, 변경을 마친 뒤 Save를 선택하면 적용돼요.
{::nomarkdown}
{:/} 참고
일부 설정은 opensearch_dashboards.yml 파일을 수정하고 OpenSearch Dashboards를 재시작해야 해요.
{: .note}
필수 권한
설정을 수정하려면 변경을 수행할 권한이 있어야 해요. 테넌트에 역할 접근 권한을 부여하는 방법은 멀티 테넌시 구성을 참고하세요.
고급 설정 설명
다음 표에서는 핵심 고급 설정을 설명해요.
General 설정
다음 표는 General 설정을 설명해요.
| 설정 | 설명 |
|---|---|
csv:quoteValues |
특수 문자가 포함된 값이나 여러 줄로 된 값을 큰따옴표 "로 묶을지 여부를 정의해요. 기본값은 On이에요. |
csv:separator |
내보낸 값을 구분하는 데 사용할 문자나 문자열을 정의해요. 기본값은 ,예요. |
dateFormat |
날짜 표시 형식을 정의해요. 기본값은 MMM D, YYYY @ HH:mm:ss.SSS예요. |
dateFormat:dow |
한 주의 시작 요일을 정의해요. 기본값은 Sunday예요. |
dateFormat:scaled |
타임스탬프 형식을 정의해요. 타임스탬프 형식은 측정값 사이의 시간 간격(시, 분, 초, 밀리초)에 따라 달라져요. 키는 ISO8601 형식의 시간 구간이에요: YYYY-MM-DD. |
dateFormat:tz |
OpenSearch Dashboards의 시간대를 정의해요. 기본값은 브라우저에서 감지한 시간대예요. |
dateNanosFormat |
나노초 단위 날짜를 표현하는 형식을 정의해요. 기본값은 MMM D, YYYY @ HH:mm:ss.SSSSSSSSS예요. |
defaultIndex |
OpenSearch 클러스터에 있는 모든 인덱스의 기본 인덱스를 정의해요. 인덱스가 추가되지 않으면 defaultIndex는 null로 설정돼요. 하지만 인덱스가 하나 이상 추가되면 defaultIndex에는 목록의 첫 번째 인덱스 값이 할당돼요. 기본값은 null이에요. |
defaultRoute |
게이트웨이 지점을 정의해요. 이 설정을 사용하면 OpenSearch Dashboards의 랜딩 페이지를 변경할 수 있어요. 설정값은 상대 URL이어야 해요. 기본값은 /app/home이에요. |
fields:popularLimit |
표시할 필드 수를 정의해요. 기본값은 10이에요. |
filterEditor:suggestValues |
필터 편집기에서 필드 값을 제안할지 여부를 정의해요. 기본값은 Off예요. |
filters:pinnedByDefault |
필터를 자동으로 고정할지 여부를 정의해요. 필터를 모든 애플리케이션에서 계속 표시하려면 필터를 선택한 뒤 Pin across all apps 옵션을 선택하면 돼요. 기본값은 Off예요. |
format:bytes:defaultPattern |
bytes 형식의 기본 숫자 형식을 정의해요. 기본값은 0,0.[0]b예요. |
format:currency:defaultPattern |
currency 형식의 기본 숫자 형식을 정의해요. 기본값은 ($0,0.[00])예요. |
format:defaultTypeMap |
매핑을 사용해 필드 타입별 기본 형식 이름을 정의해요. 필드 타입이 지정되지 않으면 _default_가 사용돼요. |
format:number:defaultLocale |
숫자의 언어 로캘을 정의해요. 기본값은 en이에요. |
format:number:defaultPattern |
number 형식의 기본 숫자 형식을 정의해요. 기본값은 0,0.[000]예요. |
format:percent:defaultPattern |
percent 형식의 기본 숫자 형식을 정의해요. 기본값은 0,0.[000]%예요. |
histogram:barTarget |
auto 간격을 사용하는 date 히스토그램의 막대 개수를 지정해요. 기본값은 50이에요. |
histogram:maxBars |
date 히스토그램에 표시할 막대의 최대 개수를 정의해요. 기본값은 100이에요. |
history:limit |
히스토리에 저장할 최근 값의 개수를 정의해요. 기본값은 10이에요. |
indexPattern:placeholder |
인덱스 패턴을 생성할 때 사용할 플레이스홀더 값을 정의해요. |
metaFields |
_source 필드에 속하지 않는 필드를 문서에 병합할 수 있게 해요. 기본값은 _source, _id, _type, _index, _score예요. |
metrics:max_buckets |
단일 데이터 소스가 반환할 수 있는 최대 버킷 수를 정의해요. 기본값은 2000이에요. |
query:allowLeadingWildcards |
쿼리 절에서 *를 첫 문자로 사용할 수 있는지 여부를 정의해요. 기본값은 On이에요. |
query:queryString:options |
Lucene 쿼리 문자열 파서의 옵션을 정의해요. 기본값은 { "analyze_wildcard": true }예요. |
reporting:useFOR |
외부 콘텐츠를 리포트에 삽입할 때 사용하는 ForeignObject 렌더링을 활성화하거나 비활성화해요. reporting:useFOR 및 reporting:useOcr 옵션은 리포팅 플러그인을 설치한 후에만 표시돼요. 기본값은 On이에요. |
reporting:useOcr |
PDF 리포트에 대한 광학 문자 인식(OCR)을 활성화하거나 비활성화해요. reporting:useFOR 및 reporting:useOcr 옵션은 리포팅 플러그인을 설치한 후에만 표시돼요. 기본값은 Off예요. |
savedObjects:listingLimit |
목록 페이지를 조회할 때 가져올 객체 수를 정의해요. 기본값은 1000이에요. |
savedObjects:perPage |
로드 대화상자의 각 페이지에 표시할 객체 수를 정의해요. 기본값은 20이에요. |
search:queryLanguage |
OpenSearch Dashboards에서 사용할 쿼리 언어를 정의해요. 기본값은 DQL이에요. |
shortDots:enable |
긴 필드 이름 축약 기능을 활성화하거나 비활성화해요. 기본값은 Off예요. |
sort:options |
sort 파라미터의 옵션을 정의해요. 기본값은 boolean이에요. |
state:storeInSessionStorage |
URL 세션 스토리지 사용을 활성화하거나 비활성화해요. 기본값은 Off예요. |
timepicker:quickRanges |
시간 필터에 표시할 빠른 선택 시간 범위를 정의해요. |
timepicker:refreshIntervalDefaults |
시간 필터의 기본 새로 고침 간격을 밀리초 단위로 정의해요. 기본값은 0이에요. |
timepicker:timeDefaults |
데이터 분석에 사용할 기본 시간 범위를 정의해요. 기본값은 Last 15 minutes예요. |
truncate:maxHeight |
테이블 셀의 최대 높이를 정의해요. 기본값은 115픽셀이에요. |
Appearance 설정
다음 표는 Appearance 설정을 설명해요.
| 설정 | 설명 |
|---|---|
accessibility:disableAnimations |
애니메이션을 활성화하거나 비활성화해요. 기본값은 Off예요. |
pageNavigation |
탐색 창 스타일을 정의해요. 기본값은 Modern이에요. |
theme:darkMode |
다크 모드를 활성화하거나 비활성화해요. 기본값은 Off예요. 다크 모드는 OpenSearch Dashboards 2.10 이상 버전에서만 사용할 수 있어요. |
theme:version |
OpenSearch Dashboards의 현재 버전과 이후 버전에서 사용할 테마를 정의해요. 기본값은 v7이에요. |
Discover 설정
다음 표는 Discover 설정을 설명해요.
| 설정 | 설명 |
|---|---|
context:defaultSize |
context 뷰에 표시할 주변 항목 수를 정의해요. 기본값은 5예요. |
context:step |
context 크기를 늘리거나 줄일 단위를 정의해요. 기본값은 5예요. |
context:tieBreakerFields |
타임스탬프 값이 같은 문서 사이의 순위를 정할 때 사용하는 필드를 정의해요. 현재 인덱스 패턴에서 존재하면서 정렬 가능한 첫 번째 필드가 사용돼요. 기본값은 _doc이에요. |
defaultColumns |
Discover 페이지에 기본으로 표시되는 열을 정의해요. 기본값은 _source예요. |
discover:aggs:terms:size |
필드 드롭다운에서 Visualize 버튼을 선택할 때 시각화되는 텀 개수를 정의해요. 기본값은 20이에요. |
discover:modifyColumnsOnSwitch |
새 인덱스 패턴에서 사용할 수 없는 열을 제거할지 여부를 정의해요. 기본값은 On이에요. |
discover:sampleSize |
테이블에 표시할 행 수를 정의해요. 기본값은 20이에요. |
discover:searchOnPageLoad |
Discover가 처음 로드될 때 검색을 실행할지 여부를 정의해요. 이 설정은 저장된 검색을 로드할 때는 영향을 주지 않아요. 기본값은 On이에요. |
discover:sort:defaultOrder |
시간 기반 인덱스 패턴의 정렬 방식을 정의해요. 기본값은 Descending이에요. |
doc_table:hideTimeColumn |
Discover 애플리케이션과 저장된 모든 대시보드 검색에서 Time 열을 숨길지 여부를 정의해요. 기본값은 Off예요. |
doc_table:highlight |
Discover 애플리케이션과 대시보드의 저장된 검색에서 결과를 강조 표시할지 여부를 정의해요. 강조 표시를 하면 결과를 찾고 식별하기 쉬워지지만, 큰 문서를 다룰 때는 요청이 느려질 수도 있어요. |
Notifications 설정
다음 표는 Notifications 설정을 설명해요.
| 설정 | 설명 |
|---|---|
notifications:banner |
임시 사용자 알림을 위한 커스텀 배너를 정의해요. Markdown을 지원해요. |
notifications:lifetime:banner |
배너 알림의 표시 시간을 정의해요. 기본값은 3000000밀리초예요. 알림을 비활성화하려면 필드를 Infinity로 설정하세요. |
notifications:lifetime:error |
오류 알림의 표시 시간을 정의해요. 기본값은 300000밀리초예요. 알림을 비활성화하려면 필드를 Infinity로 설정하세요. |
notifications:lifetime:info |
정보 알림의 표시 시간을 정의해요. 기본값은 5000밀리초예요. 알림을 비활성화하려면 필드를 Infinity로 설정하세요. |
notifications:lifetime:warning |
경고 알림의 표시 시간을 정의해요. 기본값은 10000밀리초예요. 알림을 비활성화하려면 필드를 Infinity로 설정하세요. |
Search 설정
다음 표는 Search 설정을 설명해요.
| 설정 | 설명 |
|---|---|
courier:batchSearches |
대시보드 패널의 로드 방식을 활성화하거나 비활성화해요. 비활성화하면 패널이 각각 로드되고, 사용자가 다른 곳으로 이동하거나 쿼리를 업데이트하면 검색 요청이 종료돼요. 활성화하면 모든 데이터가 로드됐을 때 모든 패널이 한꺼번에 로드되며, 검색은 종료되지 않아요. 기본값은 Off예요. |
courier:customRequestPreference |
custom 설정과 함께 request preference를 사용할지 여부를 지정해요. 기본값은 _local이에요. |
courier:ignoreFilterIfFieldNotInIndex |
서로 다른 인덱스를 사용하는 시각화가 들어 있는 대시보드 지원을 활성화하거나 비활성화해요. 비활성화하면 모든 필터가 모든 시각화에 적용돼요. 활성화하면 시각화의 인덱스에 필터 대상 필드가 없을 때 그 시각화의 필터가 무시돼요. 기본값은 Off예요. |
courier:maxConcurrentShardRequests |
OpenSearch Dashboards가 _msearch 요청에 대해 시작할 수 있는 동시 샤드 요청의 최대 개수를 정의해요. 0으로 설정하면 이 설정이 비활성화되고 OpenSearch에서 지정한 기본값이 사용돼요. 기본값은 0이에요. |
courier:setRequestPreference |
검색 요청을 처리할 샤드를 정의해요. 옵션은 Session ID, Custom, None이 있어요. Session ID는 모든 검색 요청이 같은 샤드에서 실행되도록 동작을 제한하고, 요청 간에 샤드 캐시를 재사용해서 성능을 높일 수 있어요. Custom은 직접 preference를 정의할 때 사용해요. courier:customRequestPreference로 preference 값을 지정하세요. None은 preference를 설정하지 않는다는 뜻이에요. 이 옵션은 요청이 모든 샤드 복사본에 분산될 수 있어서 더 나은 성능을 낼 수 있지만, 샤드마다 refresh 상태가 다를 수 있어 결과가 일관되지 않을 수 있어요. 기본값은 Session ID예요. |
search:includeFrozen |
검색 결과에 frozen 인덱스를 포함할지 여부를 지정해요. 활성화하면 검색 결과에 frozen 인덱스가 포함돼요. frozen 인덱스를 검색하면 검색 시간이 길어질 수 있어요. 기본값은 Off예요. |
타임라인 설정
다음 표는 타임라인 설정에 대해 설명해요.
| 설정 | 설명 |
|---|---|
timeline:es.default_index |
.opensearch() 함수로 검색할 기본 OpenSearch 인덱스를 정의해요. 설정하지 않으면 .opensearch() 함수가 모든 인덱스를 검색해요. 기본값은 _all이에요. |
timeline:es.timefield |
.opensearch() 함수를 사용할 때의 기본 타임스탬프 필드를 정의해요. 설정하지 않으면 .opensearch() 함수가 @timestmap 필드를 사용해요. 기본값은 @timestmap이에요. |
timeline:graphite.url |
(실험적 기능) graphite 호스트 URL을 정의해요. |
timeline:max_buckets |
단일 데이터 소스가 반환할 수 있는 최대 버킷 수를 정의해요. 기본값은 2000이에요. |
timeline:min_interval |
auto 간격을 사용할 때 계산할 최소 간격을 정의해요. 기본값은 1ms예요. |
timeline:quandl.key |
(실험적 기능) Quandl 데이터에 접근할 수 있게 해 주는 고유 식별자(API 키)를 정의해요. |
timeline:target_buckets |
시각화에서 자동 간격을 계산할 때 OpenSearch Dashboards가 사용하려고 시도하는 버킷 수를 정의해요. 기본값은 200이에요. |
시각화 설정
다음 표는 시각화 설정에 대해 설명해요.
| 설정 | 설명 |
|---|---|
visualization:colorMapping |
시각화 내 값에 색상을 할당해요. 기본값은 #00A69B예요. |
visualization:dimmingOpacity |
다른 차트 요소가 강조될 때 흐려지는 차트 항목의 불투명도를 정의해요. 값이 낮을수록 강조된 요소가 더 눈에 띄어요. 값은 0과 1 사이여야 해요. 기본값은 0.5예요. |
visualization:enablePluginAugmentation |
라인 차트 시각화를 통한 플러그인 기능 접근을 활성화하거나 비활성화해요. 기본값은 On이에요. |
line chart visualizations |
시각화 하나당 연결할 수 있는 증강(augmentation)의 최대 개수를 정의해요. 기본값은 10이에요. 시각화 하나에 10개를 넘는 플러그인 리소스를 연결하면 성능 문제가 생길 수 있어요. |
visualization:heatmap:maxBuckets |
히트맵 시각화에서 단일 데이터 소스가 반환할 수 있는 최대 버킷 수를 정의해요. 버킷 수가 많으면 브라우저 렌더링 성능에 부정적인 영향을 줄 수 있어요. 기본값은 50이에요. |
visualization:regionmap:customVectorMapMaxSize |
커스텀 벡터 맵에서 로드할 수 있는 피처의 최대 개수를 정의해요. 기본값은 1000이에요. |
visualization:regionmap:showWarnings |
리전 맵에서 용어를 셰이프에 조인할 수 없을 때 경고를 표시할지 여부를 지정해요. 기본값은 On이에요. |
visualization:tileMap:WMSdefaults |
좌표 맵에서 Web Map Service(WMS) 맵 서버의 기본 속성을 정의해요. 기본값은 enabled: false예요. |
visualization:tileMap:maxPrecision |
맵에 표시할 수 있는 최대 geohash 정밀도를 정의해요. 7은 높음, 10은 매우 높음, 12가 최대예요. 기본값은 7이에요. |
visualize:disableBucketAgg |
시각화에서 특정 버킷 집계를 비활성화해요. 이 설정에는 significant_terms, terms 같은 버킷 집계 이름을 쉼표로 구분한 목록을 지정해요. |
visualize:enableLabs |
실험적 시각화를 활성화하거나 비활성화해요. 활성화하면 실험적 시각화를 만들고, 보고, 편집할 수 있어요. 비활성화하면 프로덕션에서 사용할 준비가 된 시각화만 사용할 수 있어요. 기본값은 On이에요. |