System properties reference

This is a reference of all available system properties that can be set for an Astra application, and recommended values.

astra.bulkIngest.producerSleepMs

experimental

How long Astra will wait before starting the next bulk batch if the last batch was empty.

-Dastra.bulkIngest.producerSleepMs=50

defaultValue: 50

astra.bulkIngest.useKafkaTransactions

experimental

The preprocessor can write documents to kafka using transactions. Enable this to ensure that all documents are written using exactly once semantics and all kafka brokers for a partition acknowledge a write. Defaults to false.

-Dastra.bulkIngest.useKafkaTransactions=true

astra.concurrent.query

experimental

The amount of concurrent queries that are permitted at the application level.

-Dastra.concurrent.query=4

defaultValue:

Runtime.getRuntime().availableProcessors() - 1

astra.s3CrtBlobFs.maxNativeMemoryLimitBytes

experimental

Sets the max allowable off-heap consumption of the AWS CRT client.

-Dastra.s3CrtBlobFs.maxNativeMemoryLimitBytes=1073741824

defaultValue:

// Default to 5% of the heap size for the max crt off-heap or 1GiB (min for client)
long jvmMaxHeapSizeBytes = Runtime.getRuntime().maxMemory();
long defaultCrtMemoryLimit = Math.max(Math.round(jvmMaxHeapSizeBytes * 0.05), 1073741824);

astra.recovery.maxRolloverMins

experimental

Maximum allowable time before a recovery task is failed and reintroduced into the processing pipeline.

-Dastra.recovery.maxRolloverMins=90

defaultValue: 90

astra.query.schemaTimeoutMs

experimental

Maximum amount of time before timing out individual indexer schema queries and returning the aggregate of returned schema.

defaultValue: 500

astra.mapping.totalFieldsLimit

experimental

Maximum amount of total fields used by the mapper service for query parsing.

defaultValue: 2500

astra.mapping.dynamicFieldsLimit

experimental

Maximum amount of dynamic fields indexed in indexer when building a schema.

Should be lower than astra.mapping.totalFieldsLimit to account for required fields and schema fields.

defaultValue: 1500