github/weave-scope
1
0
Fork 0
mirror of https://github.com/weaveworks/scope.git synced 2026-03-03 10:11:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

Move scope.md to main README. Updates, also.

Browse Source
This commit is contained in:
Peter Bourgon
2015-10-19 18:26:29 +02:00
parent f87e51f849
commit 5ac8ce5622
2 changed files with 115 additions and 139 deletions
Download Patch File Download Diff File Expand all files Collapse all files

118
README.md
View File

@@ -25,7 +25,119 @@ Now, open your web browser to **http://localhost:4040**. (If you're using
boot2docker, replace localhost with the output of `boot2docker ip`.)
## Build
## Requirements
Scope does not need any configuration and does not require the Weave Network.
But Scope does need to be running on every machine you want to monitor.
## Architecture
Weave Scope consists of two components: the app and the probe. These two
components are deployed as a single Docker container using the `scope`
script.
The probe is responsible for gathering information about the host is it running
on. This information is sent to the app in the form of a report. The app is
responsible for processing reports from the probe into usable topologies,
serving the UI, and pushing these topologies to the UI.
```
+--Docker host----------+
| +--Container------+ | .---------------.
| | | | | Browser |
| | +-----------+ | | |---------------|
| | | scope-app |<---------| |
| | +-----------+ | | | |
| | ^ | | | |
| | | | | '---------------'
| | +-------------+ | |
| | | scope-probe | | |
| | +-------------+ | |
| | | |
| +-----------------+ |
+------------------------+
```
## Multi host setup
When running Scope in a cluster, each probe sends reports to each app.
The App merges the reports from each probe into a more complete report.
You need to run Scope on every machine you want to monitor.
```
+--Docker host----------+ +--Docker host----------+
| +--Container------+ | | +--Container------+ |
| | | | | | | |
| | +-----------+ | | | | +-----------+ | |
| | | scope-app |<-----. .----->| scope-app | | |
| | +-----------+ | | \ / | | +-----------+ | |
| | ^ | | \/ | | ^ | |
| | | | | /\ | | | | |
| | +-------------+ | | / \ | | +-------------+ | |
| | | scope-probe |-----' '-----| scope-probe | | |
| | +-------------+ | | | | +-------------+ | |
| | | | | | | |
| +-----------------+ | | +-----------------+ |
+-----------------------+ +-----------------------+
```
If you run Scope on the same machine as the Weave Network, the probe will use
weaveDNS to automatically discover other apps on your network. Scope acheives
this by registering itself under the address **scope.weave.local**. Each probe
will send reports to every app registered under this address. Therefore, if
you have a running weaveDNS setup, you do not need to take any further steps.
If you do not wish to use weaveDNS, you can instruct Scope to cluster with
other Scope instances on the command line. Hostnames and IP addresses are
acceptable, both with and without ports:
```
# weave launch scope1:4030 192.168.0.12 192.168.0.11:4030
```
Hostnames will be regularly resolved as A records, and each answer used as a
target.
## Using Scope Service
Scope can also be used to feed reports to the Scope Service. The Scope Service
allows you centrally manage and share access to your Scope UI. In this
configuration, you only run the probe locally; the apps are hosted for you.
To get an account on the Scope Service, sign up at [scope.weave.works][]. You
need to run a probe on every machine you want to monitor with Scope. To launch
a probe and send reports to the service, run the following command:
[scope.weave.works]: http://scope.weave.works
```
sudo scope launch --service-token=<token>
```
```
.-~~~-.
.- ~'` )_ ___
/ `-' )_
| scope.weave.works \
\ .'
~-______________..--'
^^
||
||
+--Docker host----------+ || +--Docker host----------+
| +--Container------+ | || | +--Container------+ |
| | | | || | | | |
| | +-------------+ | | / \ | | +-------------+ | |
| | | scope-probe |-----' '-----| scope-probe | | |
| | +-------------+ | | | | +-------------+ | |
| | | | | | | |
| +-----------------+ | | +-----------------+ |
+-----------------------+ +-----------------------+
```
## Developing
The build is in five stages. `make deps` installs some tools we use later in
the build. `make frontend` builds a UI build image with all NPM dependencies.
@@ -42,8 +154,8 @@ make backend
make
```
## Run
Then, run the local build via
```
./scope launch
```
```

136
docs/scope.md
View File

