What you get
| Property | Detail |
|---|---|
| Credential isolation | Tokens live in your K8s Secrets / Vault / AWS Secrets Manager. Foggy never sees them. |
| Outbound-only | Satellite initiates the connection to Foggy. No inbound firewall rules. |
| Same tools as direct connectors | Grafana, Prometheus, Kubernetes, and OpenSearch all work the same way — just executed inside your network. |
| Stateless relay | Foggy’s relay forwards requests but does not store or inspect them. |
Setup
- In the Console sidebar, click Integrations.
- On the Satellite card, click Show Setup Command.
- Enter a Cluster Name (e.g.
prod-us-east-1) and pick an Environment (Production / Staging / Development). - Click Generate Setup Command.
- Copy the Helm install command shown in the modal and run it in your target cluster. The command installs the Satellite with an embedded ingest token (
fst_...) that authenticates the outbound connection back to Foggy. - Once the Satellite sends its first heartbeat, the card flips to Connected.
Token is shown once. The command in the modal contains the only copy of the ingest token. Foggy stores just a SHA-256 hash. If you lose the command before installing, open the modal again and regenerate — the old token is invalidated.
Troubleshooting
- Card stays on “Waiting for connection” — the Satellite pod has not reached the Foggy relay. Check outbound connectivity from the pod to the relay URL, and confirm the Helm release installed cleanly (
kubectl get pods -n <namespace>). - Queries time out inside the cluster — the Satellite can reach Foggy but not your tools. Check the Satellite’s own network policies and RBAC against your Grafana / Prometheus / Kubernetes API endpoints.
- Token compromised — open the Satellite card and use Regenerate Token. The old token stops authenticating on next reconnect; update the Helm values with the new token and re-apply.
Next steps
Install Foggy self-hosted
If you also want the Foggy Console inside your own cluster.
Security
Data flow, credential handling, and encryption.