Skip to content

cilium/tetragon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

aa04216 Β· Feb 27, 2025
Feb 13, 2025
Jan 9, 2025
Feb 27, 2025
Dec 20, 2024
Jan 9, 2025
Dec 13, 2024
Nov 11, 2024
Dec 13, 2024
Dec 2, 2024
Feb 27, 2025
Feb 29, 2024
Nov 25, 2024
Nov 12, 2024
Jan 9, 2025
Aug 16, 2024
Aug 10, 2022
Apr 25, 2024
Jun 27, 2024
Nov 11, 2024
Dec 22, 2022
Jul 26, 2023
Feb 21, 2025
Aug 16, 2024
Aug 16, 2024
Feb 13, 2025
Feb 21, 2025
Feb 21, 2025
Jul 11, 2024
Feb 13, 2025
May 20, 2022
Mar 3, 2023
Dec 12, 2024
Feb 13, 2025
Jul 16, 2024
Aug 5, 2024
May 13, 2022
Aug 17, 2022
Jan 9, 2025
Jan 9, 2025
Jul 23, 2024

Repository files navigation

License License License


Cilium’s new Tetragon component enables powerful real-time, eBPF-based Security Observability and Runtime Enforcement.

Tetragon detects and is able to react to security-significant events, such as

  • Process execution events
  • System call activity
  • I/O activity including network & file access

When used in a Kubernetes environment, Tetragon is Kubernetes-aware - that is, it understands Kubernetes identities such as namespaces, pods and so on - so that security event detection can be configured in relation to individual workloads.

Tetragon Overview Diagram

See more about how Tetragon is using eBPF.

Getting started

Refer to the official documentation of Tetragon.

To get started with Tetragon, take a look at the getting started guides to:

Tetragon is able to observe critical hooks in the kernel through its sensors and generates events enriched with Linux and Kubernetes metadata:

  1. Process lifecycle: generating process_exec and process_exit events by default, enabling full process lifecycle observability. Learn more about these events on the process lifecycle use case page.
  2. Generic tracing: generating process_kprobe, process_tracepoint and process_uprobe events for more advanced and custom use cases. Learn more about these events on the TracingPolicy concept page and discover multiple use cases like:

See further resources:

Join the community

Join the Tetragon πŸ’¬ Slack channel and the πŸ“… Community Call to chat with developers, maintainers, and other users. This is a good first stop to ask questions and share your experiences.

How to Contribute

For getting started with local development, you can refer to the Contribution Guide. If you plan to submit a PR, please "sign-off" your commits.