Commit b882eb2c authored by Julius Volz's avatar Julius Volz

Update installation and wording in "Getting started".

parent 6c1438ec
...@@ -21,28 +21,23 @@ git clone https://github.com/prometheus/prometheus.git ...@@ -21,28 +21,23 @@ git clone https://github.com/prometheus/prometheus.git
## Building Prometheus ## Building Prometheus
Building Prometheus currently still requires a `make` step, as some parts of [Download the latest release](https://github.com/prometheus/prometheus/releases)
the source are autogenerated (web assets). of Prometheus for your platform, then extract and run it:
```language-bash ```
cd prometheus tar xvfz prometheus-*.tar.gz
make build ./prometheus
``` ```
Note that building requires a fair amount of memory. You should have It should fail to start, complaining about the absence of a configuration file.
at least 2GiB of RAM available.
If you encounter problems building Prometheus, see [the more detailed build
instructions](https://github.com/prometheus/prometheus#use-make) in the
README.md.
## Configuring Prometheus to monitor itself ## Configuring Prometheus to monitor itself
Prometheus collects metrics from monitored targets by scraping metrics HTTP Prometheus collects metrics from monitored targets by scraping metrics HTTP
endpoints on these targets. Since Prometheus also exposes data in the same endpoints on these targets. Since Prometheus also exposes data in the same
manner about itself, it may also be used to scrape and monitor its own health. manner about itself, it can also scrape and monitor its own health.
While a Prometheus server which collects only data about itself is not very While a Prometheus server that collects only data about itself is not very
useful in practice, it is a good starting example. Save the following basic useful in practice, it is a good starting example. Save the following basic
Prometheus configuration as a file named `prometheus.yml`: Prometheus configuration as a file named `prometheus.yml`:
...@@ -56,7 +51,7 @@ global: ...@@ -56,7 +51,7 @@ global:
labels: labels:
monitor: 'codelab-monitor' monitor: 'codelab-monitor'
# A scrape configuration containing exactly one endpoint to scrape: # A scrape configuration containing exactly one endpoint to scrape:
# Here it's Prometheus itself. # Here it's Prometheus itself.
scrape_configs: scrape_configs:
# The job name is added as a label `job=<job_name>` to any timeseries scraped from this config. # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
...@@ -86,11 +81,11 @@ Prometheus build directory and run: ...@@ -86,11 +81,11 @@ Prometheus build directory and run:
``` ```
Prometheus should start up and it should show a status page about itself at Prometheus should start up and it should show a status page about itself at
http://localhost:9090. Give it a couple of seconds to start collecting data http://localhost:9090. Give it a couple of seconds to collect data about itself
about itself from its own HTTP metrics endpoint. from its own HTTP metrics endpoint.
You can also verify that Prometheus is serving metrics about itself by You can also verify that Prometheus is serving metrics about itself by
navigating to its metrics exposure endpoint: http://localhost:9090/metrics navigating to its metrics endpoint: http://localhost:9090/metrics
By default, Prometheus will only execute at most one OS thread at a By default, Prometheus will only execute at most one OS thread at a
time. In production scenarios on multi-CPU machines, you will most time. In production scenarios on multi-CPU machines, you will most
...@@ -140,7 +135,7 @@ To count the number of returned time series, you could write: ...@@ -140,7 +135,7 @@ To count the number of returned time series, you could write:
count(prometheus_target_interval_length_seconds) count(prometheus_target_interval_length_seconds)
``` ```
For further details about the expression language, see the For more about the expression language, see the
[expression language documentation](/docs/querying/basics/). [expression language documentation](/docs/querying/basics/).
## Using the graphing interface ## Using the graphing interface
......
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