Smile CDR v2024.05.PRE
On this page:
   45.21    Channel Retry 45.23    Cluster Manager Maintenance   

45.22.1Kafka

 

The Kafka configuration category includes the following configurable options:

  • Kafka Consumer Ack Mode

  • Kafka Consumer Auto Commit Enabled

  • Kafka Bootstrap Address

  • Kafka Consumer Config Properties (File)

  • Kafka Consumer Config Properties (Text)

  • Kafka Subscription Matcher Consumer Group Id

  • Kafka Producer Config Properties (File)

  • Kafka Producer Config Properties (Text)

  • Kafka Replace Hyphens With Periods

  • Kafka SASL JAAS Config

  • Kafka SASL Mechanism

  • Kafka Security Protocol

  • Kafka Broker SSL Enabled

  • Kafka SSL Key Password

  • Kafka SSL Keystore Location

  • Kafka Keystore Password

  • Kafka SSL TrustStore File Location

  • Kafka SSL Truststore Password

  • Validate Kafka Topics Exist Before Use

45.22.2Property: Kafka Consumer Ack Mode

 
Property Name Kafka Consumer Ack Mode
Property Key
Property Type ENUM
Values
  • RECORD
  • BATCH
  • TIME
  • COUNT
  • COUNT_TIME
  • MANUAL
  • MANUAL_IMMEDIATE
Description Kafka consumer listener container offset commit behavior. This value is only used if Kafka Auto Commit is false. By default, cdr kafka consumers manually acknowledge every successful message processing back to the Kafka broker. This ensures that no message is ever processed twice. However it adds processing overhead. If downstream consumers can process the same message twice, then it is recommended to set kafka.auto_commit to true (in which case the kafka.ack_mode property will be ignored). See Committing Offsets for a list of options.
Applies to Modules
  • Cluster Manager
Default Value MANUAL
Example Property
module.[MODULE_ID].config.kafka.ack_mode = MANUAL

45.22.3Property: Kafka Consumer Auto Commit Enabled

 
Property Name Kafka Consumer Auto Commit Enabled
Property Key
Property Type BOOLEAN
Description If this property is set to true, Kafka auto-commits the offsets according to its configuration. If it is false, the Kafka Consumer Ack Mode is used to determine commit behavior. See Committing Offsets
Applies to Modules
  • Cluster Manager
Default Value false
Example Property
module.[MODULE_ID].config.kafka.auto_commit = false

45.22.4Property: Kafka Bootstrap Address

 
Property Name Kafka Bootstrap Address
Property Key
Property Type STRING
Description This is a comma-separated list of host and port pairs that are the addresses of the Kafka brokers in a "bootstrap" Kafka cluster that a Kafka client connects to initially to bootstrap itself.
Applies to Modules
  • Cluster Manager
Default Value localhost:9092
Example Property
module.[MODULE_ID].config.kafka.bootstrap_address = localhost:9092

45.22.5Property: Kafka Consumer Config Properties (File)

 
Property Name Kafka Consumer Config Properties (File)
Property Key
Property Type Resource Path
Description If set, the Kafka Consumer Config properties listed in this file are used by all Kafka Consumers
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.consumer.properties.file = 

45.22.6Property: Kafka Consumer Config Properties (Text)

 
Property Name Kafka Consumer Config Properties (Text)
Property Key
Property Type STRING
Description If set, the Kafka Consumer Config properties provided here are used by all Kafka Consumers
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.consumer.properties.text = 

45.22.7Property: Kafka Subscription Matcher Consumer Group Id

 
Property Name Kafka Subscription Matcher Consumer Group Id
Property Key
Property Type STRING
Description The name of the kafka consumer group id used by all Kafka subscription consumers.
Applies to Modules
  • Cluster Manager
Default Value smilecdr
Example Property
module.[MODULE_ID].config.kafka.group_id = smilecdr

45.22.8Property: Kafka Producer Config Properties (File)

 
Property Name Kafka Producer Config Properties (File)
Property Key
Property Type Resource Path
Description If set, the Kafka Producer Config properties listed in this file are used by all Kafka Producers
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.producer.properties.file = 

