axios-opentracing
Axios interceptor which traces your requests 👀
Motivation
Using opentracing in node.js is kinda hard because you need to keep context of current request. This package helps you to abstract tracing logic for your http calls with axios interceptors.
Installation
To use this package, you need to have axios and opentracing: With yarn:
yarn add axios opentracing axios-opentracing
Or with npm:
npm install axios opentracing axios-opentracing
And you also need any APM agent of your choice (Jaeger, Elastic APM, Lightstep, etc.) or your own implementation if it is compatible with Opentracing API.
Usage
This package contains one function-intializer that take your tracer as an argument and produces function-wrapper which will wrap your axios instance with interceptors:
const createAxiosTracing = ; const applyTracingInterceptors = ; ;
Alternatively, you can use global tracer simply by calling initializer without any arguments:
const opentracing = ;const createAxiosTracing = ; opentracing; const applyTracingInterceptors = ; ;
Produced function may be called on every request that your server handles. It takes your axios instance as 1st argument and options as 2nd argument, which looks like this:
const axiosTracingOptions = span: rootSpan spanName: 'Your span name';
Either span
or spanName
are required. If you pass span
then all the spans for your requests will be inherited from the passed one. If you pass spanName
then the new span with passed name will be created and used as a root span. If you pass both then passed span
will be used. The wrapper returns span that was used (passed or created).
Example
You can use any tracer, in this examples I will use Jaeger.
Simple
const axios = ;const initTracer = ;const createAxiosTracing = ; // Setup tracerconst tracer = ; // Create tracing applyerconst applyTracingInterceptors = ; // Create root spanconst rootSpan = tracer; // Setup an axios instanceconst API = axios; // Setup tracing interceptors; // Make some requestsPromiseall API API;
With express
You can use axios-opentracing with express-opentracing middleware:
const express = ;const expressOpentracing = ;const initTracer = ;const createAxiosTracing = ; // Setup tracerconst tracer = ; // Create tracing applyerconst applyTracingInterceptors = ; //const app = ; // Setup express tracer middlewareapp; app;
The tricky part is that you need to create an axios instance on every request that your server handles because we need to keep context. This problem can be solved simply by creating middleware which will produce axios instances and pass it to your handlers through request context:
// using global tracerconst applyTracingInterceptors = ; app; app; app;
Isomorphic applications with SSR (React, Vue, etc.)
axios-opentracing can be used to trace requests that your application makes while using SSR. As in express example, an axios instance can be initialized and passed to an application context and used in an application as a regular axios instance wherever you want. Just setup a common interface for a client and a server so that your logic implementation does not depend on the environment.
Contributing
PRs are welcome! Feel free to ask questions in issues.