{"id":49834,"library":"zipkin-instrumentation-axios","title":"zipkin-instrumentation-axios","description":"A wrapper library to instrument axios HTTP-client with Zipkin distributed tracing. Version 0.1.0 provides a simple wrapAxios(axios, options) function that returns a traced axios instance. Integrates with the Zipkin Tracer and requires explicit context, recorder, and logger setup. Minimal documentation, low maintenance activity on GitHub. Differentiates from other HTTP instrumentation by focusing specifically on axios with a thin wrapper pattern.","status":"active","version":"0.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/uschmann/zipkin-instrumentation-axios","tags":["javascript","zipkin","instrumemtation","http","client","axios","npm"],"install":[{"cmd":"npm install zipkin-instrumentation-axios","lang":"bash","label":"npm"},{"cmd":"yarn add zipkin-instrumentation-axios","lang":"bash","label":"yarn"},{"cmd":"pnpm add zipkin-instrumentation-axios","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Zipkin tracer, context, and recorder required for instrumentation","package":"zipkin","optional":false}],"imports":[{"note":"Package uses CommonJS; named export is the default. No ESM exports.","wrong":"import wrapAxios from 'zipkin-instrumentation-axios';","symbol":"wrapAxios","correct":"const wrapAxios = require('zipkin-instrumentation-axios');"},{"note":"For ESM-compatible bundlers, default import works as the package has no named exports.","wrong":"","symbol":"wrapAxios","correct":"import wrapAxios from 'zipkin-instrumentation-axios';"}],"quickstart":{"code":"const axios = require('axios');\nconst wrapAxios = require('zipkin-instrumentation-axios');\nconst { Tracer, ExplicitContext, BatchRecorder } = require('zipkin');\nconst { HttpLogger } = require('zipkin-transport-http');\n\nconst ctxImpl = new ExplicitContext();\nconst recorder = new BatchRecorder({\n  logger: new HttpLogger({ endpoint: 'http://localhost:9411/api/v1/spans' })\n});\nconst tracer = new Tracer({ ctxImpl, recorder });\n\nconst zipkinAxios = wrapAxios(axios, { tracer, serviceName: 'myService' });\n\nzipkinAxios.get('http://example.com/api/data')\n  .then(res => console.log(res.data))\n  .catch(err => console.error(err));","lang":"javascript","description":"Demonstrates wrapping an axios instance with Zipkin tracing using ExplicitContext and BatchRecorder."},"warnings":[{"fix":"Create a fresh axios instance or use 'axios.create()' before wrapping.","message":"wrapAxios mutates the passed axios instance; do not reuse the original axios for untraced requests after wrapping.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Run 'npm install zipkin zipkin-transport-http'.","message":"Requires zipkin and zipkin-transport-http packages to be installed separately.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Create a custom type declaration or use @ts-ignore.","message":"No TypeScript definitions; type-checking may be absent in TS projects.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"search_vec":"'0.1.0':19 'activ':50 'axio':4,10,24,31,62,73 'client':13,72 'context':41 'differenti':53 'distribut':16 'document':47 'explicit':40 'focus':59 'function':26 'github':52 'http':12,56,71 'http-client':11 'instanc':32 'instrumemt':70 'instrument':3,9,57 'integr':33 'javascript':68 'librari':7 'logger':44 'low':48 'mainten':49 'minim':46 'npm':74 'option':25 'pattern':67 'provid':20 'record':42 'requir':39 'return':28 'setup':45 'simpl':22 'specif':60 'thin':65 'trace':17,30 'tracer':37 'version':18 'wrapaxio':23 'wrapper':6,66 'zipkin':2,15,36,69 'zipkin-instrumentation-axio':1","created_at":"2026-06-07T17:03:50.712172+00:00","updated_at":"2026-06-07T17:03:50.712172+00:00","problems":[{"fix":"npm install zipkin","cause":"zipkin package not installed","error":"Error: Cannot find module 'zipkin'"},{"fix":"const wrapAxios = require('zipkin-instrumentation-axios');","cause":"Incorrect import or require path","error":"TypeError: wrapAxios is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/uschmann/zipkin-instrumentation-axios#readme","github":"https://github.com/uschmann/zipkin-instrumentation-axios","docs":null,"changelog":null,"pypi":null,"npm":"zipkin-instrumentation-axios","openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}