• Stars
    star
    7,708
  • Rank 4,946 (Top 0.1 %)
  • Language
    C++
  • License
    Other
  • Created almost 11 years ago
  • Updated 4 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Linux system exploration and troubleshooting tool with first class support for containers

sysdig

CI Build GitHub release (latest SemVer)

Dig Deeper


Sysdig is a universal system visibility tool with native support for containers:
~$ sysdig

Csysdig is a simple, intuitive, and fully customizable curses UI for sysdig:
~$ csysdig

Getting Started

Run Sysdig in a container:

sudo docker run --rm -i -t --privileged --net=host \
    -v /var/run/docker.sock:/host/var/run/docker.sock \
    -v /dev:/host/dev \
    -v /proc:/host/proc:ro \
    -v /boot:/host/boot:ro \
    -v /src:/src \
    -v /lib/modules:/host/lib/modules:ro \
    -v /usr:/host/usr:ro \
    -v /etc:/host/etc:ro \
    docker.io/sysdig/sysdig

And then run the sysdig or csysdig tool from the container shell!

Or install the latest release with a deb or rpm package for your distribution.

What does sysdig do and why should I use it?

Sysdig is a simple tool for deep system visibility, with native support for containers.

The best way to understand sysdig is to try it - its super easy! Or here's a quick video introduction to csysdig, the simple, intuitive, and fully customizable curses-based UI for sysdig: https://www.youtube.com/watch?v=UJ4wVrbP-Q8

Far too often, system-level monitoring and troubleshooting still involves logging into a machine with SSH and using a plethora of dated tools with very inconsistent interfaces. And many of these classic Linux tools breakdown completely in containerized environments. Sysdig unites your Linux toolkit into a single, consistent, easy-to-use interface. And sysdig's unique architecture allows deep inspection into containers, right out of the box, without having to instrument the containers themselves in any way.

Sysdig instruments your physical and virtual machines at the OS level by installing into the Linux kernel and capturing system calls and other OS events. Sysdig also makes it possible to create trace files for system activity, similarly to what you can do for networks with tools like tcpdump and Wireshark. This way, problems can be analyzed at a later time, without losing important information. Rich system state is stored in the trace files, so that the captured activity can be put into full context.

Think about sysdig as strace + tcpdump + htop + iftop + lsof + ...awesome sauce.

Documentation / Support

Visit the wiki for full documentation on sysdig and its APIs.

For support using sysdig, please contact the official mailing list.

Join the Community

  • Contact the official mailing list for support and to talk with other users
  • Follow us on Twitter
  • This is our blog. There are many like it, but this one is ours.
  • Join our Public Slack channel for sysdig announcements and discussions.

Our code of conduct applies across all our projects and community places.

License Terms

The sysdig userspace programs and supporting code are licensed to you under the Apache 2.0 open source license.

Developer Certification of Origin (DCO)

The Apache 2.0 license tells you what rights you have that are provided by the copyright holder. It is important that the contributor fully understands what rights they are licensing and agrees to them. Sometimes the copyright holder isn't the contributor, such as when the contributor is doing work on behalf of a company.

To make a good faith effort to ensure these criteria are met, we require the Developer Certificate of Origin (DCO) process to be followed.

The DCO is an attestation attached to every contribution made by every developer. In the commit message of the contribution, the developer simply adds a Signed-off-by statement and thereby agrees to the DCO, which you can find at http://developercertificate.org.

DCO Sign-Off Methods

The DCO requires a sign-off message in the following format appear on each commit in the pull request:

Signed-off-by: John Doe <[email protected]>

You have to use your real name (sorry, no pseudonyms or anonymous contributions).

The DCO text can either be manually added to your commit body, or you can add either -s or --signoff to your usual git commit commands. If you are using the GitHub UI to make a change, you can add the sign-off message directly to the commit message when creating the pull request. If you forget to add the sign-off you can also amend a previous commit with the sign-off by running git commit --amend -s. If you've pushed your changes to GitHub already you'll need to force push your branch after this with git push -f.

Commercial Support

Interested in a fully supported, fully distributed version of sysdig? Check out Sysdig Monitor!

Open source sysdig is proudly supported by Sysdig Inc.

Interested in what we're doing? Sysdig is hiring.

Reporting a vulnerability

Please refer to SECURITY.md.

More Repositories

1

sysdig-inspect

Sysdig Inspect - A powerful opensource interface for container troubleshooting and security investigation
JavaScript
959
star
2

sysdig-container-ecosystem

The Container Ecosystem Project
109
star
3

sysdig-cloud-scripts

This repository holds various scripts and templates that may be helpful for deploying and utilizing Sysdig Cloud
Shell
79
star
4

kubernetes-scheduler

Kubernetes custom scheduler based on Sysdig monitoring metrics
Go
51
star
5

grafana-sysdig-datasource

Sysdig datasource plugin for Grafana (https://grafana.com/)
JavaScript
36
star
6

tracers-py

Python library to easy emit Sysdig tracers
Python
23
star
7

ember-typescript2

Drop-in Ember CLI addon for TypeScript 2.3+ (experimental)
JavaScript
17
star
8

sysdig-workshop-forensics

Shell
17
star
9

sysdig-labs

Sysdig labs
Go
13
star
10

kubernetes-sysdig-metrics-apiserver

Kubernetes Custom Metrics Adapter for Sysdig
Go
11
star
11

sysdig-kube-watcher

python scripts to bridge the kubernetes API and sysdig cloud
Python
9
star
12

onprem-install-docs

9
star
13

sysdig-cloud-api

Sysdig Cloud API
CSS
8
star
14

sysdig-workshop-troubleshooting

Shell
8
star
15

sysdig-workshop-infra

Ruby
7
star
16

terraform-aws-secure-for-cloud

Terraform module for sysdig secure
HCL
7
star
17

action-helm-tools

Shell
6
star
18

falco_tor_rule_creator

Python
6
star
19

probe-builder

Python
5
star
20

sysdig-gcscc-connector

Sysdig connector for Google Cloud Security Command Center
Python
5
star
21

bashbot-scripts

Shell
4
star
22

sysdig-partner-resources

Repository for all of our public-facing Sysdig partner stuff.
4
star
23

instruqt-assets

Shell
3
star
24

infra-action-helm-ci

Helm artifact CI - a la Sysdig way
2
star
25

sysdig-google-kubernetes-marketplace

Sysdig packaging for Google Kubernetes Marketplace
Makefile
2
star
26

infra-action-mark2confluence

Render and push markdown files to confluence pages
Python
2
star
27

infra-action-harness-deploy

Repository containing github action to execute a Harness Trigger
1
star
28

infra-action-sysdig-scan

Github action to use Sysdig scanner
1
star
29

python-sdc-client-beta

Sysdig Cloud python client library (beta preview)
Python
1
star
30

infra-action-patch-upstream

1
star
31

infra-action-scanning-summary

Github action to create a job summary report
JavaScript
1
star
32

infra-action-test-runner

1
star
33

infra-action-buildnpush

Build and Push container images to artifactory and quay - a la Sysdig way
1
star