SaaS Stack Integration

Morpheus is intentionally SaaS-heavy outside the TEE. The goal is to minimize self-managed control-plane code and reserve the confidential VMs for execution only.

Current Managed Stack

1. Cloudflare
   • edge gateway
   • control plane
   • queues
   • workflows
   • DNS / routes
2. Upstash Redis
   • shared rate limiting
   • idempotency and replay suppression helpers
3. Supabase
   • durable job and application state
4. Vercel
   • web UI and backend routes
5. Sentry
   • browser and server error tracking
6. Checkly
   • API and browser synthetics
7. Better Stack
   • heartbeats, uptime, telemetry shipping
8. Grafana Cloud
   • optional deep relayer metrics only

Ownership Boundaries

Cloudflare

Cloudflare owns the first two layers of the production design:

• edge ingress
• control-plane auth and validation
• queue-backed execution lanes:
  • text

    Copy

    oracle_request

  • text

    Copy

    feed_tick

• workflow-backed orchestration lanes:
  • text

    Copy

    callback_broadcast

  • text

    Copy

    automation_execute

Key files:

• text

  Copy

  deploy/cloudflare/morpheus-edge-gateway/worker.mjs

• text

  Copy

  deploy/cloudflare/morpheus-control-plane/worker.mjs

• text

  Copy

  deploy/cloudflare/morpheus-control-plane/workflow-runtime.mjs

Upstash Redis

Upstash is the shared external memory for:

• edge and backend rate limits
• replay-safe locks
• request-guard helpers

Key files:

• text

  Copy

  workers/phala-worker/src/platform/upstash.js

• text

  Copy

  workers/phala-worker/src/platform/request-guards.js

• text

  Copy

  apps/web/lib/upstash.ts

• text

  Copy

  apps/web/lib/rate-limit.ts

Sentry

Sentry is the primary application error tracker for the Next.js surface.

Key files:

• text

  Copy

  apps/web/instrumentation.ts

• text

  Copy

  apps/web/instrumentation-client.ts

• text

  Copy

  apps/web/sentry.server.config.ts

• text

  Copy

  apps/web/sentry.edge.config.ts

Checkly

Checkly owns active synthetic verification for:

• oracle web
• control plane
• edge gateway
• selected AA frontend surfaces

Key files:

• text

  Copy

  monitoring/checkly/README.md

• text

  Copy

  scripts/checkly-sync-api-checks.mjs

• text

  Copy

  scripts/checkly-sync-browser-checks.mjs

Better Stack

Better Stack is the preferred operations layer for:

• cron heartbeats
• relayer heartbeats
• public uptime monitors
• log shipping / telemetry

Key files:

• text

  Copy

  scripts/betterstack-sync-heartbeats.mjs

• text

  Copy

  scripts/betterstack-sync-monitors.mjs

• text

  Copy

  scripts/betterstack-sync-sources.mjs

• text

  Copy

  workers/morpheus-relayer/src/betterstack-log-sink.js

Grafana Cloud

Grafana Cloud is optional. It exists for deeper relayer metrics when Better Stack heartbeats and telemetry are not enough.

Key files:

• text

  Copy

  workers/morpheus-relayer/src/prometheus.js

• text

  Copy

  workers/morpheus-relayer/src/metrics-server.js

• text

  Copy

  monitoring/grafana/README.md

Recommended Default Stack

For the current project size and operational goals:

• use Sentry for exceptions
• use Checkly for synthetic health
• use Better Stack for uptime, heartbeats, and telemetry
• keep Grafana Cloud disabled unless you need lower-level relayer metrics

That gives a simpler and cheaper default than running self-managed Prometheus infrastructure.

Required Credentials By Service

Cloudflare

• text

  Copy

  CLOUDFLARE_API_TOKEN

• text

  Copy

  CLOUDFLARE_ACCOUNT_ID

• text

  Copy

  CLOUDFLARE_ZONE_ID

Upstash

• text

  Copy

  UPSTASH_REDIS_REST_URL

• text

  Copy

  UPSTASH_REDIS_REST_TOKEN

Sentry

• text

  Copy

  NEXT_PUBLIC_SENTRY_DSN

• text

  Copy

  SENTRY_DSN

• recommended:
  • text

    Copy

    SENTRY_ORG

  • text

    Copy

    SENTRY_PROJECT

  • text

    Copy

    SENTRY_AUTH_TOKEN

  • text

    Copy

    SENTRY_ENVIRONMENT

Checkly

• text

  Copy

  CHECKLY_API_KEY

• text

  Copy

  CHECKLY_ACCOUNT_ID

• text

  Copy

  CHECKLY_PROJECT_NAME

Better Stack

• heartbeat URLs
• text

  Copy

  MORPHEUS_BETTERSTACK_LOG_INGESTING_HOST

• text

  Copy

  MORPHEUS_BETTERSTACK_LOG_SOURCE_TOKEN

Grafana Cloud

• text

  Copy

  GRAFANA_CLOUD_PROMETHEUS_PUSH_URL

• text

  Copy

  GRAFANA_CLOUD_PROMETHEUS_USERNAME

• text

  Copy

  GRAFANA_CLOUD_PROMETHEUS_API_KEY

Sync Commands

bash
 Copy
npm run sync:checkly
npm run sync:checkly:browser
npm run sync:betterstack
npm run sync:betterstack:monitors
npm run sync:betterstack:sources
npm run export:saas

Rollout Order

1. Cloudflare
2. Upstash
3. Supabase
4. Sentry
5. Checkly
6. Better Stack
7. Grafana Cloud only if needed

References

• Cloudflare Queues: https://developers.cloudflare.com/queues/
• Cloudflare Workflows: https://developers.cloudflare.com/workflows/
• Upstash Redis: https://upstash.com/docs/redis/overall/getstarted
• Sentry Next.js: https://docs.sentry.io/platforms/javascript/guides/nextjs/
• Checkly docs: https://www.checklyhq.com/docs/
• Better Stack Uptime: https://betterstack.com/docs/uptime/
• Grafana Cloud: https://grafana.com/docs/grafana-cloud/