Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leodido/falco-diagrams
Diagrams to visually learn Falco and its eBPF probe
https://github.com/leodido/falco-diagrams
diagrams docs ebpf falco images mermaid
Last synced: 23 days ago
JSON representation
Diagrams to visually learn Falco and its eBPF probe
- Host: GitHub
- URL: https://github.com/leodido/falco-diagrams
- Owner: leodido
- Created: 2020-07-22T17:50:59.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-06-24T17:35:26.000Z (over 3 years ago)
- Last Synced: 2024-08-04T21:07:12.051Z (3 months ago)
- Topics: diagrams, docs, ebpf, falco, images, mermaid
- Language: HTML
- Homepage:
- Size: 3.36 MB
- Stars: 12
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-falco - Falco Diagrams: Visually learn Falco and its eBPF probe
README
# falco-diagrams
> Diagrams to **visually** explain [Falco](https://github.com/falcosecurity/falco)
Diagrams are done with [Mermaid](https://mermaid-js.github.io).
Since I believe a picture is worth a thousand words, even more when trying to explain complicated stuff as Falco and its eBPF driver are... Here we are!
This repo also provides tooling for automating the making of these diagrams:
a GiHub action to automatically **generate, commit, and push Falco diagrams** to the `output/` directory.
But since I didn't like so much the quality of the resulting diagram images, I created a **simple** in-place mermaid **editor** that you can use to:
1. **draw** diagrams with a **custom Falco theme**
2. **download** them as **PNG** images with a good resolutionI've already created some of them for my [talks](https://youtube.com/playlist?list=PL-YnLgW35W60wX9lhu6-a8ln4I9yfT1ug) and [decks](https://github.com/leodido/presentations) in the past, so you can find them in the [`themed/`](./themed) directory. Enjoy them!
**Disclaimer**: it's possible that you'll find some of these diagrams and illustrations (and many others) in the upcoming [Falco Cookbook](https://gum.co/falco). Grab it until it's hot!
## Contribute a diagram
It's simple!
Just create a `.md` file containing some Mermaid syntax in the `input/` directory. Something like:
```mermaid
sequenceDiagram
autonumber
falco->>sinsp: new()
sinsp-->>falco: inspector
falco->>sinsp: open()
Note over sinsp: open_live_common(..., SCAP_MODE_LIVE)
sinsp->>scap: scap_open()
Note over scap: REF: SCAP OPEN
scap-->>sinsp: scap_t
sinsp->>sinsp: init
sinsp-->>falco: void
```This repo's tooling will do the rest for you and you'll obtain in a minute the resulting diagram in the `output/` directory.
Notice that also the input file will be edited by the tooling by inserting into it the diagram image just generated.
## TODOs
- [ ] Make the in-place editor work also on other browsers other than Google Chrome
- [ ] Create a real in-place editor with a text-area or similar
- At the moment, you need to copy the diagram source in the HTML and re-open it
- [ ] Publish the editor
- [ ] Fix the GitHub action compiling the Mermaid diagrams
- Sizing of the resulting image---
[![Analytics](https://ga-beacon.appspot.com/UA-49657176-1/falco-diagrams?flat)](https://github.com/igrigorik/ga-beacon)