Documentation

observability

Observability Overview

Monitor CPU, memory, network, and health for every service you deploy on Runix.

Runix automatically collects metrics from every running service. You can view real-time CPU, memory, and network usage right in the dashboard — no extra setup required.

What You Can Monitor#

  • CPU usage — percentage of your instance's CPU allocation being used
  • Memory usage — how much RAM your service is consuming
  • Network I/O — bytes sent and received over time
  • Container health — whether your service is running and responding to health checks

Viewing Metrics#

1

Open the Observability page

Go to your dashboard and click Observability in the sidebar.

2

Select a service

Pick the deployment you want to monitor from the dropdown. You'll see live charts for CPU, memory, and network.

3

Choose a time range

Metrics are sampled every 30 seconds. You can view the last hour, last 24 hours, or last 7 days.

If your service is using more than 80% of its memory consistently, consider upgrading to a larger instance type.

Health Checks#

For web services, Runix sends an HTTP GET request to your health check path (default: /) every 30 seconds. If the service fails to respond 3 times in a row, it is marked as unhealthy and Runix will attempt to restart it.

You can set a custom health check path in your runix.yaml:

runix.yaml
yaml
services:
  - name: my-api
    type: web-service
    health_check_path: /health

Resource Limits by Instance Type#

InstanceCPUMemoryMax PIDs
Starter0.5 vCPU512 MB128
Standard1 vCPU2 GB256
Pro2 vCPU4 GB512

If your app exceeds its memory limit, the container is killed and restarted automatically. Check your dashboard for OOM (out of memory) events.

Metrics via CLI#

Check the status of your deployments from the terminal:

bash
runix status my-api

Example output

bash
Service: my-api
Status:  running
URL:     https://my-api-x7kf.runixcloud.dev
Runtime: node
Instance: starter (0.5 CPU, 512 MB)
Uptime:  3 days, 12 hours