Quickstart: Kubernetes agent

1. Register the cluster

1. Open Infrastructure → Kubernetes.
2. Register a new cluster.
3. Save the Key ID (kck_…) and secret (sks_…) — the secret is shown once.
4. Lost the secret? Use Rotate secret (old secret stops working immediately).

2. Install the agent (Helm repo)

helm repo add seiri https://seiri-app.github.io/seiri-kube-agent
helm repo update
helm install seiri-agent seiri/seiri-kube-agent \
  --set seiri.backendUrl=https://cloud.seiri.app \
  --set seiri.clusterId=<key-id> \
  --set seiri.authToken=<cluster-secret>

OCI alternative:

helm install seiri-agent oci://ghcr.io/seiri-app/charts/seiri-kube-agent \
  --set seiri.backendUrl=https://cloud.seiri.app \
  --set seiri.clusterId=<key-id> \
  --set seiri.authToken=<cluster-secret>

3. Declare HealthChecks

Follow the chart docs to create HealthCheck CRs targeting your workloads. Phases such as Healthy / Unhealthy / Missing show up in Seiri.

4. Optional: CronJob heartbeats

In-cluster CronJobs can still HTTP-ping Seiri on completion:

curl -fsS -m 10 https://ping.seiri.app/webhook/<org-slug>:<webhook-ref>/success

backendUrl is always cloud.seiri.app for the agent. Do not set it to ping.seiri.app.