{"id":24079940,"url":"https://github.com/amrabed/strace-docker","last_synced_at":"2026-03-08T17:33:04.606Z","repository":{"id":25389717,"uuid":"28818249","full_name":"amrabed/strace-docker","owner":"amrabed","description":"Trace system calls from Docker containers running on the system","archived":false,"fork":false,"pushed_at":"2023-04-27T22:58:21.000Z","size":24,"stargazers_count":32,"open_issues_count":3,"forks_count":5,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-30T17:04:19.110Z","etag":null,"topics":["docker","shell","sysdig"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amrabed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-05T15:26:03.000Z","updated_at":"2025-01-31T20:50:29.000Z","dependencies_parsed_at":"2022-08-23T06:30:30.022Z","dependency_job_id":null,"html_url":"https://github.com/amrabed/strace-docker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrabed%2Fstrace-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrabed%2Fstrace-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrabed%2Fstrace-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrabed%2Fstrace-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amrabed","download_url":"https://codeload.github.com/amrabed/strace-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251722799,"owners_count":21633016,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","shell","sysdig"],"created_at":"2025-01-09T22:39:59.856Z","updated_at":"2026-03-08T17:33:04.572Z","avatar_url":"https://github.com/amrabed.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/amrabed/strace-docker.svg?branch=master)](https://travis-ci.org/amrabed/strace-docker)\n[![GitHub issues](https://img.shields.io/github/issues/amrabed/strace-docker.svg)](https://github.com/amrabed/strace-docker/issues)\n[![GitHub (pre-)release](https://img.shields.io/github/release/amrabed/strace-docker/all.svg)](https://github.com/amrabed/strace-docker/releases)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n# strace-docker\nTrace system calls from Docker containers running on the system\u003ca href=\"#footnote\" id=\"ref\"\u003e\u003csup\u003e*\u003c/sup\u003e\u003c/a\u003e\n\n\n## Usage\n### Install\n    git clone https://github.com/amrabed/strace-docker \u0026\u0026 sudo ./strace-docker/install\n    \nTo check if `strace-docker` is successfully installed and running, use `service strace-docker status`\n\n### Tracing\n`strace-docker` is automatically triggered by [`docker events`](https://docs.docker.com/engine/reference/commandline/events) to monitor any new Docker container. The resulting trace of system calls is written to a new file at `/var/log/strace-docker/`. File name will be `$id-$image-$timestamp` where `$id` is the container ID, `$image` is the container image, and `$timestamp` is the time the container started. You can see full log of monitored containers at `/var/log/strace-docker/log`.\n\n[![How to use the strace-docker tool](https://img.youtube.com/vi/iWywV_4Y34E/0.jpg)](https://www.youtube.com/watch?v=iWywV_4Y34E)\n\n\n## Known Issues\n- `strace-docker` does not currently stop tracing process automatically when container is stopped.\n- `strace-docker` does not resume tracing to the same file on container restart.\n- `strace-docker` relies internally on [`Sysdig`](https://sysdig.com) which limits the number of monitoring processes to 5 by default. Due to `strace-docker` not killing/stopping monitoring processes automatically, `strace-docker` stops montioring new containers when 5 containrs are currently monitored. The user then needs to manually stop any `strace-docker` processes that are no longer needed (i.e., whose containers are not running anymore).\n\nAll contributions are welcome :)\n\n\n\u003ca id=\"footnote\" href=\"#ref\"\u003e\u003csup\u003e*\u003c/sup\u003e\u003c/a\u003e Implemented as part of my Ph.D. dissertation research. See [this paper](https://arxiv.org/abs/1611.03056) for more details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famrabed%2Fstrace-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famrabed%2Fstrace-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famrabed%2Fstrace-docker/lists"}