Menu
Open source
HTTP instrumentation for Pyroscope
With jslib, you can instrument HTTP requests in a way that lets you tag Grafana Cloud Profiles with relevant information generated from k6 tests.
About baggage header
The baggage header is a standardized HTTP header used to propagate distributed context. The W3C specification goes into more detail on the specifics, but like many other headers, the baggage header is a list of key-value pairs.
This module, by default, adds three key-value pairs:
- Scenario name
- Name of the request (URL if not set)
- Value of
__ENV.K6_CLOUDRUN_TEST_RUN_ID
, which is set automatically in Grafana Cloud k6.
API
Class/Function | Description |
---|---|
instrumentHTTP | Instruments the k6 http module with baggage header. |
Client | Configurable Client that exposes instrumented HTTP operations. |
Example
This example demonstrates how to use the this library to instrument every HTTP request made in a script with the baggage
header.
JavaScript
import { check } from 'k6';
import pyroscope from 'https://jslib.k6.io/http-instrumentation-pyroscope/1.0.0/index.js';
import http from 'k6/http';
// instrumentHTTP will ensure that all requests made by the http module
// from this point forward will have a baggage context attached.
pyroscope.instrumentHTTP();
export default () => {
// the instrumentHTTP call in the init context replaced
// the http module with a version that will automatically
// attach a baggage header to every request.
const res = http.get('http://httpbin.org/get', {
headers: {
'X-Example-Header': 'instrumented/get',
},
});
};
Was this page helpful?
Related documentation
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
Video
Performance testing and observability in Grafana Cloud
In this webinar, learn how Grafana Cloud k6 offers you the best developer experience for performance testing.
User-centered observability: load testing, real user monitoring, and synthetics
Learn how to use load testing, synthetic monitoring, and real user monitoring (RUM) to understand end users' experience of your apps. Watch on demand.