Refinery is a trace-aware sampling proxy. It collects spans emitted by your application, gathers them into traces, and examines them as a whole. This enables Refinery to make an intelligent sampling decision (whether to keep or discard) based on the entire trace.
Buffering the spans allows you to use fields that might be present in different spans within the trace to influence the sampling decision.
For example, the root span might have HTTP status code, whereas another span might have information on whether the request was served from a cache.
Using Refinery, you can choose to keep only traces that had a
500 status code and were also served from a cache.
Explore our Refinery set up instructions.
While configuring, you may need to scale and troubleshoot your Refinery instance.