demo_uptime

BEAM VM uptime and statistics service with embeddable LiveComponent.

This application demonstrates deploying an Elixir/Phoenix service via hex.pm using bc_gitops, with a LiveComponent that can be embedded in host applications.

Features

Real-time BEAM VM statistics
Memory breakdown (processes, atoms, binaries, ETS, code)
Process count and limits
Scheduler and CPU information
I/O and garbage collection stats
Formatted uptime display
Embeddable LiveComponent for host application dashboards

Endpoints

Endpoint	Description
`GET /`	Service info and available endpoints
`GET /health`	Health check with uptime
`GET /info`	Application version and OTP info
`GET /stats`	Full VM statistics
`GET /stats/memory`	Memory breakdown
`GET /stats/processes`	Process count and limits
`GET /stats/uptime`	Uptime information

Installation

Add to your mix.exs:

def deps do
  [
    {:demo_uptime, "~> 0.2.0"}
  ]
end

Configuration

Default HTTP port is 8083. Configure via application environment:

config :demo_uptime, DemoUptimeWeb.Endpoint,
  http: [port: 8083]

Embeddable LiveComponent

The DemoUptimeWeb.StatsComponent can be embedded in host applications:

<.live_component
  module={DemoUptimeWeb.StatsComponent}
  id="uptime-stats"
  host_app="my_app"
  theme="dark"
/>

Component Features

Live uptime counter with days/hours/minutes/seconds
Memory usage with breakdown (processes, binary, ETS)
Process count with usage bar
Scheduler/CPU information
I/O statistics
GC stats and system info
Theme support (light/dark)

bc_gitops Integration

To deploy via bc_gitops using hex.pm as source, create an app.config:

#{
    name => demo_uptime,
    version => <<"0.2.0">>,
    source => #{
        type => hex
    },
    env => #{
        http_port => 8083,
        liveview_components => [
            #{
                id => vm_stats,
                module => &#39;Elixir.DemoUptimeWeb.StatsComponent&#39;,
                title => <<"BEAM Stats">>,
                description => <<"Real-time BEAM VM statistics">>
            }
        ]
    },
    health => #{
        type => http,
        port => 8083,
        path => <<"/health">>
    }
}.

Example Response

GET /stats:

{
  "uptime": {
    "wall_clock_ms": 3661234,
    "runtime_ms": 12345,
    "formatted": "01:01:01",
    "days": 0,
    "hours": 1,
    "minutes": 1,
    "seconds": 1
  },
  "memory": {
    "total_bytes": 45678912,
    "total_mb": 43.56,
    "processes_bytes": 12345678,
    "system_bytes": 33333234,
    "atom_bytes": 1234567,
    "binary_bytes": 2345678,
    "code_bytes": 8901234,
    "ets_bytes": 567890
  },
  "processes": {
    "count": 89,
    "limit": 262144,
    "usage_percent": 0.03
  },
  "system": {
    "otp_release": "27",
    "erts_version": "15.0",
    "schedulers": 8,
    "schedulers_online": 8,
    "logical_processors": 8,
    "node": "nonode@nohost"
  },
  "io": {
    "input_bytes": 12345678,
    "output_bytes": 2345678,
    "input_mb": 11.77,
    "output_mb": 2.24
  },
  "gc": {
    "number_of_gcs": 1234,
    "words_reclaimed": 5678901
  }
}

Development

# Get dependencies
mix deps.get

# Compile
mix compile

# Run server
mix phx.server

# Test endpoints
curl http://localhost:8083/health
curl http://localhost:8083/stats

License

MIT - See LICENSE for details.