Skip to main content
Version: 2.16.0

FluxNinja Aperture Cloud Extension

FluxNinja Aperture Cloud extension enables Aperture Cloud integration for Aperture Agents (and self-hosted Controllers). It enriches logs and traces collected by Aperture and sends them to Aperture Cloud. This data is batched and rolled up to optimize bandwidth usage. The extension also sends periodic heartbeats to Aperture Cloud to track health and configuration. This allows you to monitor your policies and analyze flows in Aperture Cloud.

FluxNinja Aperture Cloud extension also provides the possibility to use the Aperture Cloud Controller.

Aperture Cloud Controller

Without the Aperture Controller, Aperture Agents won't be able to work. While it's possible to self-host Aperture Controller, Aperture Cloud Controller can be used instead.

Aperture Cloud Controller is an Aperture Controller hosted by Aperture Cloud. The Cloud Controller is available for every Aperture Cloud Organization in the default project.


Configure the following parameters in the values.yaml file generated during installation of the Aperture Controller or Agent:

enable_cloud_controller: true
endpoint: ""
create: true
name: aperture-agent-apikey
key: apiKey
value: API_KEY

Replace the values of ORGANIZATION_NAME and API_KEY with the actual values of the organization on Aperture Cloud and API Key generated on it.


For connecting to the Aperture Cloud-based controller, the endpoint must be a grpc/http2 address. Support for https fallback option is in the works.

More details about particular agent installation modes could be found in Get Started: Installation.

Configuration parameters for the FluxNinja Aperture Cloud extension are as follows:

See also

How various components interact with the extension: