Project Governance

The Prometheus project follows the Prometheus governance.

Community

Prometheus is developed in the open. Here are some of the channels we use to communicate and contribute:

Slack channel: #prometheus on CNCF Slack.

IRC: #prometheus on irc.libera.chat. This channel is bridged to the Matrix room below.

Matrix: #prometheus:matrix.org. This room is bridged to the IRC room above.

User mailing lists:

  • () – low-traffic list for announcements like new releases.
  • () – for discussions around Prometheus usage and community support. Announcements are not generally mirrored from .

Discourse forum: Web-based discussion forum at discuss.prometheus.io hosted by .

Calendar for public events: We have a public calendar for events, which you can use to join us.

If you just want to get an overview, simply use our .

If you're using Google products, there's an .

If you're using a different calendar, there's an .

Twitter:

GitHub: To file bugs and feature requests, use the GitHub issue tracker of the relevant . For questions and discussions, many repositories offer GitHub discussions. Generally, the other community channels listed here are best suited to get support or discuss overarching topics.

Please do not ask individual project members for support. Use the channels above instead, where the whole community can help you and benefit from the solutions provided. If community support is insufficient for your situation, please refer to the Support & Training page.

Contributing

We welcome community contributions! Please see the CONTRIBUTING.md file in the respective Prometheus repository for instructions on how to submit changes. If you are planning on making more elaborate or potentially controversial changes, please discuss them in the developers IRC channel or on the mailing list before sending a pull request.

We host public weekly meetings focused on Prometheus development and contributions. It’s meant for developers and maintainers to meet and get unblocked, pair review, and discuss development aspects of the Prometheus and related official projects (e.g node_exporter, alertmanager). The document linked below contains all the details, including how to register.

Slack channel: #prometheus-dev on CNCF Slack.

IRC: #prometheus-dev on irc.libera.chat. This channel is bridged to the Matrix room below.

Matrix: #prometheus-dev:matrix.org. This room is bridged to the IRC channel above.

Development mailing list: () – for discussions around Prometheus development.

Office Hours: – public weekly meetings focused on Prometheus development and contributions.

Developer summits

Developer summits are public meetings to discuss more involved development topics. They currently happen monthly as an online meeting. (For details, check out the public events calendar linked in the Community section above.) The Prometheus team curates the agenda based on recent discussions via other channels. To propose a topic, please send a mail to the at least 24 hours prior to the summit.

As of 2024, we carry a public . You can find our historic meeting notes below.

Developer Summit's Facilitator

The Facilitator role was created to help the Prometheus team to run the Developer Summits effectively. It's a rotational role (switches for every meeting) and its responsibilities are spread across different phases of the summit:

Before the summit

Before the summit, the Facilitator's main goal is to help the Prometheus team define the agenda and the topics to be discussed while making sure interested parties of the most voted topics will be able to attend the summit. We suggest the following tasks:

  • Two or three days before the meeting, send reminders in our public community channels inviting people to add Agenda Topics, and Prometheus Team members and maintainers to vote on topics they'd like to discuss.
  • One day before the meeting, reach out to "Topic owners" who received the most votes to make sure they'll make it to the summit.

During the summit

During the summit, the Facilitator is here to make sure the meeting runs smoothly, and that consensus is reached when needed. We suggest the following tasks:

  • Start the meeting on time. Use @prometheus.io account for the admin meeting permissions.
  • Start the recording and mention that the Code of Conduct applies.
  • Select topics to be discussed based on votes and who is currently present in the meeting.
  • Take notes or find volunteer for taking notes in the shared document.
  • Strategically step in when the discussion is not moving forward or deviating from the topic.
  • Call for consensus when needed.

After the summit

Once the meeting is over, the last task of the Facilitator is to find a new Facilitator for the next summit by sending an email to the Prometheus Team mailing list.

Code of Conduct

To make Prometheus a welcoming and harassment-free experience for everyone, we follow the .

Legal Umbrella

Prometheus is an independent open-source project and not controlled by any single company. To emphasize this we joined the Cloud Native Computing Foundation in 2016 as the second project after Kubernetes.

CNCF logo

Acknowledgements

Prometheus was started by and . The majority of its initial development was sponsored by .

We would also like to acknowledge early contributions by engineers from and .

Special thanks to for providing hosting resources.

The Prometheus logo was contributed by Robin Greenwood.