@@ -1,136 +0,0 @@
# Weave Scope
Weave Scope automatically generates a map of your containers, enabling you to
intuitively understand, monitor, and control your applications.
Scope does not need any configuration and does not require the Weave Network.
You need to run Scope on every machine you want to monitor.
## Architecture
Weave Scope consists of two components: the App and the Probe. These two
components are deployed as a single Docker container using the ```scope```
script:
```
sudo scope launch
```
The Probe is responsible for gathering information about the host is it running
on. This information is sent to the app in the form of a report. The App is
responsible for processing reports from the probe into useable topologies,
serving the UI and pushing these topologies to the UI.
```
+-------------------------------+ +-------------------------------+
| | | |
| Docker Host | | Your laptop |
| | | |
| +---------------------------+ | | +-----------------------+ |
| | | | | | | |
| | Weave Scope Container | | -------->| Your web browser | |
| | | | / | | | |
| | +-----------------------+ | | / | +-----------------------+ |
| | | | | | / | |
| | | Scope-app |<------- +-------------------------------+
| | | | | |
| | +------------+----------+ | |
| | ^ | |
| | | | |
| | +------------+----------+ | |
| | | | | |
| | | Scope-probe | | |
| | | | | |
| | +-----------------------+ | |
| | | |
| +---------------------------+ |
| |
+-------------------------------+
```
## Multi host setup
When running Scope in a cluster, each Probe sends reports to each App.
The App merges the reports from each probe into a more complete report.
You need to run Scope on every machine you want to monitor.
```
+-------------------------------+ +-------------------------------+
| | | |
| Docker Host 1 | | Docker Host 2 |
| | | |
| +---------------------------+ | | +---------------------------+ |
| | | | | | | |
| | Weave Scope Container | | | | Weave Scope Container | |
| | | | | | | |
| | +-----------------------+ | | | | +-----------------------+ | |
| | | | | | | | | | | |
| | | Scope-app |<------ ------>| Scope-app | | |
| | | | | | \ / | | | | | |
| | +------------+----------+ | | \ / | | +------------+----------+ | |
| | ^ | | \/ | | ^ | |
| | | | | /\ | | | | |
| | +------------+----------+ | | / \ | | +------------+----------+ | |
| | | | | | / \ | | | | | |
| | | Scope-probe +------- -------+ Scope-probe | | |
| | | | | | | | | | | |
| | +-----------------------+ | | | | +-----------------------+ | |
| | | | | | | |
| +---------------------------+ | | +---------------------------+ |
| | | |
+-------------------------------+ +-------------------------------+
```
If you run Scope on the same machine as the Weave Network, the Probe will use
WeaveDNS to automatically discover other Apps on your network. Scope acheives
this by registering itself under the address scope.weave.local; each Probe
will send reports to every App register for this address. Therefore, if
you have a running WeaveDNS setup, you do not need to take any further steps.
If you do not wish to use WeaveDNS, you can instruct Scope to cluster with
other Scope instances on the command line. Hostnames and IP addresses are
acceptable, both with and without ports:
```
# weave launch scope1:4030 192.168.0.12 192.168.0.11:4030
```
## Using Scope Service
Scope can also be used to feed reports to the Scope Service. The Scope
Service allows you centrally manage and share access to your Scope UI. In this
configuration, you only run the Probe locally - the Apps are hosted for you.
To get an account on the Scope Service, sign up at scope.weave.works. You need
to run a Probe on every machine you want to monitor with Scope. To launch a
Probe and send reports to the service, run the following command:
```
sudo scope launch --service-token=<service token>
```
```
+----------------------------+
| |
| scope.weave.works |
| |
+----------------------------+
/\
+-----------------------------+ || +-----------------------------+
| | || | |
| Docker Host | || | Docker Host |
| | || | |
| +-------------------------+ | || | +-------------------------+ |
| | | | || | | | |
| | Weave Scope Container | | || | | Weave Scope Container | |
| | | | || | | | |
| | +---------------------+ | | / \ | | +---------------------+ | |
| | | | | | / \ | | | | | |
| | | Scope-probe +--------- ---------+ Scope-probe | | |
| | | | | | | | | | | |
| | +---------------------+ | | | | +---------------------+ | |
| | | | | | | |
| +-------------------------+ | | +-------------------------+ |
| | | |
+-----------------------------+ +-----------------------------+
````