Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Responds to triggers (i.e. from cron or the SNMP agent)
  • Checks local Device Settings for the URL of the file store, the logs it should send, and the repository it should use
  • Gets connection credentials
  • Makes a connection to the remote server and sends the files

Features

  • Log upload uses Xconf as the primary end point
  • Ability to configure enable/disable log upload for a device/group of devices (During bootup, box retrieves configuration information from xconf. Based on rules defined  in xconf server, we can control whether this particular device needs to do log upload or not.)
  • Allows sampling of devices from a bigger population
  • Configuration server is responsible for retrieving and delivering settings to any client
  • Configurable upload methods (HTTP/SCP)

How STBs Upload Logs and Metrics

STBs check in with Xconf with the query : "Give me my logging and telemetry configuration." Part of their query string includes several (about four) parameters of this particular box. Things like MAC address, model, current firmware version, and environment.

Xconf server looks at these parameters and runs them through a rules engine that finds the closest targeting rule match to the box's profile. Once it finds a match, it retrieves the configuration for that rule.

The configuration includes things like upload schedule, repository URL, upload protocol,  path to the file server, a protocol indicator, upload time smear and more.

Once the box gets the response, it parses it. It sets the specified random schedule that delays uploading the files. At that time, the box packages up all of its log files (up to twelve of them), compresses the bundle, and uploads the archive to the destination: