Towards removing the experimental "flag" from the Remote Write protocol.

[Tom Wilkie]

Hello!

I would like to start the discussion about removing the experimental "flag" from the remote write protocol.  This protocol has been widely adopted by many* systems, and any changes at this stage would break lots of people.

I think before we remove the experimental flag we need to actually document the protocol.  To that end, please read and comment on a (very) early draft: https://docs.google.com/document/d/1LPhVRSFkGNSuU1fBd81ulhsCPR4hkSZyyBj1SZ8fWOM/edit#

After documenting the current protocol, we should also give thought as to how to upgrade it in the future, and make it both backwards and forwards compatible.  If anyone has any suggestions on other things we should do before we "standardise" this, please do let me know.

Thanks

Tom

* I count at least 27 at https://prometheus.io/docs/operating/integrations/

[Tom Wilkie]

Thank you everyone who commented on this doc - I feel like it's in pretty good shape:

https://docs.google.com/document/d/1LPhVRSFkGNSuU1fBd81ulhsCPR4hkSZyyBj1SZ8fWOM/edit#

I'm going to move this into a PR against the doc repo in the next week or two and call it "done", so if anyone wants to give it another read over or has any questions, please do let me know!

Thanks

Tom