Commit 102961bb authored by Richard Hartmann's avatar Richard Hartmann

docs/philosophy/: Feedback by @brian-brazil and typos

Signed-off-by: 's avatarRichard Hartmann <richih@richih.org>
parent 5292ccc5
...@@ -16,7 +16,7 @@ As a monitoring system, Prometheus is being relied upon to alert humans that ...@@ -16,7 +16,7 @@ As a monitoring system, Prometheus is being relied upon to alert humans that
they need to take action in order to prevent undesired system state. they need to take action in order to prevent undesired system state.
Thus, its most important function is to keep the pipeline of ingestion, rule Thus, its most important function is to keep the pipeline of ingestion, rule
evaluation, and alert hand-off working. evaluation, and alert notifications working.
The second most important function is to give humans context about these alerts The second most important function is to give humans context about these alerts
by allowing access to the most recent data Prometheus ingested by allowing access to the most recent data Prometheus ingested
...@@ -27,7 +27,7 @@ Note that this goal might result in widely different design decisions and thus ...@@ -27,7 +27,7 @@ Note that this goal might result in widely different design decisions and thus
operational patterns for different parts of our ecosystem: operational patterns for different parts of our ecosystem:
For Prometheus itself, this means running every instance as an island of data For Prometheus itself, this means running every instance as an island of data
completely detached from every other instance, except for optional federation. completely detached from every other instance.
For Alertmanager on the other hand, it means the exact opposite: meshing all For Alertmanager on the other hand, it means the exact opposite: meshing all
instances closely together, sharing knowledge about alerts and their instances closely together, sharing knowledge about alerts and their
...@@ -35,13 +35,19 @@ notifications. ...@@ -35,13 +35,19 @@ notifications.
## Simple operation ## Simple operation
Operation of Prometheus should be as easy and failure-tolerant as possible. We Operation of Prometheus should be as simple and failure-tolerant as possible. We
try to put required complexity into earlier phases, going through them less try to put required complexity into earlier phases, going through them less
often and ideally still while under the control of a smaller subset of people. often and ideally still while under the control of a smaller subset of people.
One example of this would be the preference of statically linked binaries over One example of this would be the preference of statically linked binaries over
dynamically-built ones. dynamically-built ones.
## Keep dependencies clear and limited
Any non-trivial system needs to integrate with other systems. To keep the
resulting complexity low, we will always try to have the fewest interfaces
possible and keep their resulting complexity as low as possible.
## Automation ## Automation
Computers are good at doing the same thing over and over again, and quickly. Computers are good at doing the same thing over and over again, and quickly.
......
...@@ -30,12 +30,12 @@ McIlroy's initial version from 1978](http://emulator.pdp-11.org.ru/misc/1978.07_ ...@@ -30,12 +30,12 @@ McIlroy's initial version from 1978](http://emulator.pdp-11.org.ru/misc/1978.07_
## Embrace cloud-native technologies ## Embrace cloud-native technologies
In many ways, the cloud-native approach mirrors the Unix philosphy, updating it In many ways, the cloud-native approach mirrors the Unix philosophy, updating it
for the modern world. for the modern world.
1. Micro-services are the equivalent of doing one thing well 1. Micro-services are the equivalent of doing one thing well
2. Ubiquitous APIs enable interoperatbility in the cloud-native world 2. Ubiquitous APIs enable interoperability in the cloud-native world
3. Releasing early, realeasing often, and failing quickly is important when 3. Releasing early, releasing often, and failing quickly is important when
failure is part of expected operations failure is part of expected operations
4. Automation is key, freeing up humans to make more useful use of their time 4. Automation is key, freeing up humans to make more useful use of their time
...@@ -54,7 +54,7 @@ charge. ...@@ -54,7 +54,7 @@ charge.
Prometheus is a project of convicted and passionate individuals. As we do not Prometheus is a project of convicted and passionate individuals. As we do not
have a profit motive, nor quarterly projections, or any other requirement to have a profit motive, nor quarterly projections, or any other requirement to
meet arbitrary business requirements, we can foxus on getting things right. This meet arbitrary business requirements, we can focus on getting things right. This
also means that we are free to suggest other implementations and projects if also means that we are free to suggest other implementations and projects if
they are a better fit for a particular use-case. they are a better fit for a particular use-case.
...@@ -66,4 +66,4 @@ will always strive to be welcoming to everyone. ...@@ -66,4 +66,4 @@ will always strive to be welcoming to everyone.
As an example of this, many of us are investing their personal time helping As an example of this, many of us are investing their personal time helping
individuals or communities by educating and helping them to be more productive individuals or communities by educating and helping them to be more productive
in the tech sector, as well as sponsoring diversity efforts, for example paying in the tech sector, as well as sponsoring diversity efforts, for example paying
for travel and accomodation at [PromCon](https://promcon.io). for travel and accommodation at [PromCon](https://promcon.io).
...@@ -3,7 +3,7 @@ title: Philosophy overview ...@@ -3,7 +3,7 @@ title: Philosophy overview
sort_rank: 1 sort_rank: 1
--- ---
We have structured our considerations for developing and working with Promethues We have structured our considerations for developing and working with Prometheus
into four groups in decreasing order of importance, and likelihood to change. into four groups in decreasing order of importance, and likelihood to change.
1. Philosophy 1. Philosophy
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment