diff --git a/doc/victoria-metrics-architecture.md b/doc/victoria-metrics-architecture.md index e633f2a..08c1630 100644 --- a/doc/victoria-metrics-architecture.md +++ b/doc/victoria-metrics-architecture.md @@ -99,7 +99,7 @@ flowchart LR flowchart LR PODLOG[파드 로그] --> OTC[otelcol DaemonSet] EVENTS[K8s 이벤트] --> OTE[otelcol-events] - OTC -->|"VictoriaLogs-AccountID 헤더"| VLI[vlinsert :9481] + OTC -->|"AccountID/ProjectID 헤더"| VLI[vlinsert :9481] OTE -->|"AccountID 0"| VLI VLI --> VLS[(vlstorage :9491)] PERSES[Perses] -->|"SA 토큰"| VAUTH[vmauth :8427] @@ -107,7 +107,7 @@ flowchart LR VLSEL --> VLS ``` -- **쓰기**: otelcol이 namespace 기준으로 필터해 `VictoriaLogs-AccountID` 헤더(0/1/2)로 테넌트별 기록. +- **쓰기**: otelcol이 namespace 기준으로 필터해 `AccountID`/`ProjectID` 헤더(0/1/2)로 테넌트별 기록. (⚠️ VictoriaLogs 인식 헤더는 `AccountID`/`ProjectID`이며 `VictoriaLogs-*` 접두 헤더는 무시되어 전량 account 0으로 적재됨 — dev 검증에서 확인) - **조회**: vmauth가 `AccountID` 헤더를 주입해 vlselect로 전달. ## 5. 멀티테넌시 diff --git a/manifests/helm/opentelemetry-collector/0.156.2/CUSTOM-README.md b/manifests/helm/opentelemetry-collector/0.156.2/CUSTOM-README.md index 94332e5..21352ec 100644 --- a/manifests/helm/opentelemetry-collector/0.156.2/CUSTOM-README.md +++ b/manifests/helm/opentelemetry-collector/0.156.2/CUSTOM-README.md @@ -28,7 +28,7 @@ helm upgrade otelcol-events open-telemetry/opentelemetry-collector \ | logs/demo02 | filelog → filter(namespace=demo02-*) | vlinsert AccountID 2 | | logs/platform | filelog → filter(나머지) | vlinsert AccountID 0 | -- **로그 테넌시**: `VictoriaLogs-AccountID` 헤더로 vlinsert에 격리 전송. namespace는 filelog regex가 log record attribute에 추출하므로 OTTL `attributes["namespace"]`로 필터한다. +- **로그 테넌시**: `AccountID`/`ProjectID` 헤더로 vlinsert에 격리 전송. namespace는 filelog regex가 log record attribute에 추출하므로 OTTL `attributes["namespace"]`로 필터한다. ⚠️ VictoriaLogs가 인식하는 테넌트 헤더는 `AccountID`/`ProjectID`이며, `VictoriaLogs-AccountID` 같은 접두 헤더는 무시되어 **전량 account 0**으로 적재된다(dev 검증에서 확인). - **호스트 로그 마운트**: `/var/log/pods`, `/var/lib/docker/containers` (readOnly). - **RBAC**: k8sattributes 프로세서용 pods/namespaces/nodes/replicasets 권한. diff --git a/manifests/helm/victoria-logs-cluster/0.1.5/CUSTOM-README.md b/manifests/helm/victoria-logs-cluster/0.1.5/CUSTOM-README.md index 8382695..667eb03 100644 --- a/manifests/helm/victoria-logs-cluster/0.1.5/CUSTOM-README.md +++ b/manifests/helm/victoria-logs-cluster/0.1.5/CUSTOM-README.md @@ -24,7 +24,7 @@ helm upgrade vlogs ./ -f custom-values.yaml --install -n monitoring ## 3. 의존 관계 -- **쓰기**: opentelemetry-collector → vlinsert:9481 (`VictoriaLogs-AccountID` 헤더로 테넌트 지정) +- **쓰기**: opentelemetry-collector → vlinsert:9481 (`AccountID`/`ProjectID` 헤더로 테넌트 지정. `VictoriaLogs-*` 접두 헤더는 무시됨) - **조회**: vmauth → vlselect:9471 (Perses victorialogs 데이터소스가 vmauth 경유) ## 4. 검증 diff --git a/manifests/helm/victoria-logs-cluster/0.1.5/custom-values.yaml b/manifests/helm/victoria-logs-cluster/0.1.5/custom-values.yaml index 1cf53d9..fd819f1 100644 --- a/manifests/helm/victoria-logs-cluster/0.1.5/custom-values.yaml +++ b/manifests/helm/victoria-logs-cluster/0.1.5/custom-values.yaml @@ -4,7 +4,7 @@ # 멀티테넌시: AccountID 기반 스토리지 격리 (단일 노드와 달리 실제 격리) # - 쓰기: vlinsert:9481 /insert/{AccountID}/opentelemetry/v1/logs # - 조회: vlselect:9471 /select/{AccountID}/logsql/query -# 로그 수집은 opentelemetry-collector가 VictoriaLogs-AccountID 헤더로 전송한다. +# 로그 수집은 opentelemetry-collector가 AccountID/ProjectID 헤더로 전송한다(VictoriaLogs-* 접두 헤더는 무시됨). # ============================================================================= vlinsert: