流媒体性能

整体流媒体健康状况

如果没有人能够观看，直播就没有意义。 The Stream Performance page in the admin, at /admin/stream-health, gives you 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.

The page charts four things: Video Segment Download, Player Network Speed, Errors and Quality Changes, and Viewer Latency.

看到错误、低网络速度和您内容的下载时间过长，可能意味着您需要添加更多的视频质量，以改善低带宽观众、移动网络或其他因素的播放性能。

如果您在此页面看到人们在播放您的直播时遇到问题，您可能希望进行故障排除。

Note: Only some players report detailed playback metrics themselves, mostly web browsers running the Owncast web interface.

Server-observed playback metrics require Owncast v0.3.0

For players that do not self-report, such as VLC, mpv, Safari and ffmpeg, Owncast records the download speed and duration of video segments it serves, as observed by the server. This only works when Owncast serves the video itself. If your segments are hosted on S3 storage, viewers download them from there and these players are not represented in the metrics.

硬件

了解您的 CPU 在视频处理任务中保持性能的重要性，这在故障排除时非常重要。 Owncast 为您提供关键硬件指标的高级概览，以帮助您处理这一点。

如果您发现您的硬件被过度利用，您可能希望故障排除。

普罗米修斯

对于喜欢使用外部监控解决方案的人，Owncast 支持使用 Prometheus 来收集一组指标。

您可以将 Prometheus 配置指向您的 Owncast 实例，端点为 /api/admin/prometheus，使用基本身份验证和管理员登录数据。

例如：

- 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"]

Exported metrics

All series are gauges, and all carry two constant labels: version (the Owncast version) and host (your configured server URL, or unknown if it isn't set).

Name	Meaning
owncast_instance_active_viewer_count	The number of current viewers.
owncast_instance_active_chat_client_count	The number of connected chat clients.
owncast_instance_total_chat_users	The total number of chat users on this Owncast instance.
owncast_instance_current_chat_message_count	The number of chat messages currently saved before cleanup.
owncast_instance_playback_error_count	Errors reported by players within the current collection window.
owncast_instance_cpu_usage	CPU usage as seen internally by Owncast.

Owncast refreshes these values every 2 minutes, so scraping more frequently than that won't give you more resolution.