Python consumer in Kafka - Commands & Configuration

Introduction

When you want to read messages from a Kafka topic using Python, you use a Python consumer. It connects to Kafka, listens for new messages, and processes them one by one. This helps your app react to data or events in real time.

When you want to process user activity logs sent to Kafka in real time.

When you need to read sensor data from Kafka and store it in a database.

When your app must react immediately to new orders placed and sent to Kafka.

When you want to build a dashboard that updates live with Kafka messages.

When you want to test consuming messages from a Kafka topic during development.

Commands

This command installs the Confluent Kafka Python client library needed to create a Kafka consumer.

Terminal

pip install confluent-kafka

Expected Output

Collecting confluent-kafka

  Downloading confluent_kafka-2.1.1-cp39-cp39-manylinux2014_x86_64.whl (1.4 MB)

Installing collected packages: confluent-kafka

Successfully installed confluent-kafka-2.1.1

Runs the Python script that connects to Kafka, subscribes to the topic 'example-topic', and prints messages as they arrive.

Terminal

python kafka_consumer.py

Expected Output

Received message: Hello Kafka!

Received message: Another message

Received message: Last message

Key Concept

If you remember nothing else from this pattern, remember: the Python consumer connects to Kafka, subscribes to topics, and continuously polls for new messages to process.

Code Example

Kafka

from confluent_kafka import Consumer, KafkaException

config = {
    'bootstrap.servers': 'localhost:9092',
    'group.id': 'my-group',
    'auto.offset.reset': 'earliest'
}

consumer = Consumer(config)
consumer.subscribe(['example-topic'])

try:
    while True:
        msg = consumer.poll(1.0)  # Wait up to 1 second for a message
        if msg is None:
            continue
        if msg.error():
            raise KafkaException(msg.error())
        print(f"Received message: {msg.value().decode('utf-8')}")
        consumer.commit(asynchronous=False)
except KeyboardInterrupt:
    pass
finally:
    consumer.close()

Common Mistakes

Not installing the confluent-kafka library before running the consumer script.

The script will fail with ModuleNotFoundError because the Kafka client library is missing.

Run 'pip install confluent-kafka' before running the consumer script.

Not calling consumer.poll() or consumer.consume() in a loop to fetch messages.

Without polling, the consumer will not receive any messages and appear stuck.

Use a loop that calls consumer.poll() or consumer.consume() repeatedly to get messages.

Not committing offsets after processing messages.

Kafka will resend the same messages on restart, causing duplicate processing.

Call consumer.commit() after processing messages to save the read position.

Summary

Install the Confluent Kafka Python client with pip before running your consumer.

Write a Python script that creates a Consumer, subscribes to a topic, and polls for messages in a loop.

Process each message and commit offsets to avoid duplicate processing on restart.

Practice

1.

What is the main purpose of a Python Kafka consumer?

easy

A. To create Kafka topics automatically

B. To send messages to Kafka topics

C. To read messages from Kafka topics and process them in Python

D. To monitor Kafka server health

Solution

1. Step 1: Understand Kafka consumer role

   A Kafka consumer reads data from Kafka topics to use in applications.

2. Step 2: Differentiate from producer

   Producers send messages, consumers read them. Monitoring and topic creation are separate tasks.

3. Final Answer:

   To read messages from Kafka topics and process them in Python -> Option C

4. Quick Check:

   Consumer = reads messages [OK]

Hint: Consumers read, producers write messages in Kafka [OK]

Common Mistakes:

• Confusing consumer with producer
• Thinking consumer creates topics
• Assuming consumer monitors server

2.

Which of the following is the correct way to create a KafkaConsumer in Python to read from topic my_topic on localhost?

from kafka import KafkaConsumer
consumer = KafkaConsumer(_____)

easy

A. my_topic, bootstrap_servers='localhost:9092'

B. "my_topic", bootstrap='localhost:9092'

C. "my_topic", servers='localhost:9092'

D. "my_topic", bootstrap_servers='localhost:9092'

Solution

1. Step 1: Check KafkaConsumer parameters

   KafkaConsumer expects topic name as string and bootstrap_servers keyword argument.

