Kubernetes Integration

Deployment pattern with Secrets and ConfigMaps

Install

Use templates from sdk/integrations/k8s.

helm upgrade --install obtrace-sdk-integration \
  ./deploy/helm/obtrace-sdk-integration \
  -n observability --create-namespace \
  -f ./deploy/helm/obtrace-sdk-integration/values-dev.yaml

Configuration

  • Secret obtrace-sdk with OBTRACE_API_KEY
  • ConfigMap obtrace-sdk-config with ingest URL and tenant/project IDs

Quick start

  1. Apply Secret and ConfigMap.
  2. Inject variables in your deployment.
  3. Initialize SDK during app bootstrap.

Production hardening

  1. Rotate keys with controlled rollout.
  2. Segment keys by namespace/project.
  3. Keep readiness/liveness probes.
  4. Validate ingestion after deployment.

Troubleshooting

  • No telemetry: validate env injection and network policy.
  • 429: verify tenant/project quotas.
  • High latency: tune flush interval and network path.

On this page