Confirmed users
975
edits
No edit summary |
|||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
For more information about the "core" ping, check out the [https://gecko.readthedocs.io/en/latest/toolkit/components/telemetry/telemetry/data/core-ping.html in-tree documentation]. At the time of writing (9/7/2016), this is the only ping that is uploaded via Java telemetry. | |||
== Local development == | == Local development == | ||
This is currently how I (mcomella) test local telemetry. It could be improved. | This is currently how I (mcomella) test local telemetry. It could be improved. | ||
Line 5: | Line 7: | ||
* Get a server: <pre>git clone https://github.com/vdjeric/gzipServer.git</pre> | * Get a server: <pre>git clone https://github.com/vdjeric/gzipServer.git</pre> | ||
* You'll need to edit the .py file to remove the windows bindings (assuming you don't use windows) | * You'll need to edit the .py file to remove the windows bindings (assuming you don't use windows) | ||
* You'll need to tell the script listen on your ip address. On OS X, run `ifconfig`, look under en0, get the "inet" address, and | ** Replace the first line with | ||
* Run the server locally: <pre>python gzipServer.py -p <port></pre> | #!/usr/bin/env python | ||
* You'll need to tell the script listen on your ip address. On OS X, run `ifconfig`, look under en0, get the "inet" address, and set HOST_NAME in the script to the first address (not the broadcast). | |||
* Run the server locally, using a port greater than 1024 (unless you want to run the script as privileged code with sudo): | |||
<pre>python gzipServer.py -p <port></pre> | |||
=== Enable telemetry on local builds === | === Enable telemetry on local builds === | ||
* Go to TelemetryConstants, set UPLOAD_ENABLED to true | * Go to TelemetryConstants, set UPLOAD_ENABLED to true. | ||
* Build! | * Build! | ||
* Go to about:config and change the "toolkit.telemetry.server" preference to the ip address you set, i.e. `http://127.0.0.1:8080`. Be sure to get http vs. https correct! | |||
=== Check the results === | === Check the results === | ||
Line 17: | Line 23: | ||
* The gzip server output should say which file the ping was saved in | * The gzip server output should say which file the ping was saved in | ||
* `cat <that-file>` to ensure your ping looks correct. | * `cat <that-file>` to ensure your ping looks correct. | ||
== Testing production builds == | |||
* (as of FF50) You can change the target telemetry server via the "toolkit.telemetry.server" preference. | |||
* You can use the gzip server specified above as an endpoint for testing. |