Agent Installation

The PulseStream agent is a lightweight service that runs in your Kubernetes cluster. It collects telemetry (logs, events, metrics) and streams it to the PulseStream control plane for AI-powered analysis.

Prerequisites

• Kubernetes 1.25+
• Helm 3.10+
• A PulseStream account with a workspace

Provisioning flow

PulseStream uses token-based provisioning — you never need to copy-paste API keys:

1. Generate a provisioning token in the PulseStream dashboard (valid for 30 minutes)
2. Apply the YAML manifest to your cluster (creates a Kubernetes Secret)
3. Install the agent via Helm — it reads the secret automatically
4. The agent exchanges the token for permanent credentials and connects

Install with Helm

Step 1: Generate a provisioning token

Go to Settings → Connection in the PulseStream dashboard and click Generate Provisioning Token. Copy the YAML manifest.

Step 2: Apply the provisioning secret

kubectl apply -f agent-provision.yaml

Step 3: Install the agent

helm repo add pulsestream https://charts.pulsestream.ai
helm repo update

helm install pulsestream-agent pulsestream/pulsestream-agent \
  --namespace pulsestream-agent \
  --create-namespace

The agent reads the provisioning secret, exchanges it for permanent credentials, and connects to the control plane automatically.

Note

The provisioning token is single-use and expires after 30 minutes. If it expires before the agent starts, generate a new one from the dashboard.

Configuration options

Parameter	Description	Default
agent.controlPlaneUrl	PulseStream control plane URL	https://app.pulsestream.ai
agent.namespaces	Namespaces to watch (comma-separated)	All namespaces
agent.resources.requests.cpu	CPU request	100m
agent.resources.requests.memory	Memory request	128Mi
agent.resources.limits.cpu	CPU limit	500m
agent.resources.limits.memory	Memory limit	512Mi

Verify connection

After installation, check the agent status:

kubectl get pods -n pulsestream-agent
kubectl logs -n pulsestream-agent deployment/pulsestream-agent --tail=20

In the PulseStream dashboard, navigate to Settings → Connection. The status should show as connected.

Upgrading

helm repo update
helm upgrade pulsestream-agent pulsestream/pulsestream-agent \
  --namespace pulsestream-agent

Uninstalling

helm uninstall pulsestream-agent --namespace pulsestream-agent
kubectl delete namespace pulsestream-agent

Next steps

Troubleshooting Having connection issues? Check common problems and solutions.