Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time
Sep 13, 2021
Aug 20, 2021
Aug 20, 2021
Sep 13, 2021
Feb 26, 2021
Aug 20, 2021
Sep 13, 2021
Sep 13, 2021

GitHub license Slack Invite Slack Channel Weekly minutes Go Report Card CII Best Practices StackShare PyPI


Skydive is an open source real-time network topology and protocols analyzer. It aims to provide a comprehensive way of understanding what is happening in the network infrastructure.

Skydive agents collect topology information and flows and forward them to a central agent for further analysis. All the information is stored in an Elasticsearch database.

Skydive is SDN-agnostic but provides SDN drivers in order to enhance the topology and flows information.

Key features

  • Captures network topology and flows
  • Full history of network topology and flows
  • Distributed
  • Ability to follow a flow along a path in the topology
  • Supports VMs and Containers infrastructure
  • Unified query language for topology and flows (Gremlin)
  • Web and command line interfaces
  • Easy to deploy (standalone executable)
  • Connectors to OpenStack, Docker, OpenContrail, Kubernetes

Quick start


The easiest way to get started is to download the latest binary and to run it using the all-in-one mode :

curl -Lo - | gzip -d > skydive && chmod +x skydive && sudo mv skydive /usr/local/bin/

SKYDIVE_ETCD_DATA_DIR=/tmp SKYDIVE_ANALYZER_LISTEN= sudo -E /usr/local/bin/skydive allinone

Open a browser to http://localhost:8082 to access the analyzer Web UI.


If you are using Kubernetes then you can deploy skydive using helm directly from Git:

helm plugin install --version 0.10.0
helm repo add skydive git+
helm repo update
helm install skydive-analyzer skydive/skydive-analyzer
helm install skydive-agent skydive/skydive-agent
kubectl port-forward service/skydive-analyzer 8082:8082

Open a browser to http://localhost:8082 to access the analyzer Web UI.


docker run -d --privileged --pid=host --net=host -p 8082:8082 -p 8081:8081 \
    -v /var/run/docker.sock:/var/run/docker.sock -v /run/netns:/var/run/netns \
    skydive/skydive allinone

Open a browser to http://localhost:8082 to access the analyzer Web UI.

Docker Compose

To quick set up a more complete working environment (with history support), Docker Compose can be used to automatically start an Elasticsearch container, a Skydive analyzer container and a Skydive agent container.

curl -o docker-compose.yml
docker-compose up

You can also use the Skydive command line client with:

docker run --net=host -ti skydive/skydive client query "g.V()"

Open a browser to http://localhost:8082 to access the analyzer Web UI.


Skydive documentation can be found here:

The Skydive REST API is described using swagger here.


Skydive tutorials can be found here:

Get involved


Your contributions are more than welcome. Please check to know about the process.


This software is licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.