{"id":22848415,"url":"https://github.com/feedzai/dist-tracing","last_synced_at":"2025-06-23T14:33:24.020Z","repository":{"id":57719244,"uuid":"189210503","full_name":"feedzai/dist-tracing","owner":"feedzai","description":null,"archived":false,"fork":false,"pushed_at":"2020-10-13T14:46:15.000Z","size":4129,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-03-31T06:11:42.638Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/feedzai.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":"2019-05-29T11:16:07.000Z","updated_at":"2019-09-11T17:47:21.000Z","dependencies_parsed_at":"2022-08-26T09:42:17.842Z","dependency_job_id":null,"html_url":"https://github.com/feedzai/dist-tracing","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/feedzai/dist-tracing","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedzai%2Fdist-tracing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedzai%2Fdist-tracing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedzai%2Fdist-tracing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedzai%2Fdist-tracing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/feedzai","download_url":"https://codeload.github.com/feedzai/dist-tracing/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedzai%2Fdist-tracing/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261494712,"owners_count":23167182,"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-12-13T04:12:08.597Z","updated_at":"2025-06-23T14:33:24.001Z","avatar_url":"https://github.com/feedzai.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.com/GoncaloGarcia/DistTracing.svg?token=UL4UejHxEkoG4ZY6Wp8v\u0026branch=master)](https://travis-ci.com/GoncaloGarcia/DistTracing) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/64c32ebc68a7406c92ec68292cc5e1ac)](https://www.codacy.com?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=GoncaloGarcia/DistTracing\u0026amp;utm_campaign=Badge_Grade)[![codecov](https://codecov.io/gh/GoncaloGarcia/DistTracing/branch/master/graph/badge.svg?token=zeWoZDlzAU)](https://codecov.io/gh/GoncaloGarcia/DistTracing)\n\n\n\n# Description\n\nThis project is a simplified API for tracing Java based distributed systems, as well as an implementation based on the OpenTracing instrumentation framework and the Jaeger tracing engine.\n\nIn this book you will first find a small explanation of the tracing model, then a high-level description of the APIs and some instruction on when to use each API.\n\n## Installation\n\nThis project is avaliable on Maven Central. To use it in your projects add the following to your `pom.xml`\n\n```\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.feedzai.commons.tracing\u003c/groupId\u003e\n    \u003cartifactId\u003etracing\u003c/artifactId\u003e\n    \u003cversion\u003e0.1.10\u003c/version\u003e\n    \u003ctype\u003epom\u003c/type\u003e\n\u003c/dependency\u003e\n```\n\n## Usage\n\nFor an API description along with usage examples please refer to the [Documentation](site/src/gitbook/DESCRIPTION.md)\n\n## Generating Gitbook documentation\n\nOur docs are also available in Gitbook form, to generate and view them execute the following commands from the project's root.\n\n```\ncd site/src/gitbook\ngitbook install\ngitbook serve\n```\n\nThe output of `gitbook serve` should provide a link to the generated webpage.\n\n\n\n## Build\n\nRun the following command:\n\n```\nmvn clean install\n```\n\nTo build without running tests execute:\n\n```\nmvn clean install -DskipTests\n```\n\n## Enable Logging\n\nIf you're running the API backed by our LoggingTracingEngine you need to add the following to your `logback.xml`\n\n```\n  \u003cappender name=\"METRICS\" class=\"ch.qos.logback.core.rolling.RollingFileAppender\"\u003e\n    \u003cfile\u003elog/trace.log\u003c/file\u003e\n    \u003cencoder\u003e\n      \u003cpattern\u003e%msg\u003c/pattern\u003e\n    \u003c/encoder\u003e\n    \u003crollingPolicy class=\"ch.qos.logback.core.rolling.TimeBasedRollingPolicy\"\u003e\n      \u003cfileNamePattern\u003elog/trace%d{yyyy-MM}-week-%d{WW}.log.gz\u003c/fileNamePattern\u003e\n      \u003cmaxHistory\u003e8\u003c/maxHistory\u003e\n    \u003c/rollingPolicy\u003e\n  \u003c/appender\u003e\n\n  \u003cappender name=\"METRICS-ASYNC\" class=\"ch.qos.logback.classic.AsyncAppender\"\u003e\n    \u003cappender-ref ref=\"METRICS\" /\u003e\n    \u003cqueueSize\u003e2048\u003c/queueSize\u003e\n    \u003cdiscardingThreshold\u003e0\u003c/discardingThreshold\u003e\n    \u003cincludeCallerData\u003efalse\u003c/includeCallerData\u003e\n  \u003c/appender\u003e\n\n  \u003clogger name=\"com.feedzai.commons.tracing.engine.LoggingTracingEngine\" level=\"TRACE\" additivity=\"false\"\u003e\n    \u003cappender-ref ref=\"METRICS-ASYNC\" /\u003e\n  \u003c/logger\u003e\n  ```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeedzai%2Fdist-tracing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffeedzai%2Fdist-tracing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeedzai%2Fdist-tracing/lists"}