{"id":13511636,"url":"https://github.com/openzipkin/zipkin-go","last_synced_at":"2025-10-24T10:19:20.979Z","repository":{"id":11340015,"uuid":"69353600","full_name":"openzipkin/zipkin-go","owner":"openzipkin","description":"Zipkin distributed tracing library for go.","archived":false,"fork":false,"pushed_at":"2025-02-06T03:11:42.000Z","size":522,"stargazers_count":616,"open_issues_count":13,"forks_count":117,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-08-21T13:38:23.483Z","etag":null,"topics":["distributed-tracing","go","instrumentation","openzipkin","trace","tracing","zipkin"],"latest_commit_sha":null,"homepage":"","language":"Go","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/openzipkin.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-27T12:19:53.000Z","updated_at":"2025-08-20T04:58:23.000Z","dependencies_parsed_at":"2024-01-07T09:39:45.632Z","dependency_job_id":"eddeb612-9957-49f0-89d4-1d1e30f23bf4","html_url":"https://github.com/openzipkin/zipkin-go","commit_stats":{"total_commits":227,"total_committers":26,"mean_commits":8.73076923076923,"dds":0.5550660792951542,"last_synced_commit":"e609ce4fbeb610ff0c19b342956a040b0e2f8c67"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/openzipkin/zipkin-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openzipkin%2Fzipkin-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openzipkin%2Fzipkin-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openzipkin%2Fzipkin-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openzipkin%2Fzipkin-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openzipkin","download_url":"https://codeload.github.com/openzipkin/zipkin-go/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openzipkin%2Fzipkin-go/sbom","scorecard":{"id":710854,"data":{"date":"2025-08-11","repo":{"name":"github.com/openzipkin/zipkin-go","commit":"7c09a19912aa3b88dad72eb39a9ac677685e7e2f"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.4,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Security-Policy","score":9,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Warn: One or no descriptive hints of disclosure, vulnerability, and/or timelines in security policy","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":5,"reason":"Found 16/30 approved changesets -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Warn: no topLevel permission defined: .github/workflows/security.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/openzipkin/zipkin-go/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/openzipkin/zipkin-go/ci.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/openzipkin/zipkin-go/ci.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/openzipkin/zipkin-go/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/security.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/openzipkin/zipkin-go/security.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/security.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/openzipkin/zipkin-go/security.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/security.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/openzipkin/zipkin-go/security.yml/master?enable=pin","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 29 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2024-3321 / GHSA-v778-237x-gjrc","Warn: Project is vulnerable to: GO-2025-3487 / GHSA-hcg3-q754-cr77","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-22T08:10:43.858Z","repository_id":11340015,"created_at":"2025-08-22T08:10:43.858Z","updated_at":"2025-08-22T08:10:43.858Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280778689,"owners_count":26389456,"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","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"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":["distributed-tracing","go","instrumentation","openzipkin","trace","tracing","zipkin"],"created_at":"2024-08-01T03:01:02.377Z","updated_at":"2025-10-24T10:19:20.940Z","avatar_url":"https://github.com/openzipkin.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003c!--\nCopyright 2022 The OpenZipkin Authors\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n--\u003e\n\n# Zipkin Library for Go\n\n[![GHA](https://github.com/openzipkin/zipkin-go/actions/workflows/ci.yml/badge.svg?event=push)](https://github.com/openzipkin/zipkin-go/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/openzipkin/zipkin-go/branch/master/graph/badge.svg?token=gXdWofFlsq)](https://codecov.io/gh/openzipkin/zipkin-go)\n[![Go Report Card](https://goreportcard.com/badge/github.com/openzipkin/zipkin-go)](https://goreportcard.com/report/github.com/openzipkin/zipkin-go)\n[![GoDoc](https://godoc.org/github.com/openzipkin/zipkin-go?status.svg)](https://godoc.org/github.com/openzipkin/zipkin-go)\n[![Gitter chat](https://badges.gitter.im/openzipkin/zipkin.svg)](https://gitter.im/openzipkin/zipkin?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![Sourcegraph](https://sourcegraph.com/github.com/openzipkin/zipkin-go/-/badge.svg)](https://sourcegraph.com/github.com/openzipkin/zipkin-go?badge)\n\nZipkin Go is the official Go Tracer / Tracing implementation for Zipkin, \nsupported by the OpenZipkin community.\n\n## package organization\n`zipkin-go` is built with interoperability in mind within the OpenZipkin\ncommunity and even 3rd parties, the library consists of several packages.\n\nThe main tracing implementation can be found in the root folder of this\nrepository. Reusable parts not considered core implementation or deemed\nbeneficiary for usage by others are placed in their own packages within this\nrepository.\n\n### model\nThis library implements the Zipkin V2 Span Model which is available in the model\npackage. It contains a Go data model compatible with the Zipkin V2 API and can\nautomatically sanitize, parse and (de)serialize to and from the required JSON\nrepresentation as used by the official Zipkin V2 Collectors.\n\n### propagation\nThe propagation package and B3 subpackage hold the logic for propagating\nSpanContext (span identifiers and sampling flags) between services participating\nin traces. Currently Zipkin B3 Propagation is supported for HTTP and GRPC.\n\n### middleware\nThe middleware subpackages contain officially supported middleware handlers and\ntracing wrappers.\n\n#### http\nAn easy to use http.Handler middleware for tracing server side requests is\nprovided. This allows one to use this middleware in applications using\nstandard library servers as well as most available higher level frameworks. Some\nframeworks will have their own instrumentation and middleware that maps better\nfor their ecosystem.\n\nFor HTTP client operations `NewTransport` can return a `http.RoundTripper`\nimplementation that can either wrap the standard http.Client's Transport or a\ncustom provided one and add per request tracing. Since HTTP Requests can have\none or multiple redirects it is advisable to always enclose HTTP Client calls\nwith a `Span` either around the `*http.Client` call level or parent function\nlevel.\n\nFor convenience `NewClient` is provided which returns a HTTP Client which embeds\n`*http.Client` and provides an `application span` around the HTTP calls when\ncalling the `DoWithAppSpan()` method.\n\n#### grpc\nEasy to use grpc.StatsHandler middleware are provided for tracing gRPC server\nand client requests. \n\nFor a server, pass `NewServerHandler` when calling `NewServer`, e.g.,\n\n```go\nimport (\n\t\"google.golang.org/grpc\"\n\tzipkingrpc \"github.com/openzipkin/zipkin-go/middleware/grpc\"\n)\n\nserver = grpc.NewServer(grpc.StatsHandler(zipkingrpc.NewServerHandler(tracer)))\n```\n\nFor a client, pass `NewClientHandler` when calling `Dial`, e.g.,\n\n```go\nimport (\n\t\"google.golang.org/grpc\"\n\tzipkingrpc \"github.com/openzipkin/zipkin-go/middleware/grpc\"\n)\n\nconn, err = grpc.Dial(addr, grpc.WithStatsHandler(zipkingrpc.NewClientHandler(tracer)))\n```\n\n### reporter\nThe reporter package holds the interface which the various Reporter\nimplementations use. It is exported into its own package as it can be used by\n3rd parties to use these Reporter packages in their own libraries for exporting\nto the Zipkin ecosystem. The `zipkin-go` tracer also uses the interface to\naccept 3rd party Reporter implementations.\n\n#### HTTP Reporter\nMost common Reporter type used by Zipkin users transporting Spans to the Zipkin\nserver using JSON over HTTP. The reporter holds a buffer and reports to the\nbackend asynchronously.\n\n#### Kafka Reporter\nHigh performance Reporter transporting Spans to the Zipkin server using a Kafka\nProducer digesting JSON V2 Spans. The reporter uses the\n[Sarama async producer](https://pkg.go.dev/github.com/IBM/sarama#AsyncProducer)\nunderneath.\n\n## Usage and Examples\n[HTTP Server Example](examples/httpserver_test.go)\n\n## Go Support Policy\n\nzipkin-go follows the same version policy as Go's [Release Policy](https://go.dev/doc/devel/release):\ntwo versions. zipkin-go will ensure these versions work and bugs are valid if\nthere's an issue with a current Go version.\n\nAdditionally, zipkin-go intentionally delays usage of language or standard\nlibrary features one additional version. For example, when Go 1.29 is released,\nzipkin-go can use language features or standard libraries added in 1.27. This\nis a convenience for embedders who have a slower version policy than Go.\nHowever, only supported Go versions may be used to raise support issues.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenzipkin%2Fzipkin-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenzipkin%2Fzipkin-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenzipkin%2Fzipkin-go/lists"}