Skip to content

The only tool you need to know what is happening and how to fix it.

#419

narrow-adventure991fb337b528
diff --git a/helm/traceway/templates/NOTES.txt b/helm/traceway/templates/NOTES.txt
index 1afb7188..0876e200 100644
--- a/helm/traceway/templates/NOTES.txt
+++ b/helm/traceway/templates/NOTES.txt
@@ -25,9 +25,9 @@ Get the application URL:
Check pod status:
kubectl get pods --namespace {{ .Release.Namespace }} -l "{{ include "traceway.selectorLabels" . }}"
-{{- if eq .Values.variant "sqlite" }}
+{{- if include "traceway.embeddedDB" . }}
-NOTE: SQLite variant — set replicaCount: 1 (SQLite does not support concurrent writes).
+NOTE: {{ if eq .Values.variant "duckdb" }}DuckDB{{ else }}SQLite{{ end }} variant — set replicaCount: 1 (its databases are local files).
Enable persistence to retain data across pod restarts:
persistence:
enabled: true
diff --git a/helm/traceway/templates/_helpers.tpl b/helm/traceway/templates/_helpers.tpl
index 941043b7..6245f222 100644
--- a/helm/traceway/templates/_helpers.tpl
+++ b/helm/traceway/templates/_helpers.tpl
@@ -41,19 +41,25 @@ app.kubernetes.io/instance: {{ .Release.Name }}
{{- end }}
{{- end }}
-{{/* Resolves the image tag based on the variant when not explicitly set */}}
+{{/* Release images are tagged v<version>[-<variant>]; the full variant has no suffix */}}
{{- define "traceway.imageTag" -}}
{{- if .Values.image.tag -}}
{{ .Values.image.tag }}
-{{- else if eq .Values.variant "sqlite" -}}
-{{ .Chart.AppVersion }}-sqlite
-{{- else if eq .Values.variant "minimal" -}}
-{{ .Chart.AppVersion }}-minimal
{{- else -}}
-{{ .Chart.AppVersion }}
+{{- $version := printf "v%s" (trimPrefix "v" .Chart.AppVersion) -}}
+{{- if eq .Values.variant "full" -}}
+{{ $version }}
+{{- else -}}
+{{ $version }}-{{ .Values.variant }}
+{{- end -}}
{{- end -}}
{{- end }}
+{{/* Variants that keep their databases as local files under /data */}}
+{{- define "traceway.embeddedDB" -}}
+{{- if has .Values.variant (list "sqlite" "duckdb") -}}true{{- end -}}
+{{- end }}
+
{{/* Name of the Secret to mount — either an existing one or the one we create */}}
{{- define "traceway.secretName" -}}
{{- if .Values.existingSecret -}}
diff --git a/helm/traceway/templates/configmap.yaml b/helm/traceway/templates/configmap.yaml
index 4cd5f83e..cdf5ca5d 100644
--- a/helm/traceway/templates/configmap.yaml
+++ b/helm/traceway/templates/configmap.yaml
@@ -1,3 +1,6 @@
+{{- if not (has .Values.variant (list "minimal" "sqlite" "duckdb" "full")) }}
+{{- fail (printf "variant must be one of minimal, sqlite, duckdb or full, got %q" .Values.variant) }}
+{{- end }}
{{- if and .Values.ingress.enabled (not .Values.app.trustedProxies) (not .Values.app.trustedProxyHeader) }}
{{- fail "set app.trustedProxies or app.trustedProxyHeader when ingress.enabled=true so clients do not share the ingress controller's rate-limit bucket" }}
{{- end }}
@@ -19,6 +22,21 @@ data:
{{- end }}
{{- end }}
+ {{- if eq .Values.variant "duckdb" }}
+ DB_TYPE: "sqlite"
+ SQLITE_PATH: {{ .Values.duckdb.path | quote }}
+ DUCKDB_RETENTION_DAYS: {{ .Values.duckdb.retentionDays | quote }}
+ {{- if .Values.duckdb.memoryLimit }}
+ DUCKDB_MEMORY_LIMIT: {{ .Values.duckdb.memoryLimit | quote }}
+ {{- end }}
+ {{- if .Values.duckdb.threads }}
+ DUCKDB_THREADS: {{ .Values.duckdb.threads | quote }}
+ {{- end }}
+ {{- if .Values.duckdb.checkpointThreshold }}
+ DUCKDB_CHECKPOINT_THRESHOLD: {{ .Values.duckdb.checkpointThreshold | quote }}
+ {{- end }}
+ {{- end }}
+
{{- if eq .Values.variant "minimal" }}
CLICKHOUSE_SERVER: {{ required "clickhouse.server is required when variant=minimal" .Values.clickhouse.server | quote }}
CLICKHOUSE_DATABASE: {{ .Values.clickhouse.database | quote }}
diff --git a/helm/traceway/templates/deployment.yaml b/helm/traceway/templates/deployment.yaml
index fc83c282..4a9b15f5 100644
--- a/helm/traceway/templates/deployment.yaml
+++ b/helm/traceway/templates/deployment.yaml
@@ -78,12 +78,12 @@ spec:
resources:
{{- toYaml . | nindent 12 }}
{{- end }}
- {{- if or .Values.persistence.enabled (eq .Values.variant "sqlite") }}
+ {{- if or .Values.persistence.enabled (include "traceway.embeddedDB" .) }}
volumeMounts:
- name: data
mountPath: /data
{{- end }}
- {{- if or .Values.persistence.enabled (eq .Values.variant "sqlite") }}
+ {{- if or .Values.persistence.enabled (include "traceway.embeddedDB" .) }}
volumes:
- name: data
{{- if .Values.persistence.enabled }}
diff --git a/helm/traceway/values.yaml b/helm/traceway/values.yaml
index 1efe403d..4d57d835 100644
--- a/helm/traceway/values.yaml
+++ b/helm/traceway/values.yaml
@@ -1,10 +1,10 @@
-# More than one replica needs variant=minimal with shared databases; the sqlite variant keeps its databases as local files.
+# More than one replica needs variant=minimal with shared databases; the sqlite and duckdb variants keep their databases as local files.
replicaCount: 1
image:
repository: ghcr.io/tracewayapp/traceway
pullPolicy: IfNotPresent
- # Overrides the image tag. Defaults to "<appVersion>-minimal" (or "<appVersion>-sqlite" when variant=sqlite).
+ # Overrides the image tag. Defaults to "v<appVersion>-<variant>", or "v<appVersion>" when variant=full.
tag: ""
imagePullSecrets: []
@@ -70,6 +70,7 @@ affinity: {}
# Deployment variant:
# "minimal" — external ClickHouse + PostgreSQL (recommended for production)
+# "duckdb" — embedded SQLite main DB + DuckDB telemetry, no external databases (recommended single-pod setup)
# "sqlite" — embedded SQLite, no external databases required
# "full" — all-in-one image with bundled ClickHouse + PostgreSQL (supervisord)
variant: minimal
@@ -126,6 +127,20 @@ sqlite:
# (32 for 1Gi). Empty keeps the backend default of 512.
cacheSizeMB: ""
+# DuckDB configuration — only used when variant=duckdb. The main SQLite DB lives
+# at path and the telemetry store next to it (traceway_telemetry.duckdb).
+duckdb:
+ path: "/data/traceway.db"
+ retentionDays: "30"
+ # Memory budget for the telemetry engine, e.g. "2GB". Empty lets DuckDB take
+ # about 80% of the node's RAM, so with a memory limit set it to roughly half
+ # the limit.
+ memoryLimit: ""
+ # Caps the engine's threads, e.g. "4". Empty uses every core of the node.
+ threads: ""
+ # WAL size that triggers a checkpoint, e.g. "256MB". Empty keeps DuckDB's 16MB.
+ checkpointThreshold: ""
+
# Session recording storage
storage:
type: "local" # "local" or "s3"
@@ -180,7 +195,7 @@ oidc:
disablePasswordLogin: "false"
# Persistent volume for local session recordings and/or SQLite data.
-# Strongly recommended when variant=sqlite or storage.type=local.
+# Strongly recommended when variant=sqlite, variant=duckdb or storage.type=local.
persistence:
enabled: false
storageClass: ""