{"id":18496687,"url":"https://github.com/gbbirkisson/trace-debug","last_synced_at":"2025-05-14T04:35:32.206Z","repository":{"id":195853088,"uuid":"693808913","full_name":"gbbirkisson/trace-debug","owner":"gbbirkisson","description":null,"archived":false,"fork":false,"pushed_at":"2023-09-19T21:36:52.000Z","size":18,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-25T17:27:55.372Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gbbirkisson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-09-19T18:53:10.000Z","updated_at":"2023-09-20T06:01:16.000Z","dependencies_parsed_at":"2023-09-19T22:19:59.399Z","dependency_job_id":null,"html_url":"https://github.com/gbbirkisson/trace-debug","commit_stats":null,"previous_names":["gbbirkisson/trace-debug"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbbirkisson%2Ftrace-debug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbbirkisson%2Ftrace-debug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbbirkisson%2Ftrace-debug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbbirkisson%2Ftrace-debug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gbbirkisson","download_url":"https://codeload.github.com/gbbirkisson/trace-debug/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239212566,"owners_count":19600833,"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":[],"created_at":"2024-11-06T13:30:47.286Z","updated_at":"2025-02-17T00:17:00.630Z","avatar_url":"https://github.com/gbbirkisson.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg align=\"right\" height=\"100\" src=\"https://raw.githubusercontent.com/open-telemetry/opentelemetry-rust/main/assets/logo-text.png\"\u003e\n\n\u003ch1\u003etrace-debug\u003c/h1\u003e\n\nThis program was created to debug trace pipelines.\n\n\u003c!-- vim-markdown-toc GFM --\u003e\n\n* [Installing](#installing)\n* [Usage](#usage)\n* [Using with kubernetes](#using-with-kubernetes)\n* [Supported exporters](#supported-exporters)\n\n\u003c!-- vim-markdown-toc --\u003e\n\n## Installing\n\n\u003e [!NOTE]\n\u003e You'll need `cargo` and the rust compiler installed on your machine!\n\n```console\n$ cargo install --git https://github.com/gbbirkisson/trace-debug.git\n```\n\n## Usage\n\n```console\n$ trace-debug --help\nUsage: trace-debug [OPTIONS]\n\nOptions:\n  -e, --exporter \u003cEXPORTER\u003e          Exporter type [default: stdout] [possible values: stdout, jaeger, otlp]\n      --scheme \u003cSCHEME\u003e              Scheme to use [default: http]\n      --host \u003cHOST\u003e                  Host to export to [default: 127.0.0.1]\n      --port \u003cPORT\u003e                  Port to export to [default: \u003cdepends on exporter\u003e]\n      --service-name \u003cSERVICE_NAME\u003e  Service name [default: trace-debug]\n  -t, --tracer-name \u003cTRACER_NAME\u003e    Tracer name [default: trace-debug]\n  -s, --span-name \u003cSPAN_NAME\u003e        Span name [default: debug-span]\n  -n, --number \u003cNUMBER\u003e              Number of generated child spans [default: 0]\n  -h, --help                         Print help\n  -V, --version                      Print version\n```\n\n## Using with kubernetes\n\n\u003e [!NOTE]\n\u003e You'll need `docker` and `kubectl` installed and setup on your machine.\n\nYou can build and run this `trace-debug` in a pod like so:\n\n```console\n$ NS=myns POD=mypod CMD='-n 5 -e jaeger --host $$JAEGER_AGENT_HOST' make exec\nkubectl -n myns cp trace-debug mypod:/trace-debug\nkubectl -n myns exec mypod -- sh -c '/trace-debug -n 5 -e jaeger --host $JAEGER_AGENT_HOST'\nStarting trace-debug\nUsing Args {\n    exporter: Jaeger,\n    host: \"12.0.0.94\",\n    port: Some(\n        6831,\n    ),\n    service_name: \"trace-debug\",\n    tracer_name: \"trace-debug\",\n    span_name: \"debug-span\",\n    number: 5,\n}\nCreated span with traceid 9bf235ac7e86b64dae821a50b4947932 and spanid b9ee06c548204aba\nCreated span with traceid 9bf235ac7e86b64dae821a50b4947932 and spanid 1a32d9c700fe1cac\nCreated span with traceid 9bf235ac7e86b64dae821a50b4947932 and spanid 88408def9236687f\nCreated span with traceid 9bf235ac7e86b64dae821a50b4947932 and spanid 269021fdb69cdbf0\nCreated span with traceid 9bf235ac7e86b64dae821a50b4947932 and spanid 2b55e7cda9e73caa\nCreated span with traceid 9bf235ac7e86b64dae821a50b4947932 and spanid 6666c2897ea22e88\nExiting\n```\n\n## Supported exporters\n\n- [x] stdout\n- [x] jaeger\n- [x] otlp\n- [ ] zipkin\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgbbirkisson%2Ftrace-debug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgbbirkisson%2Ftrace-debug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgbbirkisson%2Ftrace-debug/lists"}