{"id":31076532,"url":"https://github.com/open-telemetry/opentelemetry-swift-core","last_synced_at":"2025-09-16T05:21:52.756Z","repository":{"id":312298208,"uuid":"1046437116","full_name":"open-telemetry/opentelemetry-swift-core","owner":"open-telemetry","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-15T14:49:39.000Z","size":3954,"stargazers_count":2,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-16T00:39:08.434Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://opentelemetry.io/docs/instrumentation/swift/","language":"Swift","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/open-telemetry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","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":"2025-08-28T17:27:35.000Z","updated_at":"2025-09-15T14:49:43.000Z","dependencies_parsed_at":"2025-08-29T19:11:08.748Z","dependency_job_id":null,"html_url":"https://github.com/open-telemetry/opentelemetry-swift-core","commit_stats":null,"previous_names":["open-telemetry/opentelemetry-swift-core"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/open-telemetry/opentelemetry-swift-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-swift-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-swift-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-swift-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-swift-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/open-telemetry","download_url":"https://codeload.github.com/open-telemetry/opentelemetry-swift-core/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-swift-core/sbom","scorecard":{"id":1236495,"data":{"date":"2025-08-29T17:53:42Z","repo":{"name":"github.com/open-telemetry/opentelemetry-swift-core","commit":"e12838930ad4e13f73010d15a915a403ea223e92"},"scorecard":{"version":"v5.2.1","commit":"ab2f6e92482462fe66246d9e32f642855a691dc1"},"score":6.2,"checks":[{"name":"Code-Review","score":0,"reason":"Found 1/30 approved changesets -- score normalized to 0","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/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#code-review"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: RenovateBot: .github/renovate.json5:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dependency-update-tool"}},{"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/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#binary-artifacts"}},{"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/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/CodeQL-Analysis.yml:18","Info: jobLevel 'contents' permission set to 'read': .github/workflows/CodeQL-Analysis.yml:19","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/Create-Release-PR.yml:14","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/Tag-And-Release.yml:13","Info: topLevel 'contents' permission set to 'read': .github/workflows/BuildAndTest.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/CodeQL-Analysis.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/Create-Release-PR.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/PR-Release-Warning.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/Tag-And-Release.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/fossa.yml:9","Info: topLevel permissions set to 'read-all': .github/workflows/ossf-scorecard.yml:11"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":0,"reason":"dangerous workflow patterns detected","details":["Warn: script injection with untrusted input ' github.head_ref ': .github/workflows/PR-Release-Warning.yml:18","Warn: script injection with untrusted input ' github.head_ref ': .github/workflows/Tag-And-Release.yml:18"],"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info:  17 out of  17 GitHub-owned GitHubAction dependencies pinned","Info:  12 out of  12 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/ab2f6e92482462fe66246d9e32f642855a691dc1/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/ab2f6e92482462fe66246d9e32f642855a691dc1/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/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#license"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#vulnerabilities"}},{"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/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":8,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'main'","Info: 'force pushes' disabled on branch 'main'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'main'","Warn: required approving review count is 1 on branch 'main'","Info: codeowner review is required on branch 'main'","Info: status check found to merge onto on branch 'main'","Info: PRs are required in order to make changes on branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#branch-protection"}},{"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/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#fuzzing"}},{"name":"SAST","score":8,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 1 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#sast"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: github.com/open-telemetry/.github/SECURITY.md:1","Info: Found linked content: github.com/open-telemetry/.github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: github.com/open-telemetry/.github/SECURITY.md:1","Info: Found text in security policy: github.com/open-telemetry/.github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#security-policy"}},{"name":"CI-Tests","score":10,"reason":"2 out of 2 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#ci-tests"}},{"name":"Contributors","score":10,"reason":"project has 24 contributing companies or organizations","details":["Info: found contributions from: GitHawkApp, Hacker-UP, Inf1NityNJU, NiceLovelyPeople, PracticumHealthVisitTeam, ReaperCitiCup, SXSCar, Trendyol, apache, bytedance @kubernetes @open-telemetry, cmu-webapps, crowdstrike, ebay, elastic, embrace.io, linkedin, open-telemetry, redhatofficial, setdirection, sky uk, sky-uk, splunk a cisco company, splunk ex-new relic ex-observe a3v, trendyol"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#contributors"}}]},"last_synced_at":"2025-08-29T19:45:10.573Z","repository_id":312298208,"created_at":"2025-08-29T19:45:10.573Z","updated_at":"2025-08-29T19:45:10.573Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275344043,"owners_count":25447898,"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-09-15T02:00:09.272Z","response_time":75,"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":[],"created_at":"2025-09-16T05:21:51.893Z","updated_at":"2025-09-16T05:21:52.745Z","avatar_url":"https://github.com/open-telemetry.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://opentelemetry.io/img/logos/opentelemetry-logo-nav.png\" alt=\"OpenTelemetry Icon\" width=\"45\" height=\"\"\u003e opentelemetry-swift\n\n[![CI](https://github.com/open-telemetry/opentelemetry-swift/actions/workflows/BuildAndTest.yml/badge.svg)](https://github.com/open-telemetry/opentelemetry-swift/actions/workflows/BuildAndTest.yml?query=branch%3Amain+)\n[![codecov](https://codecov.io/gh/open-telemetry/opentelemetry-swift/branch/master/graph/badge.svg)](https://codecov.io/gh/open-telemetry/opentelemetry-swift)\n\n## About\n\nThe repository contains the Swift [OpenTelemetry](https://opentelemetry.io/) client\n\n## Getting Started\n\nThis package includes several libraries. The `OpenTelemetryApi` library includes protocols and no-op implementations that comprise the OpenTelemetry API following the [specification](https://github.com/open-telemetry/opentelemetry-specification). The `OpenTelemetrySdk` library is the reference implementation of the API.\n\nLibraries that produce telemetry data should only depend on `OpenTelemetryApi`, and defer the choice of the SDK to the application developer. Applications may depend on `OpenTelemetrySdk` or another package that implements the API.\n\n### Adding the dependency\n\nopentelemetry-swift is designed for Swift 5. To depend on the  opentelemetry-swift package, you need to declare your dependency in your `Package.swift`:\n\n```swift\n.package(url: \"https://github.com/open-telemetry/opentelemetry-swift\", from: \"1.0.0\"),\n```\n\nand to your application/library target, add `OpenTelemetryApi` or  `OpenTelemetrySdk`to your `dependencies`, e.g. like this:\n\n```swift\n.target(name: \"ExampleTelemetryProducerApp\", dependencies: [\"OpenTelemetryApi\"]),\n```\n\nor\n\n```swift\n.target(name: \"ExampleApp\", dependencies: [\"OpenTelemetrySdk\"]),\n```\n\n### Cocoapods\n\nAs of version 1.11.0, OpenTelemetry-Swift support cocoapods. \nTwo pods are provided: \n\n- `OpenTelemetry-Swift-Api`\n\n- `OpenTelemetry-Swift-Sdk`\n\n`OpenTelemetry-Swift-Api` is a dependency of `OpenTelemetry-Swift-Sdk`. \n\nMost users will want to add the following to their pod file:\n\n`pod 'OpenTelemetry-Swift-Sdk'`\n\nThis will add both the API and SDK. If you're only interesting in Adding the API add the following: \n\n`pod 'OpenTelemetry-Swift-Api'`\n\n## Documentation\n\nOfficial documentation for the library can be found in the official opentelemetry [documentation  page](https://opentelemetry.io/docs/instrumentation/swift/), including:\n\n* Documentation about installation and [manual instrumentation](https://opentelemetry.io/docs/instrumentation/swift/manual/)\n\n* [Libraries](https://opentelemetry.io/docs/instrumentation/swift/libraries/) that provide automatic instrumentation\n\n## Current status\n\n### API and SDK\n\nTracing and Baggage are considered stable\n\nLogs are considered stable. \n\nMetrics is considered stable.\n\n## Contributing\nWe'd love your help! Use labels [![help wanted](https://img.shields.io/github/issues-search/open-telemetry/opentelemetry-swift?query=is%3Aissue%20is%3Aopen%20label%3A%22help%20wanted%22\u0026label=help%20wanted\u0026color=rgb(0%2C%20134%2C%20114)\u0026logo=opentelemetry)](https://github.com/open-telemetry/opentelemetry-swift/issues?q=state%3Aopen%20label%3A%22help%20wanted%22) and [![good first issue](https://img.shields.io/github/issues-search/open-telemetry/opentelemetry-swift?query=is%3Aissue%20is%3Aopen%20label%3A%22good%20first%20issue%22\u0026label=good%20first%20issue\u0026color=rgb(112%2C%2087%2C%20255)\u0026logo=opentelemetry)](https://github.com/open-telemetry/opentelemetry-swift/issues?q=state%3Aopen%20label%3A%22good%20first%20issue%22) \n to get started with the project. \nFor an overview of how to contribute, see the contributing guide in [CONTRIBUTING.md](CONTRIBUTING.md).\n\nWe have a weekly SIG meeting! See the [community page](https://github.com/open-telemetry/community#swift-sdk) for meeting details and notes.\n\nWe are also available in the [#otel-swift](https://cloud-native.slack.com/archives/C01NCHR19SB) channel in the [CNCF slack](https://slack.cncf.io/). Please join us there for OTel Swift discussions.\n\n### Maintainers ([@open-telemetry/swift-core-maintainers](https://github.com/orgs/open-telemetry/teams/swift-core-maintainers))\n\n- [Ariel Demarco](https://github.com/arieldemarco), Embrace\n- [Bryce Buchanan](https://github.com/bryce-b), Elastic\n- [Ignacio Bonafonte](https://github.com/nachobonafonte), Independent\n\nFor more information about the maintainer role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#maintainer).\n\n### Approvers ([@open-telemetry/swift-core-approvers](https://github.com/orgs/open-telemetry/teams/swift-core-approvers))\n\n- [Austin Emmons](https://github.com/atreat), Embrace\n- [Vinod Vydier](https://github.com/vvydier), Independent\n\nFor more information about the approver role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#approver).\n\n### Triager ([@open-telemetry/swift-core-triagers](https://github.com/orgs/open-telemetry/teams/swift-core-triagers))\n\n- [Alolita Sharma](https://github.com/alolita), Apple\n\nFor more information about the triager role, see the [community repository](https://github.com/open-telemetry/community/blob/main/community-membership.md#triager).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-telemetry%2Fopentelemetry-swift-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopen-telemetry%2Fopentelemetry-swift-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-telemetry%2Fopentelemetry-swift-core/lists"}