45.22.9Property: Kafka Producer Config Properties (Text)

 
Property Name Kafka Producer Config Properties (Text)
Property Key
Property Type STRING
Description If set, the Kafka Producer Config properties provided here are used by all Kafka Producers
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.producer.properties.text = 

45.22.10Property: Kafka Replace Hyphens With Periods

 
Property Name Kafka Replace Hyphens With Periods
Property Key
Property Type BOOLEAN
Description If enabled, hyphens (-) contained in Smile-generated channel names will be replaced with periods (.). Note that any user defined channel names (i.e. Channel Import and Realtime Export) will not be affected by this setting.
Applies to Modules
  • Cluster Manager
Default Value true
Example Property
module.[MODULE_ID].config.kafka.replace_hyphens_with_periods = true

45.22.11Property: Kafka SASL JAAS Config

 
Property Name Kafka SASL JAAS Config
Property Key
Property Type PASSWORD
Description If the Kafka Security Protocol is set to use SASL, specifies the associated JAAS configuration string.
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.sasl.jaas.config = 

45.22.12Property: Kafka SASL Mechanism

 
Property Name Kafka SASL Mechanism
Property Key
Property Type STRING
Description If the Kafka Security Protocol is set to use SASL, specifies the associated mechanism to use.
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.sasl.mechanism = 

45.22.13Property: Kafka Security Protocol

 
Property Name Kafka Security Protocol
Property Key
Property Type ENUM
Values
  • PLAINTEXT
  • SSL
  • SASL_PLAINTEXT
  • SASL_SSL
Description The Kafka Security Protocol to use.
Applies to Modules
  • Cluster Manager
Default Value PLAINTEXT
Example Property
module.[MODULE_ID].config.kafka.security.protocol = PLAINTEXT

45.22.14Property: Kafka Broker SSL Enabled

 
Property Name Kafka Broker SSL Enabled
Property Key
Property Type BOOLEAN
Description Enable this if your Kafka Broker requires SSL
Applies to Modules
  • Cluster Manager
Default Value false
Example Property
module.[MODULE_ID].config.kafka.ssl.enabled = false

45.22.15Property: Kafka SSL Key Password

 
Property Name Kafka SSL Key Password
Property Key
Property Type PASSWORD
Description The Password for your SSL Key
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.ssl.key.password = 

45.22.16Property: Kafka SSL Keystore Location

 
Property Name Kafka SSL Keystore Location
Property Key
Property Type STRING
Description The location on disk of your Kafka keystore file
Applies to Modules
  • Cluster Manager
Default Value keystore/server.keystore.jks
Example Property
module.[MODULE_ID].config.kafka.ssl.keystore.location = keystore/server.keystore.jks

45.22.17Property: Kafka Keystore Password

 
Property Name Kafka Keystore Password
Property Key
Property Type PASSWORD
Description The password of your SSL Keystore file
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.ssl.keystore.password = 

45.22.18Property: Kafka SSL TrustStore File Location

 
Property Name Kafka SSL TrustStore File Location
Property Key
Property Type STRING
Description The location on disk of your kafka TrustStore file
Applies to Modules
  • Cluster Manager
Default Value keystore/server.truststore.jks
Example Property
module.[MODULE_ID].config.kafka.ssl.truststore.location = keystore/server.truststore.jks

45.22.19Property: Kafka SSL Truststore Password

 
Property Name Kafka SSL Truststore Password
Property Key
Property Type PASSWORD
Description The password of your SSL Truststore file
Applies to Modules
  • Cluster Manager
Default Value (no default)
Example Property
module.[MODULE_ID].config.kafka.ssl.truststore.password = 

45.22.20Property: Validate Kafka Topics Exist Before Use

 
Property Name Validate Kafka Topics Exist Before Use
Property Key
Property Type BOOLEAN
Description Set this to true if your Kafka broker is configured to prevent new topics from being automatically created (e.g. if 'auto.create.topics.enable' is set to false on the broker). When this property is set to true, Smile will prevent subscriptions from being created or updated if the delivery topic they depend on doesn't exist yet.
Applies to Modules
  • Cluster Manager
Default Value false
Example Property
module.[MODULE_ID].config.kafka.validate_topics_exist_before_use = false
   45.21    Channel Retry 45.23    Cluster Manager Maintenance