2. Step 2: Identify correct syntax

   "my_topic", bootstrap_servers='localhost:9092' uses correct string for topic and correct keyword bootstrap_servers with proper value.

3. Final Answer:

   "my_topic", bootstrap_servers='localhost:9092' -> Option D

4. Quick Check:

   Correct syntax uses bootstrap_servers keyword [OK]

Hint: Use bootstrap_servers='host:port' exactly [OK]

Common Mistakes:

• Omitting quotes around topic name
• Using wrong keyword like servers or bootstrap
• Passing topic name without quotes

3.

What will be the output of this code snippet if the Kafka topic test has one message with value b'hello'?

from kafka import KafkaConsumer
consumer = KafkaConsumer("test", bootstrap_servers='localhost:9092', auto_offset_reset='earliest', group_id='group1')
for msg in consumer:
    print(msg.value.decode('utf-8'))
    break

medium

A. hello

B. b'hello'

C. msg.value

D. Error: decode method not found

Solution

1. Step 1: Understand message value type

   Kafka messages are bytes, so msg.value is b'hello'.

2. Step 2: Decode bytes to string

   Calling decode('utf-8') converts b'hello' to 'hello' string, which is printed.

3. Final Answer:

   hello -> Option A

4. Quick Check:

   Decoded bytes print string [OK]

Hint: Decode bytes with decode('utf-8') to get string [OK]

Common Mistakes:

• Printing raw bytes without decoding
• Trying to decode string instead of bytes
• Expecting b'hello' printed as string

4.

Identify the error in this Kafka consumer code snippet:

from kafka import KafkaConsumer
consumer = KafkaConsumer('topic1', bootstrap_servers='localhost:9092')
for message in consumer:
    print(message.value.decode())
consumer.close()

medium

A. decode() requires an encoding argument

B. The consumer.close() is called outside the loop and never reached

C. Missing group_id parameter in KafkaConsumer

D. The for loop should use consumer.poll() instead

Solution

1. Step 1: Analyze loop and close call

   The for loop on consumer is infinite; code never reaches consumer.close() after loop.

2. Step 2: Understand consumer.close() usage

   To close consumer properly, loop must break or use context manager; otherwise close() is unreachable.

3. Final Answer:

   The consumer.close() is called outside the loop and never reached -> Option B

4. Quick Check:

   Infinite loop blocks close() call [OK]

Hint: Infinite loops prevent code after them from running [OK]

Common Mistakes:

• Assuming decode() needs encoding argument
• Thinking group_id is mandatory
• Confusing poll() with iteration

5.

You want to consume messages from two Kafka topics topicA and topicB using one Python KafkaConsumer instance. Which code snippet correctly sets this up?

from kafka import KafkaConsumer
consumer = KafkaConsumer(_____)
for msg in consumer:
    print(f"Topic: {msg.topic}, Message: {msg.value.decode()}")

hard

A. ["topicA", "topicB"], bootstrap_servers='localhost:9092', auto_offset_reset='earliest', group_id='group1'

B. "topicA,topicB", bootstrap_servers='localhost:9092', group_id='group1'

C. "topicA" and "topicB", bootstrap_servers='localhost:9092'

D. "topicA"; "topicB", bootstrap_servers='localhost:9092', group_id='group1'

Solution

1. Step 1: Check how to subscribe to multiple topics

   KafkaConsumer accepts a list of topic names to subscribe to multiple topics.

2. Step 2: Verify correct syntax for multiple topics

   ["topicA", "topicB"], bootstrap_servers='localhost:9092', auto_offset_reset='earliest', group_id='group1' correctly passes a list ["topicA", "topicB"] and required parameters.

3. Final Answer:

   ["topicA", "topicB"], bootstrap_servers='localhost:9092', auto_offset_reset='earliest', group_id='group1' -> Option A

4. Quick Check:

   List of topics subscribes to multiple topics [OK]

Hint: Use list of topic names to consume multiple topics [OK]

Common Mistakes:

• Passing topics as comma-separated string
• Using logical operators like and or ; between topics
• Omitting group_id for consumer group