Berserk Admin
Cluster management, Helm charts, Kubernetes, and meta service configuration
Administration documentation for deploying and managing Berserk clusters. For initial installation, see the Quick Start.
Services
Berserk is composed of the following services:
| Service | Description | Default Port |
|---|---|---|
| gateway | Public edge: auth, OIDC, HTTP+JSON/SSE proxy | 9500 |
| meta | Metadata management | 9560 |
| query | Query engine | 9510 |
| ingest | Telemetry ingestion (OTLP) | 4317 (gRPC) / 4318 (HTTP) |
| janitor | Background maintenance (merging, compaction) | — |
| nursery | Baby segment management | 9530 |
| ui | Web interface | 80 |
Helm Configuration
The Berserk Helm chart is available at:
helm repo add berserk https://berserkdb.github.io/helm-chartsKey Parameters
| Parameter | Description | Default |
|---|---|---|
global.imageTag | Image tag for all services | Chart appVersion |
global.storage.endpoint | S3-compatible storage endpoint | "" |
global.storage.bucket | S3 bucket name | "" |
global.storage.region | S3 region | "auto" |
global.observability.otlpEnabled | Enable OTLP telemetry export | false |
global.observability.otlpEndpoint | OTLP collector endpoint | "ingest:4317" |
global.s3Credentials.secretName | Name of the S3 credentials secret | "s3-credentials" |
global.postgresCredentials.secretName | Name of the Postgres credentials secret | "postgres-credentials" |
query.cache.size | Query segment cache size | "128Gi" |
ingest.service.ports.otlpGrpc | OTLP gRPC ingestion port | 4317 |
ingest.service.ports.otlpHttp | OTLP HTTP ingestion port | 4318 |
janitor.config.mergerIntervalSeconds | Interval between merge operations | 300 |
See the helm-charts repository for full configuration reference and example values.
Observability
Monitoring Berserk itself — scraping the per-pod Prometheus /metrics endpoint
and exporting Berserk's own telemetry over OTLP — is documented on the
Observability page.