Camel K

Keda Trait

The KEDA trait allows you to configure KEDA autoscalers to scale up and down based of events.

This trait is available in the following profiles: Kubernetes, Knative, OpenShift.

Configuration

Trait properties can be specified when running any integration with the CLI:

$ kamel run --trait keda.[key]=[value] --trait keda.[key2]=[value2] integration.yaml

The following configuration options are available:

Property Type Description

Property	Type	Description
`keda.enabled`	`bool`	Can be used to enable or disable a trait. All traits share this common property.
`keda.pollingInterval`	`int32`	Interval (seconds) to check each trigger on.
`keda.cooldownPeriod`	`int32`	The wait period between the last active trigger reported and scaling the resource back to 0.
`keda.idleReplicaCount`	`int32`	Enabling this property allows KEDA to scale the resource down to the specified number of replicas.
`keda.minReplicaCount`	`int32`	Minimum number of replicas.
`keda.maxReplicaCount`	`int32`	Maximum number of replicas.
`keda.triggers`	`[]github.com/apache/camel-k/v2/pkg/apis/camel/v1/trait.KedaTrigger`	Definition of triggers according to the KEDA format. Each trigger must contain `type` field corresponding to the name of a KEDA autoscaler and a key/value map named `metadata` containing specific trigger options and optionally a mapping of secrets, used by Keda operator to poll resources according to the autoscaler type.
`keda.auto`	`bool`	Automatically discover KEDA triggers from Camel component URIs.
`keda.autoMetadata`	`map[string]map[string]string`	Additional metadata to merge into auto-discovered triggers. Keys are trigger types (e.g., "kafka"), values are maps of metadata key-value pairs to merge (e.g., {"lagThreshold": "10"}).

keda.enabled

bool

Can be used to enable or disable a trait. All traits share this common property.

keda.pollingInterval

int32

Interval (seconds) to check each trigger on.

keda.cooldownPeriod

int32

The wait period between the last active trigger reported and scaling the resource back to 0.

keda.idleReplicaCount

int32

Enabling this property allows KEDA to scale the resource down to the specified number of replicas.

keda.minReplicaCount

int32

Minimum number of replicas.

keda.maxReplicaCount

int32

Maximum number of replicas.

keda.triggers

[]github.com/apache/camel-k/v2/pkg/apis/camel/v1/trait.KedaTrigger

Definition of triggers according to the KEDA format. Each trigger must contain type field corresponding to the name of a KEDA autoscaler and a key/value map named metadata containing specific trigger options and optionally a mapping of secrets, used by Keda operator to poll resources according to the autoscaler type.

keda.auto

bool

Automatically discover KEDA triggers from Camel component URIs.

keda.autoMetadata

map[string]map[string]string

Additional metadata to merge into auto-discovered triggers. Keys are trigger types (e.g., "kafka"), values are maps of metadata key-value pairs to merge (e.g., {"lagThreshold": "10"}).

the variable names are "snake case" if you’re using in kamel CLI, for example trait.myParam has to be translated as -t trait.my-param

Automatic scaler discovery

When keda.auto is enabled, Camel K inspects the consumer endpoints in an Integration and creates KEDA triggers for components with a registered scaler mapping. A scaler is the KEDA adapter that reads metrics from an external system and uses them to determine when a workload should scale. See the KEDA scaler concepts documentation for more information.

Automatic discovery currently supports the following Camel component:

kafka: creates an Apache Kafka trigger from the topic, broker, and consumer-group values in the endpoint URI. See the KEDA Apache Kafka scaler documentation for the available trigger metadata.

Unsupported Camel components do not produce an automatically discovered trigger. You can still configure their KEDA triggers explicitly with keda.triggers.