Datadog is a tool for monitoring application performance measurements and user engagement.

This page guides you on some of the metrics that are collected and setps to integrate the Millicast SDK to the browser agent.

Client Analytics

An overview of some of the analytics that will be collected. You can customize your dashboard to display the metrics important for your use case. Some examples of the types of data collected:

✓ Device analytics such as user agent, browser, operating system, device size, versions

✓ Geolocation details including country, city, ip address and network details

✓ WebRTC statistics like fps, round trip time, jitter, packet and frame loss rates, and bitrate

When combined with our Live Monitoring and Stream Syndication capabilities you can effectively monitor playback issues and track viewer characteristics.

Setting Up Datadog Browser Agent

1. Initialize the Datadog Browser Agent

Include the browser agent:

<script type="text/javascript" src="https://www.datadoghq-browser-agent.com/us1/v5/datadog-logs.js"></script>

Early in your application you will need to initialize the agent with details from your Datadog account. You'll need your clientToken and site.


  window.DD_LOGS &&
  window.DD_LOGS.init({
    clientToken: 'pub922...187',
    site: 'datadoghq.eu',
    forwardErrorsToLogs: true,
    sessionSampleRate: 100
  })

2. Capture Millicast Track Events

When receiving a track event after connecting, you can send the event.

 millicastView.on("track", (event) => {
   // ...
   window.DD_LOGS.logger.info(event);
 });

You may also want to capture Broadcast Events for a fuller picture.

3. Collect WebRTC Stats

See the Web SDK page to learn more about gathering media statistics for the WebRTC connection.

 millicastView.webRTCPeer.initStats();
 millicastView.webRTCPeer.on("stats", (stats) => {
     window.DD_LOGS.logger.info(stats);
 });

4. Setup a Datadog Dashboard

As the events are logged in Datadog, you can create a custom Dashboard to display the metrics that are of most interest to you.

Sample

Here is an example payload from the Datadog agent:

{
    "id": "AgA...j",
    "content": {
        "timestamp": "2024-04-03T18:30:16.236Z",
        "tags": [
            "sdk_version:5.14.0",
            "source:browser",
            "api:fetch",
            "datadog.submission_auth:client_token"
        ],
        "attributes": {
            "date": 1712169016236,
            "candidateType": "prflx",
            "origin": "logger",
            "session_id": "c98...1",
            "raw": "[RTCStatsReport]",
            "video": {
                "inbounds": [
                    {
                        "frameHeight": 1080,
                        "totalBytesReceived": 389271613,
                        "packetsLostDeltaPerSecond": 0,
                        "mid": "0",
                        "totalPacketsReceived": 342289,
                        "bitrate": 3004616,
                        "mimeType": "video/H264",
                        "trackIdentifier": "ad5...6",
                        "frameWidth": 1920,
                        "jitter": 0.001,
                        "packetsLostRatioPerSecond": 0,
                        "totalPacketsLost": 0,
                        "framesPerSecond": 24,
                        "id": "IT0...0",
                        "timestamp": 1712169016229.288
                    }
                ]
            },
            "availableOutgoingBitrate": 300000,
            "network": {
                "client": {
                    "geoip": {
                        "continent": {
                            "code": "EU",
                            "name": "Europe"
                        },
                        "country": {
                            "name": "United Kingdom",
                            "iso_code": "GB"
                        },
                        "subdivision": {
                            "name": "England",
                            "iso_code": "GB-ENG"
                        },
                        "as": {
                            "number": "AS13237",
                            "route": "127.n.n.0/16",
                            "domain": "eunetworks.com",
                            "name": "euNetworks GmbH",
                            "type": "hosting"
                        },
                        "city": {
                            "name": "London"
                        },
                        "timezone": "Europe/London",
                        "ipAddress": "127.n.n.0",
                        "location": {
                            "latitude": 0.0,
                            "longitude": 0.0
                        }
                    },
                    "ip": "127.n.n.0"
                }
            },
            "view": {
                "referrer": "http://127.0.0.1:8000/demo/index.html",
                "url_details": {
                    "path": "/demo/index.html",
                    "scheme": "http",
                    "port": 5500,
                    "host": "127.0.0.1"
                },
                "referrer_details": {
                    "path": "/demo/index.html",
                    "scheme": "http",
                    "port": 5500,
                    "host": "127.0.0.1"
                },
                "url": "http://127.0.0.1:5500/demo/index.html"
            },
            "totalRoundTripTime": 11.284,
            "http": {
                "useragent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                "useragent_details": {
                    "os": {
                        "patch": "7",
                        "major": "10",
                        "minor": "15",
                        "family": "Mac OS X"
                    },
                    "browser": {
                        "patch": "0",
                        "patch_minor": "0",
                        "major": "123",
                        "minor": "0",
                        "family": "Chrome"
                    },
                    "device": {
                        "model": "Mac",
                        "family": "Mac",
                        "category": "Desktop",
                        "brand": "Apple"
                    }
                }
            },
            "audio": {
                "inbounds": [
                    {
                        "jitter": 0.002,
                        "totalBytesReceived": 12901210,
                        "packetsLostRatioPerSecond": 0,
                        "packetsLostDeltaPerSecond": 0,
                        "totalPacketsLost": 0,
                        "mid": "1",
                        "totalPacketsReceived": 51984,
                        "bitrate": 96272,
                        "mimeType": "audio/opus",
                        "id": "IT0...3",
                        "trackIdentifier": "3e5...4",
                        "timestamp": 1712169016229.288
                    }
                ]
            },
            "currentRoundTripTime": 0.006,
            "status": "info"
        }
    }
}