Confirmed users
36
edits
Gfritzsche (talk | contribs) (Make it clear that the id is a document id) |
(Make the "id" field optional for compatibility with SSL Report submissions) |
||
| Line 9: | Line 9: | ||
== POST/PUT Requests == | == POST/PUT Requests == | ||
Treat POST and PUT the same. Accept POST or PUT to URLs of the form<br /> | Treat POST and PUT the same. Accept POST or PUT to URLs of the form<br /> | ||
^/submit/'''namespace'''/'''id'''[/'''dimensions''']$ | ^/submit/'''namespace'''/['''id'''[/'''dimensions''']]$ | ||
Example Telemetry format:<br /> | Example Telemetry format:<br /> | ||
| Line 17: | Line 17: | ||
/submit/telemetry/ce39b608-f595-4c69-b6a6-f7a436604648/saved-session/Firefox/38.0a1/nightly/20150125030202 | /submit/telemetry/ce39b608-f595-4c69-b6a6-f7a436604648/saved-session/Firefox/38.0a1/nightly/20150125030202 | ||
Note that '''id''' above is a unique document ID, which could be used for de-duping submissions (if/when that is implemented). This is '''not''' intended to be the clientID field from FHR / Telemetry. | Note that '''id''' above is a unique document ID, which could be used for de-duping submissions (if/when that is implemented). This is '''not''' intended to be the clientID field from FHR / Telemetry. If '''id''' is omitted, we will not be able to de-dupe based on submission URLs. | ||
=== Namespaces === | === Namespaces === | ||
| Line 35: | Line 35: | ||
* Now -> timestamp ("Now" means the current time on the edge server node. Should use ntp or similar to ensure correct server time) | * Now -> timestamp ("Now" means the current time on the edge server node. Should use ntp or similar to ensure correct server time) | ||
* namespace -> logger | * namespace -> logger | ||
* id -> uuid | * id -> uuid (if supplied, otherwise randomly generate a uuid) | ||
* Edge hostname -> hostname | * Edge hostname -> hostname | ||
* Type -> “incoming” (open to suggestions for naming) Some indication that this is a raw message. | * Type -> “incoming” (open to suggestions for naming) Some indication that this is a raw message. | ||