オープンソース

一覧へ

3. 取得可能な統計情報

3.1. Jitsi Meet公式情報

Jitsi Meetの公式が公開している統計情報の一覧は次のURLにあります。

ただし、現在(2024年10月)、Jitsi Meetのアップデートに資料が追従していないため、 このURLに記載された情報とは異なる値が統計情報として返却されます。

3.2. 本テンプレートが取得を想定している情報

このマニュアルで解説しているテンプレートでは、次の情報を取得することを想定しています。

{
  "average_participant_stress": 0.01,
  "bit_rate_download": 0,
  "bit_rate_upload": 0,
  "conferences": 0,
  "current_timestamp": "2024-10-24 02:47:27.605",
  "drain": false,
  "dtls_failed_endpoints": 0,
  "endpoints": 0,
  "endpoints_disconnected": 0,
  "endpoints_reconnected": 0,
  "endpoints_sending_audio": 0,
  "endpoints_sending_video": 0,
  "endpoints_with_high_outgoing_loss": 0,
  "endpoints_with_spurious_remb": 0,
  "endpoints_with_suspended_sources": 0,
  "graceful_shutdown": false,
  "healthy": true,
  "inactive_conferences": 0,
  "inactive_endpoints": 0,
  "incoming_loss": 0.0,
  "largest_conference": 0,
  "local_active_endpoints": 0,
  "local_endpoints": 0,
  "muc_clients_configured": 1,
  "muc_clients_connected": 1,
  "mucs_configured": 1,
  "mucs_joined": 1,
  "num_eps_no_msg_transport_after_delay": 0,
  "num_eps_oversending": 0,
  "num_relays_no_msg_transport_after_delay": 0,
  "octo_conferences": 0,
  "octo_endpoints": 0,
  "octo_receive_bitrate": 0,
  "octo_receive_packet_rate": 0,
  "octo_send_bitrate": 0,
  "octo_send_packet_rate": 0,
  "outgoing_loss": 0.0,
  "overall_loss": 0.0,
  "p2p_conferences": 0,
  "packet_rate_download": 0,
  "packet_rate_upload": 0,
  "participants": 0,
  "preemptive_kfr_sent": 0,
  "preemptive_kfr_suppressed": 0,
  "receive_only_endpoints": 0,
  "rtt_aggregate": 0.0,
  "shutting_down": false,
  "stress_level": 0.0,
  "threads": 41,
  "total_bytes_received": 5301841,
  "total_bytes_received_octo": 0,
  "total_bytes_sent": 9586670,
  "total_bytes_sent_octo": 0,
  "total_colibri_web_socket_messages_received": 0,
  "total_colibri_web_socket_messages_sent": 0,
  "total_conference_seconds": 952,
  "total_conferences_completed": 1,
  "total_conferences_created": 1,
  "total_data_channel_messages_received": 209,
  "total_data_channel_messages_sent": 257,
  "total_dominant_speaker_changes": 1,
  "total_ice_failed": 0,
  "total_ice_succeeded": 3,
  "total_ice_succeeded_relayed": 0,
  "total_keyframes_received": 11,
  "total_layering_changes_received": 4,
  "total_packets_received": 35688,
  "total_packets_received_octo": 0,
  "total_packets_sent": 55609,
  "total_packets_sent_octo": 0,
  "total_participants": 3,
  "total_relays": 0,
  "total_video_stream_milliseconds_received": 225691,
  "total_visitors": 0,
  "version": "2.3.168-g28674f78",
  "visitors": 0
}

利用しているJitsi Meetのバージョンによっては、APIが返却する統計情報が この内容と異なる場合があります。その場合は、テンプレートの修正が必要です。

3.3. よく利用する統計情報

上記のとおり、公式の情報がプログラムに追従しきれていないため、 マニュアルで説明があり、有用な項目について解説を記載します。

  • conferences: 現在の会議の数
  • participants: 現在の参加者人数(公式マニュアルには非推奨とあるが利用可能。下記endpointsに代わる可能性がある)
  • endpoints: 現在のエンドポイントの数(エンドポイントは接続端末やシステムと理解できる)
  • endpoints_sending_audio: オーディオを送信しているエンドポイントの現在の数
  • endpoints_sending_video: ビデオを送信しているエンドポイントの現在の数
  • bit_rate_download: 現在の入力ビットレート(Kbit/秒)
  • bit_rate_upload: 現在の出力ビットレート(Kbit/秒)
  • packet_rate_download: 現在の受信パケットレート(パケット/秒)
  • packet_rate_upload: 現在の送信パケットレート(パケット/秒)

3.4. 注意事項

統計情報に関する注意事項は次の通りです。

  • 取得可能な情報は、Jitsi VideoBridgeのColibri APIに基づくため、新たに値を増やすことはできません
  • APIの仕様上、基本的に現在のデータを取得するため、過去に遡ってデータを取得・登録することはできません
一覧へ