Usage Data

To support LiveSwitch Server's usage-based billing model, some anonymized data is sent from LiveSwitch Server installations to LiveSwitch servers.

Offline license keys are available for use cases where this isn't an option for some reason such as legal or technical.

The usage data sent is a stripped-down and anonymized version of the following events:

• Client Registered (client.registered)
• Client Unregistered (client.unregistered)
• Client Joined Channel (channel.client.joined)
• Client Left Channel (channel.client.left)
• Connection Initializing (connection.initializing)
• Connection Connected (connection.connected)
• Connection Closed/Failed (connection.closed/failed)

Information Included

Application IDs, channel IDs, client IDs, and connection IDs are all included, along with event metadata like timestamp and whether the event originated with a client application or a Media Server.

Since application IDs and channel IDs are custom strings that could contain personally identifiable information, they're one-way hashed into to a v5 UUID before leaving the installation site. Client IDs and connection IDs are auto-generated UUIDs with no risk of leaking personally identifiable information.

Client Registered

{
  "timestamp": 1224486000000,
  "origin": "client",
  "type": "client.registered",
  "client": {
    "version": "1.0.0",
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "id": "c314023ef9664a6ba26a312bdbc23b3f"
  }
}

Client Unregistered

{
  "timestamp": 1224486000000,
  "origin": "client",
  "type": "client.unregistered",
  "client": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "id": "c314023ef9664a6ba26a312bdbc23b3f"
  }
}

Client Joined Channel

{
  "timestamp": 1224486000000,
  "origin": "client",
  "type": "channel.client.joined",
  "client": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "id": "c314023ef9664a6ba26a312bdbc23b3f"
  },
  "channel": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "id": "a064a6f78027559688e1add7ce2723a7"
  }
}

Client Left Channel

{
  "timestamp": 1224486000000,
  "origin": "client",
  "type": "channel.client.left",
  "client": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "id": "c314023ef9664a6ba26a312bdbc23b3f"
  },
  "channel": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "id": "a064a6f78027559688e1add7ce2723a7"
  }
}

Connection Initializing

{
  "timestamp": 1224486000000,
  "origin": "client",
  "type": "connection.initializing",
  "connection": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "channelId": "a064a6f78027559688e1add7ce2723a7",
    "clientId": "c314023ef9664a6ba26a312bdbc23b3f",
    "id": "53898c90867545f9bfd420883b9a7721",
    "type": "mcu"
  }
}

This event is also captured from the Media Server if it's involved; that's, for an SFU or MCU connection. The external ID is the client-side connection ID.

{
  "timestamp": 1224486000000,
  "origin": "mediaserver",
  "type": "connection.initializing",
  "connection": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "channelId": "a064a6f78027559688e1add7ce2723a7",
    "clientId": "c314023ef9664a6ba26a312bdbc23b3f",
    "externalId": "53898c90867545f9bfd420883b9a7721",
    "id": "1096505626214d328f85c3cc9d7ad587",
    "type": "mcu"
  }
}

Connection Connected

{
  "timestamp": 1224486000000,
  "origin": "client",
  "type": "connection.connected",
  "connection": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "channelId": "a064a6f78027559688e1add7ce2723a7",
    "clientId": "c314023ef9664a6ba26a312bdbc23b3f",
    "id": "53898c90867545f9bfd420883b9a7721",
    "type": "mcu"
  }
}

This event is also captured from the Media Server if it's involved; that's, for an SFU or MCU connection. The external ID is the client-side connection ID.

{
  "timestamp": 1224486000000,
  "origin": "mediaserver",
  "type": "connection.connected",
  "connection": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "channelId": "a064a6f78027559688e1add7ce2723a7",
    "clientId": "c314023ef9664a6ba26a312bdbc23b3f",
    "externalId": "53898c90867545f9bfd420883b9a7721",
    "id": "1096505626214d328f85c3cc9d7ad587",
    "type": "mcu"
  }
}

Connection Closed/Failed

{
  "timestamp": 1569258928171,
  "origin": "client",
  "type": "connection.closed",
  "connection": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "channelId": "a064a6f78027559688e1add7ce2723a7",
    "clientId": "c314023ef9664a6ba26a312bdbc23b3f",
    "id": "53898c90867545f9bfd420883b9a7721",
    "type": "mcu"
  }
}

This event is also captured from the Media Server if it's involved; that's, for an SFU or MCU connection). The external ID is the client-side connection ID.

{
  "timestamp": 1569258928234,
  "origin": "mediaserver",
  "type": "connection.closed",
  "connection": {
    "applicationId": "50836b92ee2951ce85e580bea866fc59",
    "channelId": "a064a6f78027559688e1add7ce2723a7",
    "clientId": "c314023ef9664a6ba26a312bdbc23b3f",
    "externalId": "53898c90867545f9bfd420883b9a7721",
    "id": "1096505626214d328f85c3cc9d7ad587",
    "type": "mcu"
  }
}