{"id":13648029,"url":"https://github.com/census-instrumentation/opencensus-node","last_synced_at":"2025-04-22T06:32:56.767Z","repository":{"id":39741392,"uuid":"109782875","full_name":"census-instrumentation/opencensus-node","owner":"census-instrumentation","description":"A stats collection and distributed tracing framework","archived":true,"fork":false,"pushed_at":"2023-07-27T20:28:29.000Z","size":10904,"stargazers_count":273,"open_issues_count":79,"forks_count":97,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-10-17T12:20:07.318Z","etag":null,"topics":["cloud","dapper","distributed-tracing","instrumentation","jaeger","javascript","metrics","monitoring","node","opencensus","stackdriver","stats","trace","tracing","zipkin","zpages"],"latest_commit_sha":null,"homepage":"https://opencensus.io","language":"TypeScript","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/census-instrumentation.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-07T03:35:31.000Z","updated_at":"2024-06-24T09:56:25.000Z","dependencies_parsed_at":"2024-06-14T19:09:28.700Z","dependency_job_id":"8965cc4e-7b38-4b8c-b10b-05c7b706faf2","html_url":"https://github.com/census-instrumentation/opencensus-node","commit_stats":{"total_commits":634,"total_committers":60,"mean_commits":"10.566666666666666","dds":0.6908517350157728,"last_synced_commit":"5bf0c25180bd56fbfd605fff4ba637e695e83fa9"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/census-instrumentation%2Fopencensus-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/census-instrumentation%2Fopencensus-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/census-instrumentation%2Fopencensus-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/census-instrumentation%2Fopencensus-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/census-instrumentation","download_url":"https://codeload.github.com/census-instrumentation/opencensus-node/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222290998,"owners_count":16961737,"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":["cloud","dapper","distributed-tracing","instrumentation","jaeger","javascript","metrics","monitoring","node","opencensus","stackdriver","stats","trace","tracing","zipkin","zpages"],"created_at":"2024-08-02T01:03:54.255Z","updated_at":"2024-11-09T22:30:52.194Z","avatar_url":"https://github.com/census-instrumentation.png","language":"TypeScript","readme":"\u003e **Warning**\n\u003e\n\u003e OpenCensus and OpenTracing have merged to form [OpenTelemetry](https://opentelemetry.io), which serves as the next major version of OpenCensus and OpenTracing.\n\u003e\n\u003e OpenTelemetry has now reached feature parity with OpenCensus, with tracing and metrics SDKs available in .NET, Golang, Java, NodeJS, and Python. **All OpenCensus Github repositories, except [census-instrumentation/opencensus-python](https://github.com/census-instrumentation/opencensus-python), will be archived on July 31st, 2023**. We encourage users to migrate to OpenTelemetry by this date.\n\u003e\n\u003e To help you gradually migrate your instrumentation to OpenTelemetry, bridges are available in Java, Go, Python, and JS. [**Read the full blog post to learn more**](https://opentelemetry.io/blog/2023/sunsetting-opencensus/).\n\n# OpenCensus - A stats collection and distributed tracing framework\n[![Gitter chat][gitter-image]][gitter-url]\n![Node Version][node-img]\n[![NPM Published Version][npm-img]][npm-url]\n[![codecov][codecov-image]][codecov-url]\n[![Known Vulnerabilities][snyk-image]][snyk-url]\n![Apache License][license-image]\n\nOpenCensus Node.js is an implementation of OpenCensus, a toolkit for collecting application performance and behavior monitoring data. It currently includes 3 apis: stats, tracing and tags. Please visit the [OpenCensus Node.js package](https://github.com/census-instrumentation/opencensus-node/tree/master/packages/opencensus-nodejs) for tracing usage and [OpenCensus Core package](https://github.com/census-instrumentation/opencensus-node/tree/master/packages/opencensus-core) for stats usage.\n\nThe library is in alpha stage and the API is subject to change.\n\nPlease join [gitter](https://gitter.im/census-instrumentation/Lobby) for help or feedback on this project.\n\n## OpenCensus and OpenTracing have merged to form OpenTelemetry, which serves as the next major version of OpenCensus and OpenTracing. OpenTelemetry will offer backwards compatibility with existing OpenCensus integrations, and we will continue to make security patches to existing OpenCensus libraries for two years. Read more about the merger [here](https://medium.com/opentracing/a-roadmap-to-convergence-b074e5815289).\n\n## Installation\n\nInstall OpenCensus with:\n\n```bash\nnpm install @opencensus/nodejs\n```\n\n\nInstall OpenCensus Base without automatic instrumentation:\n\n```bash\nnpm install @opencensus/nodejs-base\n```\n\n## Plugins\n\nOpenCensus can collect tracing data automatically using plugins. Users can also create and use their own plugins. Currently, OpenCensus supports automatic tracing for:\n\n- [HTTP](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-instrumentation-http/README.md)\n- [HTTPS](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-instrumentation-https/README.md)\n- [HTTP2](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-instrumentation-http2/README.md)\n- [GRPC](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-instrumentation-grpc/README.md)\n- [IORedis](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-instrumentation-ioredis/README.md)\n- [Redis](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-instrumentation-redis/README.md)\n\n## Propagation\n\nOpenCensus collects distributed tracing. It is able to do so by propagating span data through services. Currently, OpenCensus supports:\n\n- [B3 Propagation](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-propagation-b3/README.md)\n- [Stackdriver Propagation](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-propagation-stackdriver/README.md)\n- [Trace Context Propagation](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-propagation-tracecontext/README.md)\n- [Binary Format Propagation](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-propagation-binaryformat/README.md)\n\n## Exporters\n\nOpenCensus is vendor-agnostic and can upload data to any backend with various exporter implementations. Even though, OpenCensus provides support for many backends, users can also implement their own exporters for proprietary and unofficially supported backends. Currently, OpenCensus supports:\n\n#### Trace exporters\n- [Stackdriver](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-exporter-stackdriver/README.md)\n- [Jaeger](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-exporter-jaeger/README.md)\n- [Zipkin](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-exporter-zipkin/README.md)\n- [Instana](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-exporter-instana/README.md)\n\n#### Stats/Metrics exporters\n- [Stackdriver](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-exporter-stackdriver/README.md)\n- [Prometheus](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-exporter-prometheus/README.md)\n\n#### How to setup debugging Z-Pages?\n-  If the application owner wants to export in-process tracing and stats data via HTML debugging pages see this [Z-Pages](https://github.com/census-instrumentation/opencensus-node/blob/master/packages/opencensus-exporter-zpages/README.md).\n\nIf no exporter is registered in the tracing instance, as default, a console log exporter is used.\n\n## Versioning\n\nThis library follows [Semantic Versioning](http://semver.org/).\n\n**GA**: Libraries defined at a GA quality level are stable, and will not introduce\nbackwards-incompatible changes in any minor or patch releases. We will address issues and requests\nwith the highest priority. If we were to make a backwards-incompatible changes on an API, we will\nfirst mark the existing API as deprecated and keep it for 18 months before removing it.\n\n**Beta**: Libraries defined at a Beta quality level are expected to be mostly stable and we're\nworking towards their release candidate. We will address issues and requests with a higher priority.\nThere may be backwards incompatible changes in a minor version release, though not in a patch\nrelease. If an element is part of an API that is only meant to be used by exporters or other\nopencensus libraries, then there is no deprecation period. Otherwise, we will deprecate it for 18\nmonths before removing it, if possible.\n\n**Alpha**: Libraries defined at a Alpha quality level can be unstable and could cause crashes or data loss. Alpha software may not contain all of the features that are planned for the final version. The API is subject to change.\n\n## Useful links\n- For more information on OpenCensus, visit: \u003chttps://opencensus.io/\u003e\n- For help or feedback on this project, join us on [gitter](https://gitter.im/census-instrumentation/Lobby)\n\n[codecov-image]: https://codecov.io/gh/census-instrumentation/opencensus-node/branch/master/graph/badge.svg\n[codecov-url]: https://codecov.io/gh/census-instrumentation/opencensus-node\n[gitter-image]: https://badges.gitter.im/census-instrumentation/lobby.svg\n[gitter-url]: https://gitter.im/census-instrumentation/lobby?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\n[npm-url]: https://www.npmjs.com/package/@opencensus/nodejs\n[npm-img]: https://badge.fury.io/js/%40opencensus%2Fnodejs.svg\n[node-img]: https://img.shields.io/node/v/@opencensus/nodejs.svg\n[license-image]: https://img.shields.io/badge/license-Apache_2.0-green.svg?style=flat\n[snyk-image]: https://snyk.io/test/github/census-instrumentation/opencensus-node/badge.svg?style=flat\n[snyk-url]: https://snyk.io/test/github/census-instrumentation/opencensus-node\n\n## LICENSE\n\nApache License 2.0\n","funding_links":[],"categories":["Integrations","TypeScript","Google Cloud Trace"],"sub_categories":["JavaScript","Client libraries"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensus-instrumentation%2Fopencensus-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcensus-instrumentation%2Fopencensus-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensus-instrumentation%2Fopencensus-node/lists"}