Skip to main content

Configuration Reference

All Analytics Engine configuration is provided via environment variables with the KS_AE_ prefix. For Docker, set these in the environment of the container. For Platform Manager, set these in $KS_HOME/conf/analytics-engine.properties.

The supplied package for this component contains conf/common.properties.template which lists all applicable configuration for this component along with their default values.

PropertyDefaultDescription
KS_AE_CURRENCYUSDCurrency this AE instance will service
KS_AE_INSTRUMENT_TOPIC_GROUPS[] (all)Instrument topic groups to subscribe to from Static Data Server
KS_STATIC_DATA_SERVER_TOPIC_SOURCEstatic-data-serverTopic source of the Static Data Server instance
KS_CURVE_ENGINE_TOPIC_SOURCEcurve-engineTopic source of the Curve Engine instance

KS_AE_CURRENCY

The currency this Analytics Engine instance will service. AE can only value bonds in a single currency per instance, due to the per-currency nature of the QuantLib valuation date.

Default: USD

KS_AE_CURRENCY=USD

To support multiple currencies, deploy one Analytics Engine instance per currency and configure each Price Engine instance to point at the correct AE via KS_ANALYTICS_ENGINE_TOPIC_SOURCE.

KS_AE_INSTRUMENT_TOPIC_GROUPS

Comma-separated list of topic groups to subscribe to from Static Data Server. Leave empty to subscribe to all instrument groups.

Default: (empty — all groups)

# Subscribe to all instruments
KS_AE_INSTRUMENT_TOPIC_GROUPS=

# Subscribe to USD bonds only
KS_AE_INSTRUMENT_TOPIC_GROUPS=BUSD

Instrument topicGroup follows the SDS convention — see Topic Structure for the full list of group prefixes.

Restricting the subscription reduces memory and startup time if AE only needs to service a subset of the instrument universe.

KS_STATIC_DATA_SERVER_TOPIC_SOURCE

The topicSource of the Static Data Server instance AE subscribes to for instruments, business dates, indices, and fixings.

Default: static-data-server

KS_STATIC_DATA_SERVER_TOPIC_SOURCE=static-data-server

KS_CURVE_ENGINE_TOPIC_SOURCE

The topicSource of the Curve Engine instance AE subscribes to for yield curves (used for floating rate bond pricing).

Default: curve-engine

KS_CURVE_ENGINE_TOPIC_SOURCE=curve-engine