Skip to main content
Admin › Settings › Monitoring
This page is for external observability stack integration. It differs from the Monitoring tab, where you view usage and logs directly in the UI.
Enabling OpenTelemetry (OTEL) lets you export Cloosphere’s metrics, logs, and traces to an external monitoring stack. A deployment package composed of Prometheus, Grafana, Loki, and the OTEL Collector is provided.
Monitoring (OpenTelemetry) settings

Enabling OpenTelemetry

Turning on the Enable OpenTelemetry toggle starts OTEL-based telemetry collection and export.

Deploying the Monitoring Stack

Download and install the configuration package (Prometheus, Grafana, Loki, OTEL Collector) to deploy on your monitoring server.
1

Download the package

curl -H "Authorization: Bearer <API_KEY>" \
  "https://<your-host>/api/v1/configs/monitoring/download" \
  -o cloosphere-monitor.tar.gz
Find <API_KEY> under profile icon (bottom left) → Settings → Account → API Keys. You can also use the Download directly in browser button on the screen.
2

Extract

tar xzf cloosphere-monitor.tar.gz && cd cloosphere-monitor
3

Check environment variables

cat .env
Server settings are reflected automatically.
4

Run the setup script

./setup.sh