https://github.com/rcrane/TEEMon
TEEMon: A continuous performance monitoring framework for TEEs
https://github.com/rcrane/TEEMon
monitoring sgx trusted-execution-environment
Last synced: 7 months ago
JSON representation
TEEMon: A continuous performance monitoring framework for TEEs
- Host: GitHub
- URL: https://github.com/rcrane/TEEMon
- Owner: rcrane
- License: agpl-3.0
- Created: 2020-12-17T18:23:01.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-03-02T07:24:44.000Z (over 4 years ago)
- Last Synced: 2024-08-03T01:25:01.652Z (over 1 year ago)
- Topics: monitoring, sgx, trusted-execution-environment
- Language: Go
- Homepage: https://sconedocs.github.io/teemon/
- Size: 1.51 MB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-SGX-Open-Source - https://github.com/rcrane/TEEMon
README
# TeeMon
This repo contains the software for the paper "TEEMon: A continuous performance monitoring framework for TEEs"
https://dl.acm.org/doi/10.1145/3423211.3425677
## HowTo ##
* TeeMon requires the linux kernel to be of version 4.15.0-99 or newer.
* Install dependencies: `docker-compose, docker.io, and linux-headers`
* Check if `/usr/src/linux-headers-$(uname -r)/include/uapi/linux/bpf_perf_event.h` is available on the host.
* Adapt user: `sudo adduser XXX docker`. Log out, log in.
* *Install the monitoring SGX driver*:
* `curl -fsSL https://raw.githubusercontent.com/scontain/SH/master/install_sgx_driver.sh | bash -s - install --force -p metrics `
* Run: `./start.sh`
* Check running containers: `docker ps` should contain "prometheus, grafana, sgx-exporter, node-exporter, ebpf-exporter, cadvisor"
* Open: `http://localhost:9091`
## Remarks ##
* To adjust the dashboard open `http://localhost/login:9091` and login with `admin` and `adminadmin`
* Directly persisting your changes is not yet supported. Grafana will tell you to use the clipboard.
* You need to paste your changes into `grafana/provisioning/dashboards/*` and restart TeeMon
### SGX Dashboard ###
* On the SGX-Dashboard you need no use the "command filter" (top-left), eg. `*.redis.*` (regex) to show data in some of the graphs (eg. `Number of syscall_enter`).
* Be careful not to use `.*`. It will overload your browser!
* The `ebpf_exporter` curently tracks all processes.
* The "command filter" works on the first 16 characters of the process' command (similar to what `top` shows).