Skip to main content
Version: 2.33.1


Aperture Java Instrumentation Agent

All Netty pipelines can have an Aperture Handler automatically added into them using Aperture Instrumentation Agent.


You can create an API key for your project in the Aperture Cloud UI. For detailed instructions on locating API Keys, refer to the API Keys section.

Netty Handler

Aperture Java SDK Netty package contains a Handler that automatically creates traffic flows for requests in a given pipeline:

import com.fluxninja.aperture.netty.ApertureServerHandler;
public class ServerInitializer extends ChannelInitializer<Channel>{

You can instruct the handler to exclude specific paths from being monitored by the Aperture SDK. For example, you might want to exclude endpoints used for health checks. To achieve this, you can add the path(s) you want to ignore to the ignoredPaths field of the SDK, as shown in the following code:

The paths should be specified as a comma-separated list. Note that the paths you specify must match exactly. However, you can change this behavior to treat the paths as regular expressions by setting the ignoredPathMatchRegex flag to true, like so:


For more context on using Aperture Netty Handler to set Control Points, refer to the example app available in the repository.