Design documents

When contributing large changes or features to the Prometheus ecosystem, design documents are written by individuals or groups. Those documents are proposed for review and approval to the community.

This page is a list of the design documents we know of. If you create a new design document, or some documents are not listed, please open a pull request to add it to this list.

Design docs do not always reflect exactly what has been implemented, and implementation details might have changed since a feature was merged. Design docs are not considered documentation and can not define a standard.

If you want to pick a design doc in TODO or implement a proposed design doc, please reach out to the developers mailing list first to make sure no one else has picked that task already, and the design doc is approved and still relevant.

Problem statements and exploratory documents

Sometimes we’re looking even further into potential futures. The documents in this section are largely exploratory. They should be taken as informing our collective thoughts, not as anything concrete or specific.