Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

The available metrics

WCS sends the following stream parameters for acquisition:

Metric

Id

Description

VIDEO_HEIGHT

1

Video height

VIDEO_WIDTH

2

Video width

VIDEO_RATE

3

Video bitrate, bps

VIDEO_SYNC

4

Video synchronization

VIDEO_FPS

5

Video frame rate per second

VIDEO_NACK

6

NACK requests count

VIDEO_PLI

7

PLI packets count

VIDEO_CODEC

8

Video codec

AUDIO_SYNC

9

Audio synchronization

AUDIO_RATE

10

Audio bitrate

AUDIO_LOST

11

Lost audio packets count

AUDIO_CODEC

12

Audio codec

The available metrics list can be obtained using REST API query /api/metric/list

https://hostname:8090/api/metric/list
{
  "id": "4"
}

Where

  • id – metric Id

If metric Id is set, the response will contain information about the metric with this Id only. Otherwise, response will contain list with all the available metrics.

The response contains the following fields:

[
    {
        "id": 4,
        "name": "Video rate",
        "note": "",
        "enumName": "VIDEO_RATE"
    }
]

Metrics acquisition principles

Metrics are combined to profiles to collect from specific nodes. Every profile contains specific metrics set and acquisition rate. For a profile, several metric acquisition rules, which are applied to a stream on a node, can be specified.

A number of profiles can be applied to one node (WCS instance). In that case, metric sets and rules from the profiles are summarized, and minimum acquisition rate for same metric is applied. Let's look on the example:

1. The profiles profile1 and profile2 are applied to test1.flashphoner.com node

2. profile1 includes

  • VIDEO_RATE, VIDEO_FPS metrics which are acquired with rate 5
  • the rule Stream name == stream1

3. profile2 includes

  • VIDEO_RATE, AUDIO_RATE metrics which are acquired with rate 10
  • the rule Stream name == stream1

As the result, for the stream stream1 on test1.flashphoner.com node the following metric sets will be acquired:

  • VIDEO_RATE with rate 5
  • VIDEO_FPS with rate 5
  • AUDIO_RATE with rate 10
  • No labels