Stream performance

Overall stream health#

There’s no point streaming if nobody is able to watch it. Using the “Stream Health” screen in the admin you can get an overview of some important metrics that may give you an idea if what you’re offering your viewers is leading to a good experience.

Seeing errors, low network speeds, and excessive download times for your content may mean you need to add additional video qualities to improve the playback performance for lower bandwidth viewers, mobile networks, or other factors.

If you’re seeing on this page that people are experiencing issues playing back your stream, you may wish to troubleshoot.

Note: Not all players will be represented in playback metrics as Owncast can only get detailed playback details in certain browsers, and not at all from external players (QuickTime, VLC, mpv, smart tvs, etc).

Hardware#

Knowing how your CPU, in particular, is keeping up with the video processing tasks is important when troubleshooting. Owncast gives you a high level overview of key hardware metrics to help with this.

If you see your hardware is being over utilized, you may wish to troubleshoot.

Prometheus#

For people who prefer to use external monitoring solutions, Owncast supports using Prometheus to collect a set of metrics.

You can point your Prometheus config at your Owncast instance with the endpoint of /api/admin/prometheus, using basic auth and the admin login data.

For example:

- job_name: owncast
  scrape_interval: 1m
  metrics_path: /api/admin/prometheus
  scheme: https
  basic_auth:
    username: admin
    password: my_admin_password
  static_configs:
    - targets: ["my.owncast.server"]