README.md

DEPRECATED: Weave Scope - Troubleshooting & Monitoring for Docker & Kubernetes

PLEASE NOTE, THIS PROJECT IS NO LONGER MAINTAINED. More details available here.

Weave Scope automatically generates a map of your application, enabling you to intuitively understand, monitor, and control your containerized, microservices-based application.

Understand your Docker containers in real time

Choose an overview of your container infrastructure, or focus on a specific microservice. Easily identify and correct issues to ensure the stability and performance of your containerized applications.

Contextual details and deep linking

View contextual metrics, tags, and metadata for your containers. Effortlessly navigate between processes inside your container to hosts your containers run on, arranged in expandable, sortable tables. Easily find the container using the most CPU or memory for a given host or service.

Interact with and manage containers

Interact with your containers directly: pause, restart, and stop containers. Launch a command line. All without leaving the scope browser window.

Extend and customize via plugins

Add custom details or interactions for your hosts, containers, and/or processes by creating Scope plugins. Or, just choose from some that others have already written at the GitHub Weaveworks Scope Plugins organization.

Who is using Scope in production

• Apester
• Deepfence in ThreatMapper and ThreatStryker
• MayaData in MayaOnline / MayaOnPrem
• Weaveworks in Weave Cloud

If you would like to see your name added, let us know on Slack, or send a PR please.

Getting Started

Ensure your computer is behind a firewall that blocks port 4040 then,

sudo curl -L git.io/scope -o /usr/local/bin/scope
sudo chmod a+x /usr/local/bin/scope
scope launch

This script downloads and runs a recent Scope image from Docker Hub. Now, open your web browser to http://localhost:4040.

For instructions on installing Scope on Kubernetes, DCOS, or ECS, see the docs.

Reach Out

We are a very friendly community and love questions, help and feedback.

If you have any questions, feedback, or problems with Scope:

• Docs
  • Read the Weave Scope docs
  • Check out the frequently asked questions
  • Learn more about how the Scope community operates
• Join the discussion
  • Invite yourself to the Weave community Slack
  • Ask a question on the #scope Slack channel
  • Send an email to Scope community group
• Meetings and events
  • Join the Weave User Group and get invited to online talks, hands-on training and meetups in your area
  • Join (and read up on) the regular Scope community meetings - currently on hold.
• Contributing
  • Find out how to contribute to Scope
  • File an issue or make a pull request for one of our good first issues

Your feedback is always welcome!

We follow the CNCF Code of Conduct.

License

Scope is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.
Find more details about the licenses of vendored code in VENDORED_CODE.md.