{"id":14248403,"url":"https://github.com/azat/chdig","last_synced_at":"2026-04-19T22:01:02.216Z","repository":{"id":65624903,"uuid":"592066633","full_name":"azat/chdig","owner":"azat","description":"Dig into ClickHouse with TUI interface.","archived":false,"fork":false,"pushed_at":"2026-04-16T10:24:45.000Z","size":1358,"stargazers_count":280,"open_issues_count":20,"forks_count":24,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-16T12:15:22.147Z","etag":null,"topics":["clickhouse"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/azat.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-01-22T20:16:59.000Z","updated_at":"2026-04-16T10:15:13.000Z","dependencies_parsed_at":"2026-04-02T18:05:21.867Z","dependency_job_id":null,"html_url":"https://github.com/azat/chdig","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/azat/chdig","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azat%2Fchdig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azat%2Fchdig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azat%2Fchdig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azat%2Fchdig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azat","download_url":"https://codeload.github.com/azat/chdig/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azat%2Fchdig/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32024251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["clickhouse"],"created_at":"2024-08-22T00:00:44.190Z","updated_at":"2026-04-19T22:01:02.171Z","avatar_url":"https://github.com/azat.png","language":"Rust","funding_links":[],"categories":["UIs","Table of Contents","\u003ca name=\"monitor\"\u003e\u003c/a\u003eSystem monitoring"],"sub_categories":["CLI"],"readme":"### chdig\n\nDig into [ClickHouse](https://github.com/ClickHouse/ClickHouse/) with TUI interface.\n\n### Installation\n\n`chdig` is also available as part of `clickhouse` - `clickhouse chdig`, but\nthat version may be slightly outdated.\n\nPre-built packages (`.deb`, `.rpm`, `archlinux`, `.tar.gz`) and standalone\nbinaries for `Linux` and `macOS` are available for both `x86_64` and `aarch64`\narchitectures.\n\nThe latest [unstable release can be found on GitHub](https://github.com/azat/chdig/releases/tag/latest).\n\n*See also the complete list of [releases](https://github.com/azat/chdig/releases).*\n\n\u003cdetails\u003e\n\n\u003csummary\u003ePackage repositories (AUR, Scoop, Homebrew)\u003c/summary\u003e\n\n#### archlinux user repository (aur)\n\nAnd also for archlinux there is an aur package:\n- [**chdig-latest-bin**](https://aur.archlinux.org/packages/chdig-latest-bin) - binary artifact of the upstream\n- [chdig-git](https://aur.archlinux.org/packages/chdig-git) - build from sources\n- [chdig-bin](https://aur.archlinux.org/packages/chdig-bin) - binary of the latest stable version\n\n*Note: `chdig-latest-bin` is recommended because it is latest available version and you don't need toolchain to compile*\n\n#### scoop (windows)\n\n```\nscoop bucket add extras\nscoop install extras/chdig\n```\n\n#### brew (macos)\n\n```\nbrew install chdig\n```\n\n\u003c/details\u003e\n\n### Demo\n\n[![asciicast](https://github.com/azat/chdig/releases/download/v26.1.1/chdig-v26.1.1.gif)](https://asciinema.org/a/OvQIBpQCAtFU8AyF)\n\n### Motivation\n\nThe idea is came from everyday digging into various ClickHouse issues.\n\nClickHouse has a approximately universe of introspection tools, and it is easy\nto forget some of them. At first I came with some\n[slides](https://azat.sh/presentations/2022-know-your-clickhouse/) and a\npicture (to attract your attention) by analogy to what [Brendan\nGregg](https://www.brendangregg.com/linuxperf.html) did for Linux:\n\n[![Know Your ClickHouse](https://azat.sh/presentations/2022-know-your-clickhouse/Know-Your-ClickHouse.png)](https://azat.sh/presentations/2022-know-your-clickhouse/Know-Your-ClickHouse.png)\n\n*Note, the picture and the presentation had been made in the beginning of 2022,\nso it may not include some new introspection tools*.\n\nBut this requires you to dig into lots of places, and even though during this\nprocess you will learn a lot, it does not solves the problem of forgetfulness.\nSo I came up with this simple TUI interface that tries to make this process\nsimpler.\n\n`chdig` can be used not only to debug some problems, but also just as a regular\nintrospection, like `top` for Linux.\n\n### Features\n\n- `top` like interface (or [`csysdig`](https://github.com/draios/sysdig) to be more precise)\n- [Flamegraphs](Documentation/FAQ.md#what-is-flamegraph) (CPU/Real/Memory/Live) in TUI (thanks to [flamelens](https://github.com/ys-l/flamelens))\n- [Perfetto support](Documentation/FAQ.md#what-is-perfetto-export)\n- Share flamegraphs (using [pastila.nl](https://pastila.nl/) and [speedscope](https://www.speedscope.app/))\n- Share logs via [pastila.nl](https://pastila.nl/)\n- Share query pipelines (using [viz.js](https://github.com/mdaines/viz-js) and [pastila.nl](https://pastila.nl/))\n- Cluster support (`--cluster`) - aggregate data from all hosts in the cluster\n- Historical support (`--history`) - includes rotated `system.*_log_*` tables\n- `clickhouse-client` compatibility (including `--connection`) for options and configuration files\n\nAnd there is a huge bunch of [ideas](https://github.com/azat/chdig/issues).\n\n**Note, this it is in a pre-alpha stage, so everything can be changed (keyboard\nshortcuts, views, color schema and of course features)**\n\n### Requirements\n\nIf something does not work, like you have too old version of `ClickHouse`, consider upgrading.\n\n*Note: the oldest version that had been tested was 21.2 (at some point in time)*\n\n### Build from sources\n\n```\ncargo build\n```\n\n\u003e [!NOTE]\n\u003e If you see an error like `failed to authenticate when downloading repository: git@github.com:azat-rust/cursive`,\n\u003e it is likely because your local Git config is rewriting `https://github.com/` to `git@github.com:`:\n\u003e\n\u003e ```\n\u003e [url \"git@github.com:\"]\n\u003e     insteadOf = https://github.com/\n\u003e ```\n\u003e\n\u003e Cargo's built-in Git library does not handle this case gracefully.\n\u003e You can either remove that config entry or tell Cargo to use the system Git client instead:\n\u003e\n\u003e ```toml\n\u003e # ~/.cargo/config.toml\n\u003e [net]\n\u003e git-fetch-with-cli = true\n\u003e ```\n\nFor development and debugging information, see [Documentation/Developers.md](Documentation/Developers.md).\n\n## References\n\n- [FAQ](Documentation/FAQ.md)\n- [Bugs list](Documentation/Bugs.md)\n- [Shortcuts](Documentation/Actions.md#shortcuts)\n- [Developers](Documentation/Developers.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazat%2Fchdig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazat%2Fchdig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazat%2Fchdig/lists"}