{"id":19381764,"url":"https://github.com/taosdata/taoslog-rs","last_synced_at":"2025-04-23T20:31:59.885Z","repository":{"id":256104700,"uuid":"847621102","full_name":"taosdata/taoslog-rs","owner":"taosdata","description":"A logging toolbox used by taosdata services written in the Rust language.","archived":true,"fork":false,"pushed_at":"2024-10-09T07:08:11.000Z","size":56,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-24T16:54:25.499Z","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/taosdata.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-26T08:10:59.000Z","updated_at":"2024-10-14T02:35:24.000Z","dependencies_parsed_at":"2024-11-10T09:18:33.453Z","dependency_job_id":"9145e781-61a2-476f-95be-94cfda75ad0b","html_url":"https://github.com/taosdata/taoslog-rs","commit_stats":null,"previous_names":["taosdata/taoslog-rs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaoslog-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaoslog-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaoslog-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaoslog-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taosdata","download_url":"https://codeload.github.com/taosdata/taoslog-rs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250509719,"owners_count":21442483,"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-10T09:18:18.022Z","updated_at":"2025-04-23T20:31:59.589Z","avatar_url":"https://github.com/taosdata.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# taoslog\n\nA logging toolbox used by taosdata services written in the Rust language.\n\n## Usage\n\n### TaosLayer\n\nA [tracing_subscriber Layer](https://docs.rs/tracing-subscriber/latest/tracing_subscriber/layer/trait.Layer.html) implementation，used when initializing the global tracing subscriber.\n\n1. Customize a type that implements the `QidManager` trait.\n\n```rust\nuse taoslog::QidManager;\n\n#[derive(Clone)]\npub(crate) struct Qid(u64);\n\nimpl QidManager for Qid {\n    fn init() -\u003e Self {\n        Self(9223372036854775807)\n    }\n\n    fn get(\u0026self) -\u003e u64 {\n        self.0\n    }\n}\n\nimpl From\u003cu64\u003e for Qid {\n    fn from(value: u64) -\u003e Self {\n        Self(value)\n    }\n}\n```\n\n2. Init the global subscriber\n```rust\nuse taoslog::writer::RollingFileAppender;\n\nlet appender = RollingFileAppender::builder(\"/var/log/taos\", \"taosx\", 16)\n    .compress(true)\n    .reserved_disk_size(\"1GB\")\n    .rotation_count(3)\n    .rotation_size(\"1GB\")\n    .build()\n    .unwrap();\n\ntracing_subscriber::registry()\n    .with(TaosLayer::\u003cQid\u003e::new(appender))\n    .try_init()\n    .unwrap();\n```\n\n### TaosRootSpanBuilder\n\nA [RootSpanBuilder](https://docs.rs/tracing-actix-web/latest/tracing_actix_web/trait.RootSpanBuilder.html) implementation, used in the actix-web framework to generate a new tracing span when receiving a new HTTP request.\n\n```rust\nuse tracing_actix_web::TracingLogger;\nuse taoslog::middleware::TaosRootSpanBuilder;\n\nlet server = HttpServer::new(move || {\n    App::new()\n        .wrap(Compat::new(TracingLogger::\u003cTaosRootSpanBuilder\u003e::new()))\n})\n.bind(addr)\n.unwrap()\n.run();\n```\n\n### Utils\n\n```rust\nlet qid = Qid::from(12345);\n\n// for tracing span\nuse taoslog::utils::Span;\n\ntracing::info_span!(\"outer\", \"k\" = \"kkk\").in_scope(|| {\n    Span.set_qid(qid);\n    let qid: Qid = Span.get_qid().unwrap();\n});\n\n// for http header\nlet mut headers = HeaderMap::new();\nheaders.set_qid(qid.clone());\nlet qid: Qid = headers.get_qid().unwrap();\n\n// for RecordBatch Schema\nlet mut schema = Schema::empty();\nschema.set_qid(qid.clone());\nlet qid: Qid = schema.get_qid().unwrap();\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaosdata%2Ftaoslog-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaosdata%2Ftaoslog-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaosdata%2Ftaoslog-rs/lists"}