Refinery | Honeycomb


Refinery is a trace-aware tail-based sampling proxy. It examines whole traces and intelligently applies sampling decisions (whether to keep or discard) to each trace.

Tail-based sampling allows you to use fields that might be present in different spans within the trace to influence a sampling decision for the whole trace. 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.

The default configuration at installation contains the minimum configuration needed to run Refinery. Customize your configuration with general configuration and sampling method configuration.

While configuring, you may need to scale and troubleshoot your Refinery instance.

Did you find what you were looking for?