This directory contains example applications utilizing librdkafka.
The examples are built by running make
and they will be be linked
statically or dynamically to librdkafka in the parent ../src
directory.
Begin with the following examples:
- consumer.c - a typical C high-level consumer application.
- producer.c - a typical C producer application.
- producer.cpp - a typical C++ producer application.
- idempotent_producer.c - Idempotent producer.
- transactions.c - Full exactly once semantics (EOS) transactional consumer-producer exammple. Requires Apache Kafka 2.5 or later.
- transactions-older-broker.c - Same as
transactions.c
but for Apache Kafka versions 2.4.x and older which lack KIP-447 support. - misc.c - a collection of miscellaneous usage examples.
For more complex uses, see:
- rdkafka_example.c - simple consumer, producer, metadata listing, kitchen sink, etc.
- rdkafka_example.cpp - simple consumer, producer, metadata listing in C++.
- rdkafka_complex_consumer_example.c - a more contrived high-level C consumer example.
- rdkafka_complex_consumer_example.cpp - a more contrived high-level C++ consumer example.
- rdkafka_consume_batch.cpp - batching high-level C++ consumer example.
- rdkafka_performance.c - performance, benchmark, latency producer and consumer tool.
- kafkatest_verifiable_client.cpp - for use with the official Apache Kafka client system tests.
- openssl_engine_example.cpp - metadata listing in C++ over SSL channel established using OpenSSL engine.
For Admin API examples see:
- delete_records.c - Delete records.
- list_consumer_groups.c - List consumer groups.
- describe_consumer_groups.c - Describe consumer groups.
- describe_topics.c - Describe topics.
- describe_cluster.c - Describe cluster.
- list_consumer_group_offsets.c - List offsets of a consumer group.
- alter_consumer_group_offsets.c - Alter offsets of a consumer group.
- incremental_alter_configs.c - Incrementally alter resource configurations.
- user_scram.c - Describe or alter user SCRAM credentials.