Telemetry checklist

Adding telemetry generally involves a few steps:

  1. File a “user story” bug about who wants what question answered. This will be used to track the client-side implementation as well as the data review request. If the server side changes are needed, ask Nan (:nanj / @ncloudio) if in doubt, bugs will be filed separately as dependencies.

  2. Implement as usual…

  3. Update system-addon/test/schemas/pings.js with a commented JOI schema of your changes, and add tests to system-addon/test/unit/TelemetryFeed.test.js to exercise the ping creation.

  4. Update data_events.md with an example of the data in question.

  5. Update any fields that you’ve added, deleted, or changed in data_dictionary.md.

  6. Get review from Nan on the data schema and the documentation changes.

  7. Request data-review of your documentation changes from a data steward to ensure suitability for collection controlled by the opt-out datareporting.healthreport.uploadEnabled pref. Download and fill out the data review request form and then attach it as a text file on Bugzilla so you can r? a data steward. We’ve been working with Chris H-C (:chutten) for the Firefox specific telemetry, and Kenny Long (kenny@getpocket.com) for the Pocket specific telemetry, they are the best candidates for the review work as they know well about the context.

  8. After landing the implementation, check with Nan to make sure the pings are making it to the database.

  9. Once data flows in, you can build dashboard for the new telemetry on Redash. If you’re looking for some help about Redash or dashboard building, Nan is the guy for that.