https://github.com/aquasecurity/Tracee

Linux Runtime Security and Forensics using eBPF
https://github.com/aquasecurity/Tracee

bpf docker ebpf golang kubernetes linux runtime-security security

Last synced: about 2 months ago
JSON representation

Linux Runtime Security and Forensics using eBPF

• Host: GitHub
• URL: https://github.com/aquasecurity/Tracee
• Owner: aquasecurity
• License: apache-2.0
• Created: 2019-09-18T13:20:17.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-05-22T10:35:52.000Z (7 months ago)
• Last Synced: 2024-05-22T10:44:40.252Z (7 months ago)
• Topics: bpf, docker, ebpf, golang, kubernetes, linux, runtime-security, security
• Language: Go
• Homepage: https://aquasecurity.github.io/tracee/latest
• Size: 137 MB
• Stars: 3,296
• Watchers: 52
• Forks: 388
• Open Issues: 203
• Metadata Files:
  • Readme: Readme.md
  • Contributing: docs/contributing/building/building.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
![Tracee Logo](docs/images/tracee.png)

[installation]:https://aquasecurity.github.io/tracee/latest/docs/install/

[docker-guide]:https://aquasecurity.github.io/tracee/latest/docs/install/docker/

[kubernetes-guide]:https://aquasecurity.github.io/tracee/latest/docs/install/kubernetes/

[prereqs]:https://aquasecurity.github.io/tracee/latest/docs/install/prerequisites/

[macfaq]:https://aquasecurity.github.io/tracee/latest/docs/advanced/mac/

Before moving on, please consider giving us a GitHub star ⭐️. Thank you!

## About Tracee

Tracee is a runtime security and observability tool that helps you understand how your system and applications behave.  

It is using [eBPF technology](https://ebpf.io/what-is-ebpf/) to tap into your system and expose that information as events that you can consume.  

Events range from factual system activity events to sophisticated security events that detect suspicious behavioral patterns.

To learn more about Tracee, check out the [documentation](https://aquasecurity.github.io/tracee/).

## Quickstart

To quickly try Tracee use one of the following snippets. For a more complete installation guide, check out the [Installation section][installation].  

Tracee should run on most common Linux distributions and kernels. For compatibility information see the [Prerequisites][prereqs] page.  Mac users, please read [this FAQ][macfaq].

### Using Docker

```shell

docker run --name tracee -it --rm \

  --pid=host --cgroupns=host --privileged \

  -v /etc/os-release:/etc/os-release-host:ro \

  -v /var/run:/var/run:ro \

  aquasec/tracee:latest

```

For a complete walkthrough please see the [Docker getting started guide][docker-guide].

### On Kubernetes

```shell

helm repo add aqua https://aquasecurity.github.io/helm-charts/

helm repo update

helm install tracee aqua/tracee --namespace tracee --create-namespace

```

```shell

kubectl logs --follow --namespace tracee daemonset/tracee

```

For a complete walkthrough please see the [Kubernetes getting started guide][kubernetes-guide].

## Contributing

  

Join the community, and talk to us about any matter in the [GitHub Discussions](https://github.com/aquasecurity/tracee/discussions) or [Slack](https://slack.aquasec.com).  

If you run into any trouble using Tracee or you would like to give use user feedback, please [create an issue.](https://github.com/aquasecurity/tracee/issues)

Find more information on [contribution documentation](https://aquasecurity.github.io/tracee/latest/contributing/overview/).

## More about Aqua Security

Tracee is an [Aqua Security](https://aquasec.com) open source project.  

Learn about our open source work and portfolio [here](https://www.aquasec.com/products/open-source-projects/).