Skip to content

Update README to avoid referring to fork #44

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jml merged 3 commits into from
Oct 10, 2016
Merged

Update README to avoid referring to fork #44

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ded7068
Don't need the fork any more
jml Oct 10, 2016
d42396e
Update for 1.2.1
jml Oct 10, 2016
c11d840
More updates
jml Oct 10, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 15 additions & 14 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,26 +21,27 @@ a new instance.

Once you have created your instance, note down the 'Service Token' listed
underneath 'Probes' in the box on the right of the screen. You will use this
token to authenticate your retrieval agent with Weave Cloud.
token to authenticate your local Prometheus with Weave Cloud.

The retrieval agent is (mostly) a normal Prometheus instance. To get it, you
can either build it from source in the
[frankenstein branch of Prometheus](https://github.com/tomwilkie/prometheus/tree/frankenstein)
or
[download a Linux amd64 binary](https://drive.google.com/open?id=0BwqTw528sZRIWlZNS1RFTFVBcmc).
You can [download Prometheus its website](https://prometheus.io/download/).
You will need v1.2.1 or later.

Once you've got the retrieval agent, you will need to provide a standard
[Prometheus config file](https://prometheus.io/docs/operating/configuration/)
so it can discover your services and relabel them appropriately, and then run
the following:
When you've got Prometheus, you will need
to
[configure it discover your services](https://prometheus.io/docs/operating/configuration/) and
also configure it to send its data to Weave Cloud by adding the following
top-level stanza:

prometheus -config.file=... -storage.remote.generic-url=http://user:<token>@cloud.weave.works/api/prom/push
remote_write:
url: https://cloud.weave.works/api/prom/push
basic_auth:
password: <token>

Where `<token>` is the Service Token you obtained from Weave Cloud.

Once you have started your retrieval agent you can enter Prometheus queries
into Weave Cloud. Go to https://cloud.weave.works and click the graph icon to
the right of the instance selector:
Once your local Prometheus is running you can enter Prometheus queries into
Weave Cloud. Go to https://cloud.weave.works and click the graph icon to the
right of the instance selector:

![Cropped screenshot of Weave Cloud showing Prometheus button as graph](weave-cloud-snippet.png?raw=true)

Expand Down