wbsong111
9676fec2f3
otelcol 헤더 수정(aef6439)에 맞춰 아키텍처 문서·vlogs/otelcol CUSTOM-README·
vlogs custom-values 주석의 VictoriaLogs-AccountID 참조를 AccountID/ProjectID 로 정정.
VictoriaLogs-* 접두 헤더 무시(전량 acct0) 경고 추가.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.5 KiB
1.5 KiB
VictoriaLogs Cluster 배포
AccountID 기반 스토리지 격리를 지원하는 로그 스토리지. vlinsert(쓰기)·vlstorage(저장)·vlselect(조회)로 구성된다.
1. 배포 방법
helm upgrade vlogs ./ -f custom-values.yaml --install -n monitoring
배포 시 주의:
- 클러스터 모드를 사용한다. 단일 노드(victoria-logs-single)는 AccountID 헤더를 수신하지만 스토리지를 분리하지 않는다. 클러스터는 URL/헤더의 AccountID로 실제 격리 저장한다.
vlstorage는 PVC를 사용한다(기본 5Gi).
2. custom-values.yaml 설정 설명
| 컴포넌트 | 포트 | 역할 |
|---|---|---|
| vlinsert | 9481 | 로그 쓰기 — /insert/{AccountID}/opentelemetry/v1/logs |
| vlstorage | 9491 | AccountID별 격리 저장 (보존기간 retentionPeriod: 7d) |
| vlselect | 9471 | LogsQL 쿼리 — /select/{AccountID}/logsql/query |
vlstorage.extraArgs."memory.allowedPercent": "60"으로 메모리 사용 상한을 제한한다.
3. 의존 관계
- 쓰기: opentelemetry-collector → vlinsert:9481 (
AccountID/ProjectID헤더로 테넌트 지정.VictoriaLogs-*접두 헤더는 무시됨) - 조회: vmauth → vlselect:9471 (Perses victorialogs 데이터소스가 vmauth 경유)
4. 검증
kubectl get pods -n monitoring -l app.kubernetes.io/instance=vlogs
kubectl port-forward -n monitoring svc/vlogs-victoria-logs-cluster-vlselect 9471:9471
curl -s 'http://localhost:9471/select/0/logsql/query?query=*&limit=1'