GuanceDB 엔진 배포¶
참고
CPU는 AVX2 명령어 세트를 지원해야 합니다. grep avx2 /proc/cpuinfo를 실행하여 테스트하세요. 출력이 없으면 AVX2를 지원하지 않는 것입니다.
이 문서에서는 GuanceDB for Metrics 구성 요소와 GuanceDB for Logs 구성 요소를 배포하는 방법을 설명합니다. 두 구성 요소 모두 단일 차트를 사용하여 배포됩니다.
아키텍처¶
- GuanceDB 차트는 GuanceDB for Metrics와 GuanceDB for Logs 두 가지 구성 요소를 포함하며, 이 두 구성 요소는 guance-insert 및 guance-select 서비스를 공유하여 통합된 쓰기 및 쿼리 인터페이스를 제공합니다.
- GuanceDB for Metrics 구성 요소를 배포하면 GuanceDB for Metrics Storage도 함께 배포됩니다.
핵심 구성 요소¶
-
쓰기 로드 밸런서 (guance-insert)
-
원시 데이터 수신을 담당합니다.
- 일관된 해싱(Consistent Hashing) 알고리즘을 통해 데이터를 스토리지 노드에 분산합니다.
-
고가용성 배포를 지원합니다.
-
쿼리 엔진 (guance-select)
-
DQL 및 PromQL 쿼리 언어를 지원합니다.
- 모든 스토리지 노드에서 데이터를 가져와 계산합니다.
-
최종 쿼리 결과를 반환합니다.
-
스토리지 노드 (guance-storage)
-
Share Nothing 아키텍처를 채택합니다.
- 노드 간 통신이 없으며, 중앙 코디네이터가 없습니다.
- 수평 확장을 지원합니다.
전제 조건¶
- Helm 버전 요구 사항: 3.7+
- 스토리지 성능이 요구 사항을 충족하는지 확인하세요.
- 충분한 시스템 리소스를 확보하는 것이 좋습니다.
배포 기본 설정 정보¶
| 서비스 이름 | 주소 | 포트 |
|---|---|---|
| guance-insert | guance-insert.guancedb | 8480 |
| guance-select | guance-select.guancedb | 8481 |
용량 계획¶
-
메모리 예약
-
모든 구성 요소는 최소 50%의 메모리를 예약해야 합니다.
-
예상치 못한 쓰기 급증에 대비하여 OOM을 방지합니다.
-
CPU 예약
-
모든 구성 요소는 최소 50%의 CPU를 예약해야 합니다.
-
쓰기 및 쿼리 속도 저하를 방지합니다.
-
스토리지 공간 예약
-
guance-storage 노드는 20%의 스토리지 공간을 예약해야 합니다.
-storage.minFreeDiskSpaceBytes매개변수를 통해 구성할 수 있습니다.
참고 구성¶
100만 타임라인 기준 (10초마다 쓰기, 실시간 쓰기 QPS 10만/초, 쿼리 QPS 100, 데이터 보존 기간 1개월):
| 구성 요소 | CPU | 메모리 | 디스크 |
|---|---|---|---|
| guance-insert | 4c | 4G | - |
| guance-select | 8c | 8G | - |
| guance-storage | 16c | 96G | 500G |
참고: 실제 배포 시 타임라인 수에 따라 리소스 규모를 선형적으로 조정할 수 있습니다. 각 구성 요소는 기본적으로 2개의 인스턴스를 지원합니다.
GuanceDB 엔진 배포¶
참고
GuanceDB for Metrics와 GuanceDB for Logs는 배포 순서가 있습니다. 먼저 GuanceDB for Metrics를 배포한 후, Doris 배포가 완료되면 Doris 정보를 구성하여 GuanceDB for Logs를 설치할 수 있습니다. GuanceDB for Logs 구성 요소만 배포하려면 guance_storage.enabled=false를 설정하세요.
스토리지 클래스 설정¶
OpenEBS 참고 문서: OpenEBS 배포
공개 클라우드를 사용하는 경우 공개 클라우드 스토리지 블록 구성 요소를 참고하세요.
다음 yaml 구성을 배포합니다:
apiVersion: storage.k8s.io/v1
allowVolumeExpansion: true
kind: StorageClass
metadata:
annotations:
cas.openebs.io/config: |
- name: StorageType
value: "hostpath"
- name: BasePath
value: "/data"
name: guancedb-cs
provisioner: openebs.io/local
reclaimPolicy: Retain
volumeBindingMode: WaitForFirstConsumer
/data디렉터리의 디스크 용량이 충분한지 확인하세요.
다음 yaml 구성을 배포합니다:
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: guancedb-cs
provisioner: diskplugin.csi.alibabacloud.com
parameters:
type: cloud_auto
fstype: ext4
# diskTags: "a:b,b:c"
encrypted: "false"
performanceLevel: PL1 # 클라우드 박스 사용 시 PL0으로 설정해야 합니다.
provisionedIops: "40000"
burstingEnabled: "false"
volumeBindingMode: WaitForFirstConsumer
reclaimPolicy: Retain
allowVolumeExpansion: true
다음 yaml 구성을 배포합니다:
---
allowVolumeExpansion: true
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: guancedb-cs
parameters:
csi.storage.k8s.io/csi-driver-name: disk.csi.everest.io
csi.storage.k8s.io/fstype: ext4
everest.io/disk-volume-type: SSD ## 디스크 유형 수정
everest.io/passthrough: "true"
provisioner: everest-csi-provisioner
reclaimPolicy: Delete
volumeBindingMode: WaitForFirstConsumer
차트 다운로드¶
참고
Git을 사용하여 values.yaml을 관리하는 것을 권장합니다. values.yaml 파일을 Git에 포함시켜 매번 구성 변경 사항을 기록하고 추적 및 롤백이 용이하도록 하세요.
차트 패키지를 다운로드합니다:
--untar는 압축을 풀지 않음을 의미하며, 기본값은 압축입니다.
GuanceDB for Metrics 설치 구성¶
- GuanceDB for Metrics 구성
guancedb 디렉터리로 이동하여 values.yaml을 수정합니다.
# 글로벌 스토리지 클래스 수정
global:
storageClass: 'guancedb-cs'
# scopedb 스위치 비활성화
scopedb:
enabled: false
guance_select:
...
# 서비스 복제본 수
replicaCount: 3
image:
# 오프라인 환경에서 이미지 주소를 수정해야 하는 경우, 해당 요구 사항이 없으면 수정하지 않아도 됩니다.
repository: pubrepo.guance.com/guancedb/guance-select
# guance-select 컨테이너 스케줄링을 위한 nodeSelector 및 tolerations 수정, 해당 요구 사항이 없으면 수정하지 않아도 됩니다.
nodeSelector: {}
tolerations:
[]
# - key: "key"
# operator: "Equal|Exists"
# value: "value"
# effect: "NoSchedule|PreferNoSchedule"
guance_insert:
...
# 서비스 복제본 수
replicaCount: 3
image:
# 오프라인 환경에서 이미지 주소를 수정해야 하는 경우, 해당 요구 사항이 없으면 수정하지 않아도 됩니다.
repository: pubrepo.guance.com/guancedb/guance-insert
# guance-insert 컨테이너 스케줄링을 위한 nodeSelector 및 tolerations 수정, 해당 요구 사항이 없으면 수정하지 않아도 됩니다.
nodeSelector: {}
tolerations:
[]
# - key: "key"
# operator: "Equal|Exists"
# value: "value"
# effect: "NoSchedule|PreferNoSchedule"
guance_storage:
...
# 서비스 복제본 수
replicaCount: 2
image:
# 오프라인 환경에서 이미지 주소를 수정해야 하는 경우, 해당 요구 사항이 없으면 수정하지 않아도 됩니다.
repository: pubrepo.guance.com/guancedb/guance-storage
# guance-storage 컨테이너 스케줄링을 위한 nodeSelector 및 tolerations 수정, 해당 요구 사항이 없으면 수정하지 않아도 됩니다.
nodeSelector: {}
tolerations:
[]
# - key: "key"
# operator: "Equal|Exists"
# value: "value"
# effect: "NoSchedule|PreferNoSchedule"
- GuanceDB for Metrics 구성 요소 설치
helm upgrade -i guancedb oci://pubrepo.guance.com/guancedb/guancedb \
-n guancedb --create-namespace -f values.yaml
- 상태 확인 {#helm-check}
> kubectl get pod -n guancedb -l app.kubernetes.io/instance=guancedb
NAME READY STATUS RESTARTS AGE
guance-insert-0 1/1 Running 0 107s
guance-select-db5dfb66b-qsncr 1/1 Running 0 84s
guance-storage-0 1/1 Running 0 44s
guance-storage-1 1/1 Running 0 28s
GuanceDB for Logs 설치 구성¶
참고
이미 GuanceDB for Metrics 구성 요소를 배포한 경우, GuanceDB for Logs를 설치해도 새로운 서비스가 추가되지 않으며, 기존 서비스의 시작 매개변수만 추가됩니다.
- GuanceDB for Logs 구성
guancedb 디렉터리로 이동하여 values.yaml을 수정합니다.
참고
values.yaml은 GuanceDB for Metrics를 구성하는 파일입니다. values.yaml이 손실된 경우 helm get values -n guancedb guancedb > values.yaml을 실행하여 복구할 수 있습니다.
...
doris:
# GuanceDB for Logs 활성화
enabled: true
# Doris FE 노드 추가
feIPs: []
# ["xx.xx.xx.xx","xx.xx.xx.xx"]
# Doris root 비밀번호
rootPassword: ''
# Doris 일반 사용자 비밀번호
userReadPassword: ''
# 캐시 데이터를 위한 메모리 크기
cacheSizeLimit: 4Gi
guance_throttler:
# 활성화
enabled: true
...
- GuanceDB for Logs 설치
helm upgrade -i guancedb oci://pubrepo.guance.com/guancedb/guancedb \
-n guancedb --create-namespace -f values.yaml
- 상태 확인 {#helm-check-logs}
> kubectl get pod -n guancedb -l app.kubernetes.io/instance=guancedb
NAME READY STATUS RESTARTS AGE
guance-insert-0 1/1 Running 0 107s
guance-select-db5dfb66b-qsncr 1/1 Running 0 84s
guance-storage-0 1/1 Running 0 44s
guance-storage-1 1/1 Running 0 28s
제거¶
기타¶
구성 요소 매개변수 수정¶
- values.yaml 수정
guance_storage:
...
# 여기에 storage 매개변수를 추가할 수 있습니다.
extraArgs:
retentionFilters.config: http://kodo.forethought-kodo:9527/v1/workspace_retention
envflag.enable: 'true'
loggerFormat: json
loggerMaxArgLen: '10000'
loggerTimezone: Asia/Shanghai
guance_insert:
...
# 여기에 insert 매개변수를 추가할 수 있습니다.
extraArgs:
envflag.enable: 'true'
loggerFormat: json
loggerMaxArgLen: '10000'
loggerTimezone: Asia/Shanghai
guance_select:
# 여기에 select 매개변수를 추가할 수 있습니다.
...
extraArgs:
envflag.enable: 'true'
loggerFormat: json
loggerMaxArgLen: '10000'
loggerTimezone: Asia/Shanghai
http.disableResponseCompression: 'true'
search.denyPartialResponse: true
search.maxQueryDuration: 110s
slowQueryDuration: 1ms
streamaggr.selectVerify: 'true'
- 배포 업데이트:
helm upgrade -i guancedb oci://pubrepo.guance.com/guancedb/guancedb \
-n guancedb --create-namespace -f values.yaml
서비스 매개변수 설명¶
Guance Select 매개변수 설명¶
| 매개변수명 | 유형 | 기본값 | 설명 |
|---|---|---|---|
| -blockcache.missesBeforeCaching | int | 2 | 블록을 캐시에 넣기 전 캐시 미스 횟수입니다. 값이 클수록 indexdb/dataBlocks 캐시 크기를 줄일 수 있지만, CPU 및 디스크 읽기 작업이 증가합니다. |
| -cacheDataPath | string | "/tmp/guance-select" | 캐시 파일 디렉터리 경로입니다. 비어 있으면 캐시를 저장하지 않습니다. |
| -cacheExpireDuration | duration | 30m0s | 메모리 캐시 항목이 지정된 시간 동안 액세스되지 않으면 제거됩니다. 값을 낮추면 메모리 사용량을 줄일 수 있지만 CPU 사용량이 증가합니다. |
| -dedup.minScrapeInterval | duration | 1ms | 각 시계열의 각 이산 시간 간격 내에서 마지막 샘플만 유지하여 중복을 방지합니다. |
| -denyQueryTracing | bool | 쿼리 추적 기능을 비활성화할지 여부입니다. | |
| -doris.coldDataTierOnly | bool | 콜드 스토리지만 사용합니다. | |
| -doris.disableBFOnNewTables | bool | 새 테이블에 블룸 필터를 사용하지 않습니다. | |
| -doris.disableUnicodeTokenizer | bool | 유니코드 토크나이저 대신 중국어 토크나이저를 사용합니다. | |
| -doris.enableBFOnOldTables | bool | 기존 테이블에 블룸 필터를 사용합니다. | |
| -doris.enableFileCacheTTL | bool | 클라우드 데이터베이스 SelectDB 버전의 데이터 캐시를 사용합니다. | |
| -doris.enableWarmDataTier | bool | 핫+콜드 스토리지 대신 웜 스토리지를 사용합니다. | |
| -doris.indexCacheTTL | duration | 30m0s | Doris 인덱스 캐시의 만료 시간입니다. |
| -doris.onlyQueryFE | bool | 활성화하면 백엔드(be)에서 직접 데이터를 쿼리하지 않습니다. | |
| -doris.onlyWriteFE | bool | 활성화하면 백엔드(be)에 직접 데이터를 쓰지 않습니다. | |
| -doris.replicationFactor | int | 1 | Doris 테이블의 복제본 수입니다. |
| -doris.storageResource | string | "s3_default" | 스토리지 정책에 사용되는 리소스 이름입니다. |
| -doris.variantSchemaMode | string | 지원되는 값: 'none', 'minimal', 'full'입니다. | |
| -dorisCluster | string | "default_cluster" | Doris 클러스터 이름입니다. |
| -dorisFENode | array | Doris FE 노드 주소 목록입니다. 쉼표로 구분합니다. | |
| -dorisHTTPPort | int | 8030 | Doris HTTP 포트입니다. |
| -dorisMySQLPort | int | 9030 | Doris MySQL 포트입니다. |
| -dorisPassword | string | Doris 비밀번호입니다. | |
| -dorisUsername | string | "root" | Doris 사용자 이름입니다. |
| -enableTCP6 | bool | IPv6 수신 및 다이얼을 활성화할지 여부입니다. 기본값은 IPv4만 사용합니다. | |
| -envflag.enable | bool | 환경 변수에서 매개변수를 읽을 수 있도록 허용할지 여부입니다. 명령줄 매개변수가 우선합니다. | |
| -envflag.prefix | string | 환경 변수 접두사입니다. 환경 변수 읽기가 활성화된 경우에만 적용됩니다. | |
| -filestream.disableFadvise | bool | fadvise() 시스템 호출을 비활성화할지 여부입니다. 대용량 파일을 읽을 때 CPU 사용량을 줄일 수 있지만 일반적으로 비활성화하지 않는 것이 좋습니다. | |
| -flagsAuthKey | value | /flags 엔드포인트의 인증 키입니다. 파일 또는 URL에서 읽기를 지원합니다. | |
| -fs.disableMmap | bool | 데이터 파일 읽기에 mmap() 대신 pread()를 사용할지 여부입니다. 64비트 아키텍처는 기본적으로 mmap()을 사용하고, 32비트는 pread()를 사용합니다. | |
| -globalReplicationFactor | int | 1 | vmstorage 그룹 내 각 샘플의 복제본 수입니다. 고가용성을 지원합니다. |
| -http.connTimeout | duration | 2m0s | HTTP 연결 제한 시간입니다. 시간 초과 후 연결이 닫힙니다. 0은 닫지 않음을 의미합니다. |
| -http.disableResponseCompression | bool | CPU를 절약하기 위해 HTTP 응답 압축을 비활성화할지 여부입니다. 기본적으로 압축이 활성화되어 대역폭을 절약합니다. | |
| -http.header.csp | string | Content-Security-Policy 헤더를 설정합니다. 권장: "default-src 'self'". | |
| -http.header.frameOptions | string | X-Frame-Options 헤더를 설정합니다. | |
| -http.header.hsts | string | Strict-Transport-Security 헤더를 설정합니다. 권장: 'max-age=31536000; includeSubDomains'. | |
| -http.idleConnTimeout | duration | 1m0s | HTTP 유휴 연결 제한 시간입니다. |
| -http.maxGracefulShutdownDuration | duration | 7s | HTTP 서버의 정상 종료 최대 시간입니다. |
| -http.pathPrefix | string | 모든 HTTP 경로에 접두사를 추가합니다. 프록시 경로에 유용합니다. | |
| -http.shutdownDelay | duration | HTTP 서버 종료 전 지연 시간입니다. 이 기간 동안 /health는 OK가 아닌 상태를 반환하여 로드 밸런서가 요청을 전환할 수 있도록 합니다. | |
| -httpAuth.password | value | HTTP 기본 인증 비밀번호입니다. 파일 또는 URL에서 읽기를 지원합니다. | |
| -httpAuth.username | string | HTTP 기본 인증 사용자 이름입니다. 비어 있으면 인증이 비활성화됩니다. | |
| -httpListenAddr | array | HTTP 수신 주소 목록입니다. 여러 값 또는 쉼표로 구분을 지원합니다. | |
| -httpListenAddr.useProxyProtocol | array | 지정된 수신 주소에 대해 프록시 프로토콜을 활성화할지 여부입니다. 활성화하면 일반 /metrics 엔드포인트를 제공할 수 없습니다. | |
| -insert.maxFutureTimeDrift | duration | 1h0m0s | 현재 시간 + 이 값보다 큰 타임스탬프를 가진 이벤트를 거부합니다. |
| -insert.maxPastTimeDrift | duration | 현재 시간 - 이 값보다 작은 타임스탬프를 가진 이벤트를 거부합니다. | |
| -insertNode | array | Guance-insert 노드 주소 목록입니다. 쉼표로 구분합니다. | |
| -internStringCacheExpireDuration | duration | 6m0s | 문자열 인턴 캐시 만료 시간입니다. |
| -internStringDisableCache | bool | 문자열 인턴 캐시를 비활성화할지 여부입니다. 비활성화하면 메모리는 줄어들지만 CPU 사용량이 증가합니다. | |
| -internStringMaxLen | int | 500 | 최대 인턴 문자열 길이입니다. 값이 낮을수록 메모리는 줄어들지만 CPU 사용량이 증가합니다. |
| -loggerDisableTimestamps | bool | false | 로그에 타임스탬프 쓰기를 비활성화할지 여부입니다. |
| -loggerErrorsPerSecondLimit | int | 0 | 초당 오류 로그 제한입니다. 제한을 초과하는 오류는 억제됩니다. 0은 제한 없음을 의미합니다. |
| -loggerFormat | string | "default" | 로그 형식입니다. "default" 또는 "json"을 선택할 수 있습니다. |
| -loggerJSONFields | string | - | JSON 형식 로그 필드 이름을 바꿉니다. 예: "ts:timestamp,msg:message". |
| -loggerLevel | string | "INFO" | 최소 로그 수준입니다. INFO, WARN, ERROR, FATAL, PANIC을 지원합니다. |
| -loggerMaxArgLen | int | 1000 | 단일 로그 매개변수의 최대 길이입니다. 초과 부분은 접두사와 접미사로 대체됩니다. |
| -loggerOutput | string | "stderr" | 로그 출력 위치입니다. stderr 및 stdout을 지원합니다. |
| -loggerTimezone | string | "UTC" | 로그 타임스탬프에 사용되는 시간대입니다. 유효한 IANA 시간대 이름이어야 합니다. |
| -loggerWarnsPerSecondLimit | int | 0 | 초당 경고 로그 제한입니다. 제한을 초과하는 경고는 억제됩니다. 0은 제한 없음을 의미합니다. |
| -memory.allowedBytes | size | 0 | VictoriaMetrics 캐시가 사용할 수 있는 시스템 메모리 크기입니다. 설정 시 -memory.allowedPercent를 재정의합니다. |
| -memory.allowedPercent | float | 60 | VictoriaMetrics 캐시가 사용할 수 있는 시스템 메모리 백분율입니다. |
| -metrics.exposeMetadata | bool | false | /metrics 페이지에 TYPE 및 HELP 메타데이터를 노출할지 여부입니다. |
| -metricsAuthKey | value | - | /metrics 엔드포인트의 인증 키입니다. 파일 또는 URL에서 읽기를 지원합니다. |
| -pprofAuthKey | value | - | /debug/pprof/* 엔드포인트의 인증 키입니다. 파일 또는 URL에서 읽기를 지원합니다. |
| -prevCacheRemovalPercent | float | 0.1 | 이전 캐시에서 서비스 요청 비율이 이 값보다 낮으면 캐시 항목을 제거합니다. 메모리 효율성을 높이지만 CPU 사용량이 증가합니다. |
| -pushmetrics.disableCompression | bool | false | 메트릭 푸시 시 요청 본문 압축을 비활성화할지 여부입니다. |
| -pushmetrics.extraLabel | array | - | 메트릭 푸시 시 추가 레이블입니다. 예: instance="foo". |
| -pushmetrics.header | array | - | 메트릭 푸시 시 추가 HTTP 요청 헤더입니다. |
| -pushmetrics.interval | duration | 10s | 메트릭 푸시 간격입니다. |
| -pushmetrics.url | array | - | 메트릭을 푸시할 URL 목록입니다. |
| -queryPermitRatio | float | 1 | 허용되는 쿼리 요청 비율입니다. |
| -replicationFactor | array | 1 | 각 샘플의 복제본 수입니다. key:value 형식을 지원합니다. |
| -retentionFilters.cleanInterval | duration | 360h | 만료된 데이터 정리 간격입니다. |
| -retentionFilters.config | string | - | 보존 필터 구성 파일 경로입니다. |
| -retentionFilters.configCheckInterval | duration | 1h | 보존 필터 구성 파일 변경 감지 간격입니다. |
| -scopeDB.dbName | string | "scopedb" | ScopeDB 데이터베이스 이름입니다. |
| -scopeDB.dumpIngestBody | bool | false | 실패 시 쓰기 내용을 출력할지 여부입니다. |
| -scopeDB.ensureJob | bool | false | 작업 보장 기능을 활성화할지 여부입니다. |
| -scopeDB.indexCacheTTL | duration | 5m | ScopeDB 인덱스 캐시 TTL입니다. |
| -scopeDB.maxConcurrentIndexRequests | int | 32 | 최대 동시 인덱스 요청 수입니다. |
| -scopeDB.node | array | - | ScopeDB 노드 주소 목록입니다. |
| -scopeDB.nodegroup.ctl | string | "query-meta" | 제어 플레인 노드 그룹 이름입니다. |
| -scopeDB.nodegroup.detailQuery | string | "detail-query" | 비집계 쿼리 노드 그룹 이름입니다. |
| -scopeDB.nodegroup.job | string | "job" | 작업 실행 노드 그룹 이름입니다. |
| -scopeDB.nodegroup.largeQuery | string | "large-query" | 대규모 쿼리 노드 그룹 이름입니다. |
| -scopeDB.nodegroup.query | string | "query" | 일반 쿼리 노드 그룹 이름입니다. |
| -scopeDB.nodegroup.systemQuery | string | "system-query" | "func" 및 "kodo"와 같은 참조자의 시스템 쿼리 노드 그룹 이름입니다. |
| -scopeDB.nodesUpdateInterval | duration | 10s | 노드 업데이트 간격입니다. |
| -scopeDB.onlyUseBootstrapNodes | bool | false | 부트스트랩 노드만 사용할지 여부입니다. |
| -scopeDB.password | string | - | ScopeDB 비밀번호입니다. |
| -scopeDB.port | uint | 6543 | ScopeDB 포트입니다. |
| -scopeDB.storage.accessKeyID | string | - | ScopeDB 스토리지 액세스 키 ID입니다. |
| -scopeDB.storage.bucket | string | - | ScopeDB 스토리지 버킷입니다. |
| -scopeDB.storage.endpoint | string | - | ScopeDB 스토리지 서비스 엔드포인트입니다. |
| -scopeDB.storage.prefix | string | - | ScopeDB 스토리지 접두사입니다. |
| -scopeDB.storage.region | string | - | ScopeDB 스토리지 리전입니다. |
| -scopeDB.storage.secretAccessKey | string | - | ScopeDB 스토리지 시크릿 액세스 키입니다. |
| -scopeDB.storage.type | string | - | ScopeDB 스토리지 유형입니다. |
| -scopeDB.username | string | - | ScopeDB 사용자 이름입니다. |
| -search.cacheTimestampOffset | duration | 5m | 쿼리 응답 데이터의 최대 시간 오프셋입니다. 시계 동기화 문제로 인한 응답 공백을 방지합니다. |
| -search.compatibleMode | bool | false | Prometheus 호환 모드를 활성화합니다. |
| -search.debugThrottler | bool | false | 스로틀러 디버깅입니다. |
| -search.denyPartialResponse | bool | false | 데이터 일관성을 위해 부분 응답을 거부할지 여부입니다. |
| -search.disableCache | bool | false | 응답 캐시를 비활성화합니다. 과거 데이터를 다시 채울 때 적합합니다. |
| -search.disableImplicitConversion | bool | false | 암시적 하위 쿼리 변환 관련 쿼리를 비활성화합니다. |
| -search.dorisColdQueryCPULimit | int | 4 | 콜드 데이터 쿼리의 SQL 변수 CPU 제한입니다. |
| -search.dorisDisableADBC | bool | false | Thrift를 ADBC보다 우선하여 사용합니다. |
| -search.dorisDisableSampling | bool | false | 샘플링을 비활성화합니다. |
| -search.dorisEnableSmallColdGroup | bool | false | 소규모 콜드 쿼리를 위해 전용 작업 그룹을 사용합니다. |
| -search.dorisLargeColdQueryRowCount | int | - | 더 이상 사용되지 않음. search.minRowsForLargeQuery를 대신 사용하십시오. |
| -search.dorisMaxCursorRows | int | 50000000 | 커서 쿼리 최대 스캔 행 수입니다. |
| -search.dorisMaxLiteralArraySize | int | 1000 | 배열 리터럴의 최대 요소 수입니다. |
| -search.dorisMaxOrderingRows | int | - | 사용자 정의 정렬 쿼리 최대 스캔 행 수입니다. |
| -search.dorisMaxRowsForOrder | int | - | 비시간 열 ORDER BY의 최대 사용 행 수입니다. |
| -search.dorisMaxSamplingRows | int | - | 더 이상 사용되지 않음. search.numRowsToSample를 대신 사용하십시오. |
| -search.dorisThrottlerURL | string | - | 스로틀러 API 주소입니다. |
| -search.latencyOffset | duration | 30s | 데이터 포인트가 수집된 후 쿼리 결과에 표시되기까지의 지연 시간입니다. latency_offset 쿼리 매개변수로 재정의할 수 있습니다. 너무 작은 값은 쿼리 결과의 마지막 데이터 포인트가 불완전해질 수 있습니다. |
| -search.logImplicitConversion | bool | - | 암시적 하위 쿼리 변환 쿼리를 기록할지 여부입니다. 자세한 내용은 암시적 변환 설명을 참조하십시오. -search.disableImplicitConversion을 사용하여 비활성화할 수 있습니다. |
| -search.logQueryMemoryUsage | size | 524288000 (500MB) | 이 값을 초과하는 메모리를 사용하는 쿼리를 기록하여 대규모 쿼리를 감지하고 최적화합니다. 기본적으로 비활성화되어 있습니다. KB, MB, GB 등의 단위를 지원합니다. |
| -search.maxConcurrentRequestsPerTenant | int | 5 | 테넌트당 최대 동시 쿼리 요청 수입니다. 너무 높으면 CPU 및 메모리 리소스가 부족해질 수 있습니다. |
| -search.maxExportDuration | duration | 720h (30일) | /api/v1/export 인터페이스의 최대 호출 시간입니다. |
| -search.maxGroups | int | 100000 | 쿼리 결과에서 허용되는 최대 그룹 수입니다. |
| -search.maxLabelsAPIDuration | duration | 5s | /api/v1/labels, /api/v1/label/.../values 및 /api/v1/series 인터페이스의 최대 응답 시간입니다. |
| -search.maxLimit | int | 10000 | 쿼리 결과에서 허용되는 최대 행 수입니다. |
| -search.maxLookback | duration | 동적 감지 | Prometheus의 -search.lookback-delta와 동의어입니다. max_lookback 매개변수로 재정의할 수 있습니다. 쿼리의 조회 시간 범위에 영향을 미칩니다. |
| -search.maxMemoryPerQuery | size | 0 | 단일 쿼리에 허용되는 최대 메모리입니다. 초과하면 쿼리 실행이 거부됩니다. KB, MB, GB 등의 단위를 지원합니다. |
| -search.maxMetrics | int | 10000000 | 더 이상 사용되지 않음. -search.maxShowUniqueTimeseries 및 -search.maxQueryUniqueTimeseries로 마이그레이션되었습니다. |
| -search.maxPointsPerTimeseries | int | 30000 | /api/v1/query_range가 반환하는 단일 시계열의 최대 데이터 포인트 수입니다. 주로 차트 클라이언트의 포인트 수를 제한합니다. |
| -search.maxPointsSubqueryPerTimeseries | int | 100000 | 하위 쿼리당 시계열이 생성할 수 있는 최대 데이터 포인트 수입니다. 자세한 내용은 관련 블로그를 참조하십시오. |
| -search.maxQueryDuration | duration | 30s | 쿼리 최대 실행 시간입니다. |
| -search.maxQueryLen | size | 16384 (16KB) | 쿼리 문 최대 길이입니다. KB, MB 등의 단위를 지원합니다. |
| -search.maxQueryUniqueTimeseries | int | 300000 | /api/v1/query 쿼리에서 선택할 수 있는 최대 고유 시계열 수입니다. 메모리 사용량을 제한합니다. |
| -search.maxQueueDuration | duration | 10s | 최대 동시 요청 수 제한에 도달했을 때 요청의 최대 대기 시간입니다. |
| -search.maxResponseSeries | int | 0 (무제한) | /api/v1/query 및 /api/v1/query_range의 최대 반환 시계열 수입니다. 0은 제한 없음을 의미합니다. |
| -search.maxSamplesPerQuery | int | 1000000000 | 단일 쿼리가 스캔할 수 있는 최대 원본 샘플 수입니다. 너무 큰 쿼리로 인한 리소스 고갈을 방지합니다. |
| -search.maxSamplesPerSeries | int | 30000000 | 각 시계열이 스캔할 수 있는 최대 원본 샘플 수입니다. |
| -search.maxSeriesPerAggrFunc | int | 1000000 | 집계 함수가 생성할 수 있는 최대 시계열 수입니다. |
| -search.maxShowUniqueTimeseries | int | 10000000 | show 함수가 표시할 수 있는 최대 시계열 수입니다. 메모리 사용량을 제한합니다. |
| -search.maxStalenessInterval | duration | 동적 계산 | 부실(staleness) 계산 최대 시간 간격입니다. 기본값은 샘플 중간 간격을 기준으로 자동 계산됩니다. |
| -search.maxStatusRequestDuration | duration | 5m0s | /api/v1/status/* 요청의 최대 응답 시간입니다. |
| -search.maxStepForPointsAdjustment | duration | 1m0s | /api/v1/query_range 인터페이스가 현재 시간에서 latencyOffset보다 작은 지점을 조정할 때의 최대 step입니다. |
| -search.maxWorkersPerQuery | int | 2 | 단일 쿼리에 허용되는 최대 CPU 코어 수입니다. 성능 최적화를 위해 조정할 수 있으며, 물리적 CPU 코어 수를 초과할 수 없습니다. |
| -search.minRowsForLargeQuery | int | 10000000 | 대규모 쿼리의 최소 스캔 행 수입니다. |
| -search.minStalenessInterval | duration | - | 부실 계산의 최소 시간 간격입니다. 샘플링 간격이 불규칙하여 차트가 끊어지는 것을 방지하는 데 사용됩니다. |
| -search.minTimeRangeForLargeQuery | duration | 12h0m0s | 대규모 쿼리의 최소 시간 범위입니다. |
| -search.minWindowForInstantRollupOptimization | duration | 3h | 조회 창이 있는 즉시 쿼리에 대해 캐시 최적화를 활성화하는 최소 창 값입니다. |
| -search.noStaleMarkers | bool | false | 데이터베이스에 Prometheus 부실 마커가 없는 경우 true로 설정하면 CPU 리소스를 절약할 수 있습니다. |
| -search.queryStats.lastQueriesCount | int | 20000 | /api/v1/status/top_queries가 추적하는 최근 쿼리 수입니다. 0은 비활성화를 의미합니다. |
| -search.queryStats.minQueryDuration | duration | 1ms | 통계에 기록되는 최소 쿼리 시간 임계값입니다. 이 시간보다 짧은 쿼리는 무시됩니다. |
| -search.resetRollupResultCacheOnStartup | bool | false | 시작 시 롤업 결과 캐시를 재설정할지 여부입니다. |
| -search.rowsToSample | int | 10000000 | 샘플링 쿼리 최대 스캔 행 수입니다. |
| -search.rowsToSampleForFacet | int | 10000000 | show_x_field 또는 distinct 쿼리 최대 스캔 행 수입니다. |
| -search.scopeDB.firstCursorScanRows | int | 10000000 | 커서 페이지네이션 쿼리에서 첫 번째 스캔의 최대 행 수입니다. |
| -search.scopeDB.logQuery | bool | true | scopeDB의 쿼리 문을 기록할지 여부입니다. |
| -search.scopeDB.maxLiteralArraySize | int | 1000 | 배열 리터럴의 최대 요소 수입니다. |
| -search.scopeDB.maxRowsForOrder | int | 100000 | 비시간 열의 order by 최대 행 수입니다. |
| -search.scopeDB.maxTimeRange | duration | - | 쿼리의 최대 시간 범위입니다. |
| -search.setLookbackToStep | bool | false | lookback을 step 매개변수로 고정할지 여부입니다. 쿼리 모델을 InfluxDB처럼 조정합니다. 활성화하면 -search.maxLookback 및 -search.maxStalenessInterval이 무시됩니다. |
| -search.skipSlowReplicas | bool | false | 쿼리 시 복제 인자에서 가장 느린 vmstorage 노드를 건너뛸지 여부입니다. 쿼리 속도를 향상시킬 수 있지만 데이터 불완전성의 위험이 있습니다. |
| -search.treatDotsAsIsInRegexps | bool | false | 정규 표현식에서 점 문자를 필터링할지 여부입니다. 이 옵션은 더 이상 사용되지 않습니다. graphite 구문을 사용하는 것이 좋습니다. |
| -slowQueryDuration | duration | 1s | 이 시간을 초과하는 쿼리는 느린 쿼리로 기록됩니다. |
| -storageNode | array | - | guance-storage 노드 주소 배열입니다. 쉼표로 구분하거나 여러 번 지정합니다. |
| -streamaggr.cleanupInterval | duration | 10m0s | 만료된 쿼리 정리 간격입니다. |
| -streamaggr.dataBlocksCacheSize | int | 157286400 (150MB) | 데이터 블록 캐시 크기입니다. |
| -streamaggr.ignoreContinuousCheck | bool | false | 연속성 검사를 무시할지 여부입니다. |
| -streamaggr.indexBlocksCacheSize | int | 52428800 (50MB) | 인덱스 블록 캐시 크기입니다. |
| -streamaggr.queryRetentionPeriod | duration | 168h0m0s (7일) | 쿼리 보존 기간입니다. |
| -streamaggr.retentionMonths | int | 6 | 스트림 집계 데이터 보존 월 수입니다. |
| -streamaggr.selectVerify | bool | false | 스트림 집계 결과를 확인할지 여부입니다. |
| -tls | array | 없음 | 지정된 -httpListenAddr에 대해 TLS(HTTPS)를 활성화할지 여부입니다. 이 매개변수를 설정할 때는 -tlsCertFile 및 -tlsKeyFile도 함께 설정해야 합니다. 쉼표로 구분된 여러 값 또는 여러 번 설정을 지원합니다. 빈 값은 false로 간주됩니다. |
| -tlsCertFile | array | 없음 | -httpListenAddr에 해당하는 TLS 인증서 파일 경로입니다. RSA 인증서보다 속도가 빠른 ECDSA 인증서를 사용하는 것이 좋습니다. 인증서 파일은 매초 자동으로 다시 읽혀지며 동적으로 업데이트할 수 있습니다. 여러 값을 지원합니다. |
| -tlsCipherSuites | array | 없음 | 선택적 TLS 암호 제품군 목록입니다. TLS 활성화 시 HTTPS 요청에 사용됩니다. 여러 값을 지원합니다. 자세한 지원 목록은 다음을 참조하십시오: https://pkg.go.dev/crypto/tls#pkg-constants |
| -tlsKeyFile | array | 없음 | -httpListenAddr에 해당하는 TLS 키 파일 경로입니다. 키 파일은 매초 자동으로 다시 읽혀지며 동적으로 업데이트할 수 있습니다. 여러 값을 지원합니다. |
| -tlsMinVersion | array | 없음 | TLS 최소 버전 제한(선택 사항)입니다. TLS10, TLS11, TLS12, TLS13을 지원합니다. 여러 값을 지원합니다. |
| -version | 매개변수 없음 | 없음 | VictoriaMetrics의 버전 정보를 표시합니다. |
| -vmstorageDialTimeout | duration | 3s | vmselect가 vmstorage와 RPC 연결을 설정하는 제한 시간입니다. -vmstorageUserTimeout을 참조하십시오. |
| -vmstorageUserTimeout | duration | 3s | vmselect와 vmstorage 간 RPC 연결의 네트워크 제한 시간(Linux 전용)입니다. 값이 낮을수록 네트워크 오류 시 최대 쿼리 시간이 단축됩니다. TCP_USER_TIMEOUT 설명을 참조하십시오. |
| -zipkin.batchSize | int | 100 | 단일 배치로 전송되는 최대 Span 수입니다. |
| -zipkin.bufferSize | int | 10000 | 버퍼링되는 최대 Span 수입니다. |
| -zipkin.endpoint | string | 없음 | Zipkin 수집기의 엔드포인트 URL입니다. 예: http://localhost:9529. |
| -zipkin.flushPeriod | duration | 1s | 최대 플러시 간격입니다. |
| -zipkin.serviceName | string | guance-select | Zipkin Span에서 사용되는 서비스 이름입니다. |
Guance Insert 매개변수 설명¶
| 매개변수명 | 유형 | 기본값 | 설명 |
|---|---|---|---|
| -blockcache.missesBeforeCaching | int | 2 | 블록을 캐시에 넣기 전 캐시 미스 횟수입니다. 값이 높을수록 캐시 크기를 줄일 수 있지만 CPU 및 디스크 읽기 부하가 증가합니다. |
| -cacheExpireDuration | duration | 30m0s | 메모리 캐시의 데이터가 일정 시간 동안 액세스되지 않으면 제거됩니다. 값이 작을수록 메모리 사용량은 줄어들지만 CPU 사용률이 증가합니다. |
| -denyQueryTracing | 없음 | 없음 | 쿼리 추적 기능을 비활성화할지 여부입니다. 자세한 내용은 다음을 참조하십시오: https://docs.victoriametrics.com/#query-tracing |
| -disableInflux | 없음 | true | Influx 형식 지원을 비활성화할지 여부입니다. |
| -disableRerouting | 없음 | true | 데이터 재라우팅을 비활성화할지 여부입니다. 일부 vmstorage의 쓰기 속도가 느릴 때 재라우팅이 트리거될 수 있습니다. 이 기능을 비활성화하면 롤링 재시작 시 활성 시계열을 줄일 수 있습니다. |
| -disableReroutingOnUnavailable | 없음 | 없음 | vmstorage 노드를 사용할 수 없을 때 재라우팅을 비활성화할지 여부입니다. 비활성화하면 특정 노드를 사용할 수 없을 때 데이터 쓰기가 중지되어 재시작 또는 시퀀스의 급격한 변경 영향을 줄일 수 있습니다. |
| -doris.cacheDataPath | string | /data/file-queue | 캐시 파일 경로입니다. |
| -doris.coldDataTierOnly | 없음 | 없음 | 콜드 데이터 스토리지 계층만 사용합니다. |
| -doris.debugIndexName | string | default | 디버그 로그를 추가해야 하는 indexName입니다. |
| -doris.debugMeasurement | string | 없음 | 디버그 로그를 추가해야 하는 measurement입니다. |
| -doris.debugNamespace | string | 없음 | 디버그 로그를 추가해야 하는 namespace입니다. |
| -doris.debugTenantID | uint | 없음 | 디버그 로그를 추가해야 하는 테넌트 ID(accountID)입니다. |
| -doris.disableBFOnNewTables | 없음 | 없음 | 새 테이블에 블룸 필터를 사용하지 않습니다. |
| -doris.disableKeepAlives | 없음 | 없음 | stream load에서 keep-alive를 비활성화합니다. |
| -doris.disableUnicodeTokenizer | 없음 | 없음 | 유니코드 토크나이저 대신 Chinese 토크나이저를 사용합니다. |
| -doris.enableBFOnOldTables | 없음 | 없음 | 기존 테이블에 대해 블룸 필터를 활성화합니다. |
| -doris.enableFileCacheTTL | 없음 | 없음 | 클라우드 데이터베이스 SelectDB 데이터 캐시를 활성화합니다: https://help.aliyun.com/document_detail/2638759.html |
| -doris.enableWarmDataTier | 없음 | 없음 | 핫+콜드 모드 대신 핫+웜 스토리지 모드를 활성화합니다. |
| -doris.forceFlushInterval | duration | 30s | 비이벤트 데이터의 강제 플러시 간격입니다. |
| -doris.indexCacheTTL | duration | 30m0s | doris 인덱스 캐시 TTL입니다. |
| -doris.loadToSingleTablet | 없음 | 없음 | stream load 요청에 load_to_single_tablet 헤더를 사용합니다. |
| -doris.maxCacheSize | size | 0 | 더 이상 사용되지 않음. fileQueue.maxTotalSize를 사용하십시오. 캐시된 총 데이터의 최대 바이트 수입니다. |
| -doris.maxConcurrentInserts | int | 없음 | 더 이상 사용되지 않음. fileQueue.workers를 사용하십시오. |
| -doris.maxFieldCount | size | 512 | 각 measurement에서 허용되는 최대 필드 수입니다. KB, MB, GB 등의 단위를 지원합니다. |
| -doris.maxFieldSize | size | 33554432 | 단일 필드의 최대 바이트 크기입니다. KB, MB, GB 등의 단위를 지원합니다. |
| -doris.maxSizePerRequest | size | 0 | 더 이상 사용되지 않음. fileQueue.maxFileSize를 사용하십시오. 단일 구문 분석에서 단일 행의 최대 크기입니다. |
| -doris.onlyQueryFE | 없음 | 없음 | 활성화하면 FE 노드에서만 데이터를 쿼리하고 BE에 직접 액세스하지 않습니다. |
| -doris.onlyWriteFE | 없음 | 없음 | 활성화하면 FE 노드에만 데이터를 쓰고 BE에 직접 쓰지 않습니다. |
| -doris.replicationFactor | int | 1 | Doris 테이블의 복제 인자입니다. |
| -doris.sampleIndexName | string | 없음 | sample 인덱스 이름입니다. |
| -doris.sampleInsertRatio | int | 없음 | sample 쓰기 비율입니다. |
| -doris.sampleInterval | value | 1s | sample 간격 시간입니다. s/m/h/d/w/y를 단위로 지원합니다. 기본값은 월 단위입니다. |
| -doris.sampleNamespace | string | 없음 | sample 네임스페이스입니다. |
| -doris.sampleTenantID | string | 없음 | sample 테넌트 ID입니다. |
| -doris.storageResource | string | s3_default | Doris에서 사용하는 스토리지 정책 리소스 이름입니다. |
| -doris.variantSchemaMode | string | 없음 | schema 모드입니다. 'none', 'minimal', 'full'을 지원합니다. |
| -dorisCluster | string | default_cluster | Doris 클러스터 이름입니다. |
| -dorisFENode | array | 없음 | Doris-FE 노드 주소(여러 개는 쉼표로 구분). |
| -dorisHTTPPort | int | 8030 | Doris의 HTTP 포트입니다. |
| -dorisMySQLPort | int | 9030 | Doris의 MySQL 포트입니다. |
| -dorisPassword | string | 없음 | Doris에 연결하기 위한 비밀번호입니다. |
| -dorisUsername | string | root | Doris에 연결하기 위한 사용자 이름입니다. |
| -dropSamplesOnOverload | 없음 | 없음 | vmstorage 노드가 과부하되거나 사용할 수 없을 때 클러스터 가용성을 보장하기 위해 샘플을 삭제할지 여부입니다. 이 작업은 복제 전에 수행되므로 주의해서 사용하십시오. |
| -enableTCP6 | 없음 | 없음 | IPv6 수신 및 다이얼을 활성화할지 여부입니다. 기본값은 IPv4만 활성화합니다. |
| -envflag.enable | 없음 | 없음 | 환경 변수에서 매개변수를 읽을 수 있도록 허용할지 여부입니다. 명령줄 매개변수가 우선적으로 적용됩니다. 자세한 내용은 다음을 참조하십시오: https://docs.victoriametrics.com/#environment-variables |
| -envflag.prefix | string | 없음 | 환경 변수의 접두사입니다(-envflag.enable과 함께 사용해야 함). |
| -fileQueue.maxFileSize | size | 104857600 | file queue에서 단일 파일의 최대 크기(기본값 100MB)입니다. |
| -fileQueue.maxTotalSize | size | 3758096384 | file queue의 총 크기 상한(기본값 3.5GB)입니다. |
| -fileQueue.workers | int | 8 | ScopeDB 또는 Doris에 동시에 삽입하는 최대 스레드 수입니다. |
| -filedb.maxFileSize | int | 10485760 | filedb의 최대 파일 크기(기본값 10MB)입니다. |
| -filestream.disableFadvise | 없음 | 없음 | fadvise() 시스템 호출을 비활성화할지 여부입니다. 대용량 파일을 읽을 때 최근 데이터가 OS 캐시에서 제거되는 것을 방지하는 데 사용됩니다. |
| -flagsAuthKey | value | 없음 | /flags 인터페이스의 인증 키입니다. 파일 또는 URL을 통해 읽을 수 있습니다. |
| -fs.disableMmap | 없음 | 없음 | mmap()을 비활성화하고 데이터 파일 읽기에 pread()를 사용할지 여부입니다. 64비트 시스템에서는 기본적으로 mmap()이 활성화되어 있습니다. |
| -gcolumnCompressLevel | int | 없음 | guance column 프로토콜의 압축 수준입니다. 값이 높을수록 압축률은 좋지만 CPU를 더 많이 사용합니다. 음수 값은 CPU 사용량을 줄일 수 있지만 네트워크 전송량이 증가합니다. |
| -http.connTimeout | duration | 2m0s | HTTP 연결 제한 시간입니다. 로드 밸런서가 트래픽을 더 균등하게 분산하는 데 사용할 수 있습니다. 0은 시간 초과 없음을 의미합니다. |
| -http.disableResponseCompression | 없음 | 없음 | CPU를 절약하기 위해 HTTP 응답 압축을 비활성화할지 여부입니다. 기본적으로 압축이 활성화되어 네트워크 대역폭을 절약합니다. |
| -http.header.csp | string | 없음 | Content-Security-Policy 헤더 값을 설정합니다. 권장값: "default-src 'self'". |
| -http.header.frameOptions | string | 없음 | X-Frame-Options 헤더 값을 설정합니다. |
| -http.header.hsts | string | 없음 | Strict-Transport-Security 헤더 값을 설정합니다. 권장값: "max-age=31536000; includeSubDomains". |
| -http.idleConnTimeout | duration | 1m0s | 유휴 HTTP 연결의 제한 시간입니다. |
| -http.maxGracefulShutdownDuration | duration | 7s | HTTP 서비스의 정상 종료 최대 대기 시간입니다. 부하가 높은 서버는 더 높은 값이 필요할 수 있습니다. |
| -http.pathPrefix | string | 없음 | 모든 HTTP 경로의 접두사입니다. 예를 들어 /foo/bar로 설정하면 모든 경로가 이 접두사로 시작하여 리버스 프록시에 유용합니다. |
| -http.shutdownDelay | duration | 없음 | HTTP 서비스 종료 전 지연 시간입니다. 이 기간 동안 /health 인터페이스는 OK가 아닌 상태를 반환하여 로드 밸런서에 트래픽 전환을 알립니다. |
| -httpAuth.password | value | 없음 | HTTP Basic Auth 비밀번호입니다. 사용자 이름이 비어 있으면 활성화되지 않습니다. 파일 또는 URL에서 로드를 지원합니다. |
| -httpAuth.username | string | 없음 | HTTP Basic Auth 사용자 이름입니다. 비어 있으면 인증이 비활성화됩니다. -httpAuth.password와 함께 사용해야 합니다. |
| -httpListenAddr | array | 없음 | HTTP 서비스 수신 주소입니다. 여러 주소를 지원합니다. |
| -httpListenAddr.useProxyProtocol | array | false | -httpListenAddr에서 수신한 연결에 프록시 프로토콜을 사용할지 여부입니다. 활성화하면 HTTP 서버가 /metrics 엔드포인트를 제공할 수 없습니다. 메트릭 푸시에는 -pushmetrics.url을 사용하십시오. 쉼표로 구분하거나 여러 번 설정을 지원합니다. 빈 값은 false입니다. |
| -influx.defaultBatchLinesCount | size | 16 | InfluxDB 구문 분석 시 각 배치의 기본 행 수입니다. KB, MB, GB, TB, KiB, MiB, GiB, TiB 단위 접미사를 지원합니다. |
| -influx.defaultBatchSize | size | 1048576 | InfluxDB 구문 분석 시 각 배치의 기본 바이트 크기입니다. KB, MB, GB, TB, KiB, MiB, GiB, TiB 단위 접미사를 지원합니다. |
| -insert.maxFutureTimeDrift | duration | 1h0m0s | 데이터 삽입 시 이벤트 타임스탬프가 현재 시간 + 이 값보다 크면 거부됩니다. |
| -insert.maxPastTimeDrift | duration | 데이터 삽입 시 이벤트 타임스탬프가 현재 시간 - 이 값보다 작으면 거부됩니다. | |
| -insertNode | array | guance-insert 노드의 주소를 지정합니다. 여러 개는 쉼표로 구분하며, 따옴표 또는 괄호로 묶인 값을 지원합니다. | |
| -internStringCacheExpireDuration | duration | 6m0s | interned 문자열 캐시의 만료 시간입니다. 자세한 내용은 다음을 참조하십시오: https://en.wikipedia.org/wiki/String_interning. |
| -internStringDisableCache | false | interned 문자열 캐시를 비활성화할지 여부입니다. 메모리 사용량을 줄일 수 있지만 CPU 사용률이 증가할 수 있습니다. | |
| -internStringMaxLen | int | 500 | interned 문자열의 최대 길이입니다. 작은 값을 설정하면 메모리 사용량이 줄어들 수 있지만 CPU 사용률이 증가할 수 있습니다. |
| -loggerDisableTimestamps | false | 로그에서 타임스탬프 기록을 비활성화할지 여부입니다. | |
| -loggerErrorsPerSecondLimit | int | 초당 출력할 수 있는 ERROR 로그 수입니다. 초과 시 추가 로그는 억제됩니다. 0으로 설정하면 제한이 없습니다. | |
| -loggerFormat | string | default | 로그 형식입니다. 옵션: default, json. |
| -loggerJSONFields | string | JSON 로그의 필드 이름을 변경합니다. 예: "ts:timestamp,msg:message". 지원되는 필드는 ts, level, caller, msg입니다. | |
| -loggerLevel | string | INFO | 로그 출력의 최소 수준입니다. 옵션: INFO, WARN, ERROR, FATAL, PANIC. |
| -loggerMaxArgLen | int | 1000 | 단일 로그 매개변수의 최대 길이입니다. 초과 시 앞뒤가 잘려 표시됩니다(예: 'arg_start..arg_end'). |
| -loggerOutput | string | stderr | 로그 출력 대상입니다. 지원: stderr, stdout. |
| -loggerTimezone | string | UTC | 로그의 타임스탬프에 사용되는 시간대입니다. IANA 표준 형식이어야 합니다(예: America/New_York, Etc/GMT+3 또는 Local). |
| -loggerWarnsPerSecondLimit | int | 초당 출력할 수 있는 WARN 로그 수입니다. 초과 시 추가 로그는 억제됩니다. 0으로 설정하면 제한이 없습니다. | |
| -maxConcurrentInserts | int | 24 | 허용되는 최대 동시 삽입 요청 수입니다. 기본값은 대부분의 경우에 적합합니다. 네트워크가 느린 경우 적절히 높일 수 있습니다. |
| -maxInsertRequestSize | size | 134217728 | 단일 gcolumn 삽입 요청의 최대 바이트 크기입니다. KB, MB, GB, TB, KiB, MiB, GiB, TiB 단위 접미사를 지원합니다. |
| -maxLabelValueLen | int | 16384 | 수신된 시계열의 레이블 값 최대 길이입니다. 초과 부분은 잘리며, /metrics 페이지의 vm_too_long_label_values_total 메트릭이 증가합니다. |
| -maxLabelsPerTimeseries | int | 256 | 각 시계열에 허용되는 최대 레이블 수입니다. 초과 레이블은 삭제되며, 해당 /metrics 페이지 메트릭 vm_metrics_with_dropped_labels_total이 증가합니다. |
| -memory.allowedBytes | size | 0 | VictoriaMetrics 캐시가 사용할 수 있는 시스템 메모리 상한(바이트)입니다. 이 값이 0이 아니면 -memory.allowedPercent를 재정의합니다. 너무 작게 설정하면 캐시 미스율이 증가하고, 너무 크게 설정하면 OS 페이지 캐시에 영향을 줄 수 있습니다. |
| -memory.allowedPercent | float | 60 | VictoriaMetrics 캐시가 사용할 수 있는 시스템 메모리 백분율입니다. 너무 작게 설정하면 CPU 및 디스크 IO가 증가하고, 너무 크게 설정하면 페이지 캐시에 영향을 줄 수 있습니다. |
| -metrics.exposeMetadata | false | /metrics 페이지에 TYPE 및 HELP 메타데이터를 노출할지 여부입니다. 일부 시스템(예: Google Cloud Managed Prometheus)에서는 이 정보가 필요합니다. | |
| -metricsAuthKey | value | /metrics 엔드포인트의 인증 키입니다. authKey 쿼리 매개변수를 통해 전달할 수 있습니다. 파일 또는 URL에서 키 읽기를 지원합니다. | |
| -pprofAuthKey | value | /debug/pprof/*의 인증 키입니다. authKey 쿼리 매개변수를 통해 전달할 수 있습니다. 파일 또는 URL에서 키 읽기를 지원합니다. | |
| -prevCacheRemovalPercent | float | 0.1 | 이전 캐시의 적중률이 이 값보다 낮으면 제거됩니다. 값이 높을수록 메모리 사용량은 줄어들지만 CPU 사용량이 증가할 수 있습니다. |
| -pushmetrics.disableCompression | false | 각 -pushmetrics.url로 메트릭을 푸시할 때 요청 본문 압축을 비활성화할지 여부입니다. | |
| -pushmetrics.extraLabel | array | 각 -pushmetrics.url로 푸시되는 추가 레이블입니다. 예: -pushmetrics.extraLabel='instance="foo"'. 쉼표, 따옴표 및 괄호를 지원합니다. |
|
| -pushmetrics.header | array | 각 -pushmetrics.url로 푸시 요청 시 전송되는 HTTP 헤더입니다. 예: Authorization: Basic foobar. 쉼표, 따옴표 및 괄호를 지원합니다. |
|
| -pushmetrics.interval | duration | 10s | 각 -pushmetrics.url로 메트릭을 푸시하는 간격입니다. |
| -pushmetrics.url | array | /metrics 페이지 데이터를 푸시할 대상 주소를 지정합니다. 기본적으로 푸시되지 않습니다. 여러 주소와 복잡한 구문을 지원합니다. | |
| -relabelConfig | string | 재작성 규칙 구성 파일 경로(로컬 또는 http 주소)를 지정합니다. SIGHUP 신호를 수신하면 자동으로 다시 로드됩니다. 자세한 내용은 다음을 참조하십시오: https://docs.victoriametrics.com/#relabeling | |
| -replicationFactor | int | 1 | 데이터의 복제본 수, 즉 각 데이터가 다른 -storageNode에 복사되는 횟수입니다. 이 값이 >1이면 vmselect는 중복 제거를 위해 -dedup.minScrapeInterval=1ms를 설정해야 합니다. |
| -retentionFilters.cleanInterval | duration | 360h0m0s | 만료된 데이터를 정리하는 간격입니다. |
| -retentionFilters.config | string | 보존 정책 구성 파일 경로입니다. | |
| -retentionFilters.configCheckInterval | duration | 1h0m0s | 보존 정책 구성 파일 업데이트를 확인하는 간격입니다. |
| -rpc.disableCompression | false | vminsert에서 vmstorage로 데이터를 보낼 때 압축을 비활성화할지 여부입니다. 비활성화하면 CPU 사용량은 줄어들지만 네트워크 대역폭 사용량이 증가합니다. | |
| -scopeDB.dbName | string | scopedb | ScopeDB 데이터베이스 이름입니다. |
| -scopeDB.dumpIngestBody | false | 삽입 실패 시 요청 본문 내용을 출력할지 여부입니다. | |
| -scopeDB.ensureJob | false | ensure job을 활성화할지 여부입니다. | |
| -scopeDB.indexCacheTTL | duration | 5m0s | ScopeDB 인덱스 캐시의 TTL입니다. |
| -scopeDB.maxConcurrentIndexRequests | int | 32 | ScopeDB에서 허용되는 최대 동시 인덱스 요청 수입니다. |
| -scopeDB.maxFieldCount | size | 512 | 각 인덱스의 최대 필드 수입니다. |
| -scopeDB.maxFieldSize | size | 33554432 | 단일 gcolumn 필드의 최대 바이트 수입니다. |
| -scopeDB.node | array | ScopeDB 노드의 주소 목록입니다. 여러 형식을 지원합니다. | |
| -scopeDB.nodegroup.ctl | string | ingest-meta | 제어 플레인에서 사용하는 ScopeDB 노드 그룹입니다. |
| -scopeDB.nodegroup.ingest | string | ingest | 데이터 쓰기에 사용되는 ScopeDB 노드 그룹입니다. |
| -scopeDB.nodesUpdateInterval | duration | 10s | ScopeDB 노드 정보 업데이트 간격입니다. |
| -scopeDB.onlyUseBootstrapNodes | bool | false | 부트스트랩 노드만 사용할지 여부입니다. |
| -scopeDB.password | string | ScopeDB의 액세스 비밀번호입니다. | |
| -scopeDB.port | uint | 6543 | ScopeDB의 액세스 포트입니다. |
| -scopeDB.username | string | ScopeDB의 사용자 이름입니다. | |
| -search.debugThrottler | bool | false | 스로틀러 디버깅입니다. |
| -search.denyPartialResponse | bool | false | 부분 응답을 거부할지 여부입니다(일관성 향상, 가용성 희생). |
| -search.dorisColdQueryCPULimit | int | 4 | 콜드 데이터 쿼리에 사용되는 Doris CPU 제한입니다. |
| -search.dorisDisableADBC | bool | false | ADBC를 비활성화할지 여부입니다(Thrift 우선 사용). |
| -search.dorisDisableSampling | bool | false | 샘플링을 비활성화할지 여부입니다. |
| -search.dorisEnableSmallColdGroup | bool | false | 소규모 콜드 쿼리를 위해 전용 작업 그룹을 활성화합니다. |
| -search.dorisMaxCursorRows | int | 50000000 | 커서 쿼리에서 최대 스캔 행 수입니다. |
| -search.dorisMaxLiteralArraySize | int | 1000 | 리터럴 값 배열의 최대 요소 수입니다. |
| -search.dorisMaxOrderingRows | int | 사용자 정의 정렬 쿼리에서 최대 스캔 행 수입니다. | |
| -search.dorisMaxRowsForOrder | int | 비시간 열 정렬의 최대 행 수입니다. | |
| -search.dorisThrottlerURL | string | 스로틀러의 API 주소입니다. | |
| -search.logQueryMemoryUsage | size | 524288000 | 지정된 크기보다 큰 메모리를 사용하는 쿼리를 기록합니다. |
| -search.maxExportDuration | duration | 720h0m0s | /api/v1/export 요청의 최대 지속 시간입니다. |
| -search.maxGroups | int | 100000 | 쿼리 결과에서 허용되는 최대 그룹 수입니다. |
| -search.maxLabelsAPIDuration | duration | 5s | /api/v1/labels, /api/v1/label/.../values 및 /api/v1/series 요청의 최대 지속 시간입니다. |
| -search.maxLimit | int | 10000 | 쿼리 결과에서 허용되는 최대 행 수입니다. |
| -search.maxMemoryPerQuery | size | 0 | 단일 쿼리에 허용되는 최대 메모리입니다. 초과하면 쿼리가 거부됩니다. |
| -search.maxQueryDuration | duration | 30s | 쿼리 실행의 최대 지속 시간입니다. |
| -search.maxStatusRequestDuration | duration | 5m0s | /api/v1/status/* 요청의 최대 지속 시간입니다. |
| -search.minTimeRangeForLargeQuery | duration | 12h0m0s | 대규모 쿼리 스캔의 최소 시간입니다. |
| -search.scopeDB.firstCursorScanRows | int | 10000000 | 커서 페이지네이션 쿼리에서 스캔되는 행 수입니다. |
| -search.scopeDB.logQuery | bool | true | ScopeDB 쿼리 문을 기록할지 여부입니다. |
| -search.scopeDB.maxLiteralArraySize | int | 1000 | 리터럴 값 배열의 최대 요소 수입니다. |
| -search.scopeDB.maxRowsForOrder | int | 100000 | 비시간 열 정렬의 최대 행 수입니다. |
| -search.scopeDB.maxTimeRange | duration | 쿼리의 최대 시간 범위입니다. | |
| -sortLabels | bool | false | 스토리지에 쓰기 전에 레이블을 정렬할지 여부입니다. 메모리 사용량을 줄일 수 있지만 쓰기 성능이 저하될 수 있습니다. |
| -storageNode | array | guance-storage 노드 주소 목록입니다. 여러 형식을 지원합니다. | |
| -streamaggr.cleanupInterval | duration | 10m0s | 만료된 쿼리 정리 간격입니다. |
| -streamaggr.dataBlocksCacheSize | int | 157286400 | 데이터 블록 캐시 크기(바이트)입니다. |
| -streamaggr.ignoreContinuousCheck | bool | false | 연속성 검사를 무시할지 여부입니다. |
| -streamaggr.indexBlocksCacheSize | int | 52428800 | 인덱스 블록 캐시 크기(바이트)입니다. |
| -streamaggr.insertVerify | bool | false | streamaggr 확인 모드를 활성화합니다. |
| -streamaggr.queryRetentionPeriod | duration | 168h0m0s | 쿼리 보존 기간입니다. |
| -streamaggr.replay | bool | false | streamaggr 재생 모드를 활성화합니다. |
| -streamaggr.retentionMonths | int | 6 | 스트림 집계 데이터 보존 월 수입니다. |
| -streamaggrDataPath | string | 데이터 저장 경로입니다. | |
| -tls | array | 지정된 httpListenAddr에 대해 TLS를 활성화할지 여부입니다. -tlsCertFile 및 -tlsKeyFile을 설정해야 합니다. | |
| -tlsCertFile | array | TLS 인증서 파일 경로입니다. 동적 업데이트를 지원합니다. | |
| -tlsCipherSuites | array | 선택적 TLS 암호 제품군 목록입니다. | |
| -tlsKeyFile | array | TLS 키 파일 경로입니다. 동적 업데이트를 지원합니다. | |
| -tlsMinVersion | array | TLS의 최소 버전(TLS10, TLS11, TLS12, TLS13)입니다. | |
| -usePromCompatibleNaming | bool | false | 지원되지 않는 Prometheus 문자를 밑줄로 바꿀지 여부입니다. |
| -version | bool | false | VictoriaMetrics 버전 정보를 표시합니다. |
| -vmstorageDialTimeout | duration | 3s | vminsert에서 vmstorage로의 RPC 연결 제한 시간입니다. |
| -vmstorageUserTimeout | duration | 3s | vminsert에서 vmstorage로의 네트워크 제한 시간(Linux 전용)입니다. |
| -zipkin.batchSize | int | 100 | 단일 배치로 전송되는 최대 span 수입니다. |
| -zipkin.bufferSize | int | 10000 | 버퍼링되는 최대 span 수입니다. |
| -zipkin.endpoint | string | Zipkin 수집기 엔드포인트 URL입니다. | |
| -zipkin.flushPeriod | duration | 1s | 최대 플러시 간격입니다. |
| -zipkin.serviceName | string | guance-insert | Zipkin Span에서 사용되는 서비스 이름입니다. |
Guance Storage 매개변수 설명¶
| 매개변수명 | 유형 | 기본값 | 설명 |
|---|---|---|---|
| -bigMergeConcurrency | int | 없음 | 더 이상 사용되지 않음: 이 매개변수는 더 이상 작동하지 않습니다. |
| -blockcache.missesBeforeCaching | int | 2 | 블록을 캐시에 넣기 전 캐시 미스 횟수입니다. 값이 클수록 indexdb/dataBlocks 캐시 크기를 줄일 수 있지만 CPU 및 디스크 읽기 작업이 증가합니다. |
| -cacheExpireDuration | duration | 30m0s | 메모리 캐시에서 액세스되지 않은 항목이 이 시간 후에 제거됩니다. 값이 낮을수록 메모리 사용량이 줄어들 수 있지만 CPU 사용량이 증가합니다. -prevCacheRemovalPercent를 참조하십시오. |
| -dedup.minScrapeInterval | duration | 없음 | 각 시계열의 지정된 이산 간격 내에서 마지막 샘플만 유지합니다. 0보다 큰 값으로 설정해야 합니다. 중복 제거 문서를 참조하십시오. |
| -denyQueriesOutsideRetention | bool | false | 구성된 -retentionPeriod 범위를 벗어난 데이터 쿼리를 거부할지 여부입니다. 활성화하면 /api/v1/query_range는 기간 초과 쿼리에 대해 503 오류를 반환합니다. |
| -denyQueryTracing | bool | false | 쿼리 추적 기능을 비활성화할지 여부입니다. 쿼리 추적 문서를 참조하십시오. |
| -enableTCP6 | bool | false | IPv6 수신 및 다이얼을 활성화할지 여부입니다. 기본값은 IPv4만 활성화합니다. |
| -envflag.enable | bool | false | 환경 변수에서 매개변수 읽기를 활성화할지 여부입니다. 명령줄 매개변수가 우선합니다. 비활성화하면 명령줄에서만 읽습니다. 환경 변수 문서를 참조하십시오. |
| -envflag.prefix | string | 없음 | -envflag.enable이 활성화된 경우 환경 변수 접두사입니다. |
| -filestream.disableFadvise | bool | false | 대용량 파일 읽기 시 fadvise() 시스템 호출을 비활성화할지 여부입니다. 이 호출은 최근에 액세스한 데이터가 시스템 캐시에서 제거되는 것을 방지합니다. 경우에 따라 비활성화하면 CPU 사용량을 줄일 수 있습니다. |
| -finalMergeDelay | duration | 없음 | 더 이상 사용되지 않음: 이 매개변수는 더 이상 작동하지 않습니다. |
| -flagsAuthKey | value | 없음 | /flags 엔드포인트의 인증 키입니다. authKey 쿼리 매개변수를 통해 전달해야 합니다. 파일 또는 HTTP(S) URL에서 키 값 읽기를 지원합니다. |
| -forceFlushAuthKey | value | 없음 | /internal/force_flush 페이지에 필요한 인증 키입니다. 파일 또는 HTTP(S) URL에서 읽기를 지원합니다. |
| -forceMergeAuthKey | value | 없음 | /internal/force_merge 페이지에 필요한 인증 키입니다. 파일 또는 HTTP(S) URL에서 읽기를 지원합니다. |
| -fs.disableMmap | bool | false | 데이터 파일 읽기에 mmap() 대신 pread()를 사용할지 여부입니다. 64비트 아키텍처는 기본적으로 mmap()을 사용하고, 32비트 아키텍처는 기본적으로 pread()를 사용합니다. mmap()은 작은 데이터 블록을 더 빠르게 읽습니다. |
| -http.connTimeout | duration | 2m0s | -httpListenAddr에 대한 연결 제한 시간입니다. 로드 밸런서가 요청을 균등하게 분산하는 데 도움이 될 수 있습니다. 0 값은 시간 초과를 비활성화합니다. |
| -http.disableResponseCompression | bool | false | HTTP 응답 압축을 비활성화할지 여부입니다. 기본적으로 압축이 활성화되어 네트워크 대역폭을 절약합니다. 비활성화하면 CPU를 절약할 수 있습니다. |
| -http.header.csp | string | "default-src 'self'" | HTTP 헤더 Content-Security-Policy를 설정합니다. 권장값은 "default-src 'self'"입니다. |
| -http.header.frameOptions | string | 없음 | HTTP 헤더 X-Frame-Options를 설정합니다. |
| -http.header.hsts | string | "max-age=31536000; includeSubDomains" | HTTP 헤더 Strict-Transport-Security를 설정합니다. 예시와 같은 권장값입니다. |
| -http.idleConnTimeout | duration | 1m0s | HTTP 유휴 연결 제한 시간입니다. |
| -http.maxGracefulShutdownDuration | duration | 7s | HTTP 서버의 정상 종료 최대 대기 시간입니다. 부하가 높은 서버는 이 값을 늘리는 것이 좋습니다. |
| -http.pathPrefix | string | 없음 | 모든 HTTP 경로에 접두사를 추가합니다. 예를 들어 프록시를 통해 액세스할 때 경로 접두사에 사용됩니다. 관련 문서를 참조하십시오. |
| -http.shutdownDelay | duration | 없음 | HTTP 서버 종료 전 지연 시간입니다. 이 기간 동안 /health는 OK가 아닌 상태를 반환하여 로드 밸런서가 요청을 전환할 수 있도록 합니다. |
| -httpAuth.password | value | 없음 | HTTP 기본 인증 비밀번호입니다. 사용자 이름이 설정되지 않으면 인증이 비활성화됩니다. 파일 또는 HTTP(S) URL에서 읽기를 지원합니다. |
| -httpAuth.username | string | 없음 | HTTP 기본 인증 사용자 이름입니다. 설정되지 않으면 인증이 비활성화됩니다. |
| -httpListenAddr | array | 없음 | HTTP 수신 주소입니다. 쉼표 또는 여러 번의 매개변수로 전달할 수 있으며 복잡한 형식을 지원합니다. |
| -httpListenAddr.useProxyProtocol | array | false | 지정된 수신 주소에 대해 프록시 프로토콜을 활성화할지 여부입니다. 활성화하면 일반 /metrics 엔드포인트를 사용할 수 없습니다. HAProxy 문서를 참조하십시오. |
| -inmemoryDataFlushInterval | duration | 5s | 메모리 데이터를 디스크에 유지하는 간격입니다. 비정상 종료를 방지하기 위해 데이터를 저장합니다. 간격이 클수록 플래시 메모리 수명이 길어지고, 작을수록 디스크 IO 부하가 높아집니다. 최소 1초입니다. |
| -insert.maxQueueDuration | duration | 1m0s | 최대 동시 삽입에 도달했을 때 삽입 요청이 대기열에서 대기하는 최대 시간입니다. |
| -internStringCacheExpireDuration | duration | 6m0s | 문자열 인턴 캐시 만료 시간입니다. 문자열 인턴 메커니즘을 참조하십시오. |
| -internStringDisableCache | bool | false | 문자열 인턴 캐시를 비활성화할지 여부입니다. 비활성화하면 메모리는 줄어들지만 CPU 사용량이 증가합니다. |
| -internStringMaxLen | int | 500 | 문자열 인턴의 최대 길이입니다. 값이 낮을수록 메모리를 절약할 수 있지만 CPU 사용량이 증가합니다. |
| -logNewSeries | bool | false | 새 시계열 로그를 기록할지 여부입니다. 디버깅 전용이며 성능에 영향을 줄 수 있습니다. |
| -loggerDisableTimestamps | bool | 없음 | 로그에서 타임스탬프 쓰기를 비활성화할지 여부입니다. |
| -loggerErrorsPerSecondLimit | int | 0 | 초당 허용되는 최대 ERROR 로그 수입니다. 이 값을 초과하는 오류 로그는 억제됩니다. 0은 제한 없음을 의미합니다. |
| -loggerFormat | string | "default" | 로그 형식입니다. 옵션: default, json(기본값 "default"). |
| -loggerJSONFields | string | 없음 | JSON 형식 로그의 필드 이름을 바꿉니다. 예: "ts:timestamp,msg:message"는 "ts"를 "timestamp"로, "msg"를 "message"로 바꿉니다. 지원되는 필드: ts, level, caller, msg. |
| -loggerLevel | string | "INFO" | 최소 로그 수준입니다. 옵션: INFO, WARN, ERROR, FATAL, PANIC(기본값 "INFO"). |
| -loggerMaxArgLen | int | 1000 | 단일 로그 매개변수의 최대 길이입니다. 이 길이를 초과하는 매개변수는 잘려서 'arg_start..arg_end'로 표시되며, 앞뒤 부분의 길이는 -loggerMaxArgLen / 2를 초과하지 않습니다. |
| -loggerOutput | string | "stderr" | 로그 출력 위치입니다. 지원 값: stderr, stdout(기본값 "stderr"). |
| -loggerTimezone | string | "UTC" | 로그 타임스탬프에 사용되는 시간대입니다. 시간대는 유효한 IANA 시간대 이름이어야 합니다(예: America/New_York, Europe/Berlin, Etc/GMT+3 또는 Local). 기본값은 "UTC"입니다. |
| -loggerWarnsPerSecondLimit | int | 0 | 초당 허용되는 최대 WARN 로그 수입니다. 이 값을 초과하는 경고 로그는 억제됩니다. 0은 제한 없음을 의미합니다. |
| -maxConcurrentInserts | int | 4 | 최대 동시 삽입 요청 수입니다. 클라이언트 네트워크가 느린 경우 늘릴 수 있습니다. 기본값은 CPU 코어 수에 따라 설정되며 일반적으로 적합합니다. -insert.maxQueueDuration을 참조하십시오. |
| -memory.allowedBytes | size | 0 | VictoriaMetrics 캐시가 사용할 수 있는 시스템 메모리 크기(바이트)입니다. 0이 아닌 값으로 설정하면 -memory.allowedPercent를 재정의합니다. 값이 너무 낮으면 캐시 미스율이 증가하여 CPU 및 디스크 IO가 높아집니다. KB, MB, GB 등의 단위 접미사를 지원합니다. |
| -memory.allowedPercent | float | 60 | VictoriaMetrics 캐시가 사용할 수 있는 시스템 메모리 백분율입니다. -memory.allowedBytes를 참조하십시오. 너무 낮으면 캐시 미스율이 증가하고, 너무 높으면 디스크 IO가 더 많이 발생할 수 있습니다. |
| -metrics.exposeMetadata | bool | 없음 | /metrics 페이지에 TYPE 및 HELP 메타데이터를 노출할지 여부입니다. 일부 시스템(예: Google Cloud Managed Prometheus)에서는 이 정보가 필요합니다. |
| -metricsAuthKey | string | 없음 | /metrics 인터페이스의 인증 키입니다. authKey 쿼리 매개변수를 통해 전달되며 httpAuth.* 설정보다 우선합니다. 파일 또는 HTTP/HTTPS URL에서 읽을 수 있습니다. |
| -pprofAuthKey | string | 없음 | /debug/pprof/* 인터페이스의 인증 키입니다. authKey 쿼리 매개변수를 통해 전달되며 httpAuth.* 설정보다 우선합니다. 파일 또는 HTTP/HTTPS URL에서 읽을 수 있습니다. |
| -precisionBits | int | 64 | 각 값 저장의 정밀도 비트 수입니다. 비트 수가 낮을수록 압축률은 높아지지만 정밀도 손실이 커집니다. (기본값 64) |
| -prevCacheRemovalPercent | float | 0.1 | 현재 캐시 서비스 요청 비율이 이 값보다 낮으면 이전 캐시의 항목이 제거됩니다. 이 값을 높이면 메모리 사용량은 줄어들지만 CPU 사용량이 증가합니다. -cacheExpireDuration을 참조하십시오. |
| -pushmetrics.disableCompression | bool | 없음 | 모든 -pushmetrics.url로 푸시할 때 요청 본문 압축을 비활성화할지 여부입니다. |
| -pushmetrics.extraLabel | array | 없음 | 모든 -pushmetrics.url로 푸시되는 메트릭에 추가 레이블을 추가합니다. 예: -pushmetrics.extraLabel='instance="foo"'. 배열 및 여러 번 설정을 지원합니다. |
| -pushmetrics.header | array | 없음 | 모든 -pushmetrics.url로 전송되는 HTTP 요청 헤더입니다. 예: -pushmetrics.header='Authorization: Basic foobar'. 배열 및 여러 번 설정을 지원합니다. |
| -pushmetrics.interval | duration | 10s | 모든 -pushmetrics.url로 메트릭을 푸시하는 간격입니다. |
| -pushmetrics.url | array | 없음 | 메트릭을 푸시할 원격 URL 목록입니다. 기본적으로 푸시되지 않습니다. |
| -retentionFilters.cleanInterval | duration | 360h | 만료된 데이터 정리 간격입니다. |
| -retentionFilters.config | string | "" | 보존 필터 구성 파일 경로입니다. |
| -retentionFilters.configCheckInterval | duration | 1h | 보존 필터 구성 파일 변경 확인 간격입니다. |
| -retentionPeriod | value | 1 | 데이터 보존 기간입니다. 이 기간이 지난 데이터는 자동으로 삭제됩니다. 단위 s, m, h, d, w, y를 지원합니다. |
| -retentionTimezoneOffset | duration | 0 | indexdb 순환 실행의 시간대 오프셋입니다. 0은 UTC 4시를 의미합니다. |
| -rpc.disableCompression | bool | false | vmstorage에서 vmselect로의 데이터 압축을 비활성화할지 여부입니다. 비활성화하면 CPU는 줄어들지만 네트워크 대역폭이 증가합니다. |
| -search.maxConcurrentRequests | int | 4 | vmstorage가 처리할 수 있는 최대 vmselect 동시 요청 수입니다. |
| -search.maxQueueDuration | duration | 10s | 요청 대기열의 최대 대기 시간입니다. |
| -search.maxTagKeys | int | 100000 | 단일 검색에서 반환되는 최대 태그 키 수입니다. |
| -search.maxTagValues | int | 100000 | 단일 검색에서 반환되는 최대 태그 값 수입니다. |
| -search.maxUniqueTimeseries | int | 0 | 쿼리 시 스캔할 수 있는 최대 고유 시계열 수입니다. 0은 제한 없음을 의미합니다. |
| -smallMergeConcurrency | int | (사용 중단) | 더 이상 사용되지 않으며 현재 작동하지 않습니다. |
| -snapshotAuthKey | string | "" | /snapshot* 페이지 액세스 인증 키입니다. 파일 또는 URL 읽기를 지원합니다. |
| -snapshotCreateTimeout | duration | (사용 중단) | 더 이상 사용되지 않으며 작동하지 않습니다. |
| -snapshotsMaxAge | value | 0 | 이 시간이 지난 스냅샷을 자동으로 삭제합니다. 단위 s, m, h, d, w, y를 지원합니다. |
| -storage.cacheSizeIndexDBDataBlocks | size | 0 | indexdb/dataBlocks 캐시 최대 크기입니다. |
| -storage.cacheSizeIndexDBIndexBlocks | size | 0 | indexdb/indexBlocks 캐시 최대 크기입니다. |
| -storage.cacheSizeIndexDBTagFilters | size | 0 | indexdb/tagFiltersToMetricIDs 캐시 최대 크기입니다. |
| -storage.cacheSizeStorageTSID | size | 0 | storage/tsid 캐시 최대 크기입니다. |
| -storage.maxDailySeries | int | 0 | 24시간 내에 추가할 수 있는 최대 고유 시퀀스 수입니다. 초과 시퀀스는 삭제되고 로그에 기록됩니다. |
| -storage.maxHourlySeries | int | 0 | 1시간 내에 추가할 수 있는 최대 고유 시퀀스 수입니다. 초과 시퀀스는 삭제되고 로그에 기록됩니다. |
| -storage.maxSeriesPerSecond | int | 2000 | 초당 최대 생성 가능한 시퀀스 수입니다. 제한을 초과하면 삭제되고 로그에 기록됩니다. |
| -storage.minFreeDiskSpaceBytes | size | 10000000 | 스토리지 경로의 최소 남은 디스크 공간입니다. 이 값보다 낮으면 스토리지가 데이터 수신을 중단합니다. |
| -storage.vminsertConnsShutdownDuration | duration | 25s | vminsert 연결을 정상 종료하는 데 필요한 시간입니다. 종료 속도를 제어하여 부하 변동을 줄입니다. |
| -storageDataPath | string | "vmstorage-data" | 스토리지 데이터 경로입니다. |
| -tls | array | [] | 지정된 HTTP 수신 주소에 대해 TLS를 활성화할지 여부입니다. 인증서 및 키 파일을 동시에 설정해야 합니다. |
| -tlsCertFile | array | [] | TLS 인증서 파일 경로입니다. 동적 업데이트를 지원합니다. |
| -tlsCipherSuites | array | [] | TLS 암호 제품군 목록입니다. |
| -tlsKeyFile | array | [] | TLS 키 파일 경로입니다. 동적 업데이트를 지원합니다. |
| -tlsMinVersion | array | [] | TLS 최소 버전 요구 사항입니다. TLS10, TLS11, TLS12, TLS13을 지원합니다. |
| -version | bool | false | VictoriaMetrics 버전을 표시합니다. |
| -vminsertAddr | string | ":8400" | vminsert 서비스 수신 주소입니다. |
| -vmselectAddr | string | ":8401" | vmselect 서비스 수신 주소입니다. |
