Agent Installation
Install the Basira collector agent via Helm.
The Basira agent runs near your database and collects telemetry data (query stats, active sessions, table metrics) and ships it to the Basira API.
Prerequisites
- Kubernetes cluster with Helm 3+
- Network access from the agent to your database
- A Basira API key (available from the dashboard)
Quick Install
helm install basira-agent oci://registry.basira.io/charts/basira-agent \
--set apiKey=YOUR_API_KEY \
--set database.host=your-db-host \
--set database.port=5432 \
--set database.user=basira_monitorvalues.yaml Reference
apiKey: "" # Required — your Basira API key
apiEndpoint: "" # Override API endpoint (default: api.basira.io)
database:
host: "" # Required — database hostname
port: 5432 # Database port
user: basira_monitor # Database user (see setup guides)
sslMode: require # SSL mode: disable, require, verify-full
collection:
intervalSeconds: 10 # How often to collect stats
activeQueries: true # Collect pg_stat_activity
queryStats: true # Collect pg_stat_statements
tableStats: true # Collect pg_stat_user_tables
slowQueryLog: true # Collect auto_explain output
resources:
requests:
cpu: 50m
memory: 64Mi
limits:
cpu: 200m
memory: 128MiVerify Installation
kubectl get pods -l app=basira-agent
kubectl logs -l app=basira-agent --tail=20You should see logs indicating successful connection to both the database and the Basira API.