We are hiring! Apply here

Producers are applications that “produce” streaming data. These applications may be monitoring the status of a system, collecting sensor data, watching traffic to a website, or otherwise observing events in some way. Producers may be general-purpose tools such as the Fluvio CLI, or they may be special-purpose programs built to meet a specific need, in which case the producer program would leverage one of the programmatic APIs. Let’s talk about the core concepts that producers deal with in order to better understand how they work.


Records, Topics, and Partitions

In order to understand producers, we need to have a good idea about the data they interact with (records), the means by which they logically organize that data (topics), and the strategies they use in order to efficiently distribute and process that data (partitions). These are general ideas seen in many streaming systems, but we’re going to review them in case you’re not familiar with them.



A Record is simply a piece of data that is indexed and stored for later use. In streaming applications, a record typically communicates the fact that a particular event has occurred, such as a measurement being taken by a sensor, or a button click in a mobile app. Any given record belongs to exactly one topic and one partition, and when it is stored it is assigned an offset, which is the absolute position of the record within it’s parent partition.

In addition to carrying arbitrary data, records may optionally be created with a key. Record keys are used in order to determine which partition within a topic the record should be sent to. The golden rule is: any two records with the same key are always sent to the same partition. If a record does not have a key, it is assigned to a partition based on some configured strategy, such as round-robin.



As we have alluded to, Topics are a tool for organizing records in a streaming system. You can think of a topic as the streaming equivalent of a table in a database. These are typically created by the cluster administrator rather than an application. Each time you produce a record, you must specify a topic for it to be sent to. Topics may be used to keep different types of records separate from one another, and be organized in a way that aligns nicely with your application’s domain model.

In addition to logically separating records, topics may be individually configured with parameters to tune the performance and semantics of record delivery. Two notable parameters are the number of partitions the topic has as well as the replication factor, which describes the minimum number of copies of the data in the topic that must be maintained at all times.



Partitions are a mechanism by which the load of traffic to and from a given topic may be distributed and balanced between many machines. A single partition is a concrete, ordered log that is stored to disk. As a log, each record stored in a partition is given an offset, starting from zero and monotonically increasing by one for each new record. Once a record is committed to a partition and an offset is assigned to it, that offset (in that partition) will always refer to that record - it is a permanent assignment. Because of this, all records that are sent to a given partition are guaranteed to remain ordered in the order they were committed.

There are a few important observations to note about the behavior of partitions based on the properties we just covered:

  • When a record is assigned an offset, that offset permanently identifies that record, but this does not necessarily mean that the record will always be available. Topics generally define a retention policy, which describes how long records will be retained. If a record lives beyond its retention policy, it may be deleted to make space for other data. However, the offset that identified that record will never be reused for another record.
  • It is important to grasp that strong record ordering guarantees only apply for records within a single partition. If records are sent to two different partitions in the same topic, there is no way to establish ordering between the records living in the distinct partitions. For this reason, it is important to select a key for your records based on your ordering needs. Since records with the same key are always assigned to the same partition, any records that share a key will always be totally ordered with respect to each other.


Fluvio producer tries to send records in batches to reduce the number of messages sent and improve throughput. A producer has some configurations that can be set to improve performance for a specific use case. For instance, they can be used to reduce disk usage, reduce latency, improve throughput, among other reasons. As of today, batching behavior in Fluvio Producer can be modified with the following configurations:

  • batch_size: Indicates the maximum amount of bytes that can be accumulated in a batch.
  • linger: Time to wait before sending messages to the server. Defaults to 100 ms.
  • compression: Compression algorithm used by the producer to compress each batch before sending it to the SPU. Supported compression algorithms are none, gzip, snappy and lz4.

In general, each one of these configurations has a benefit and a potential drawback. For instance, with the compression algorithm, it is a trade-off between disk usage in the server and CPU usage in the producer and the consumer for compression and decompression. Typically, the compression ratio is improved when the payload is large, therefore a larger batch_size could be used to improve the compression ratio. A linger equals 0 means that each record is sent as soon as possible. A linger time larger than zero introduces latency but improves throughput.

The ideal parameters for the batch_size, linger and compression depends on your application needs.


Delivery Semantics

The Internet, as well as other networks, is considered an unreliable communication channel. There can be delays or lost messages. The connection can be gone for some period of time. This aspect affects records delivery reliability between Fluvio Producer and the SPU. To control that, Fluvio Producer has a delivery_semantic configuration option, which allows choosing a delivery mechanism. Each mechanism has a different trade-off between reliability and performance. There are two delivery semantics currently supported by Fluvio Producer: at-most-once and at-least-once.


At Most Once

at-most-once delivery means that for each record handed to Fluvio Producer, that record is delivered zero or one times; in more casual terms it means that messages may be lost. Fluvio Producer sends the message with records to the SPU and does not wait for the response. Consider it as fire and forget approach. This delivery method has higher throughput but no any guarantees if the message is delivered.

Producer Isolation has no effect if this delivery semantic is used unless the user explicitly waits for the response, as shown in the following snippet:

let fluvio = Fluvio::connect().await?;
let config = TopicProducerConfigBuilder::default()
let producer = fluvio.topic_producer_with_config("greetings", config).await?;
let output = producer.send("Hello", "Fluvio!").await?;
output.wait().await?; // wait for the response, considering `Isolation` as well

At Least Once

at-least-once delivery means that for each record handed to the Fluvio Producer potentially multiple attempts are made at delivering it, such that at least one succeeds; again, in more casual terms this means that messages may be duplicated but not lost. Fluvio Producer sends the message with records to the SPU, waits for the response and re-send in case of transport errors occur. This delivery method has lower throughput comparing to at-most-once but better total reliability.

There are three main parameters that one should consider using at-least-one semantic: maximum amount of retries, the time distribution (fixed, Fibonacci or exponential) of delays between them, and maximum timeout for all attempts.


let policy = RetryPolicy {
    max_retries: 5,
    initial_delay: Duration::from_millis(10),
    max_delay: Duration::from_sec(2),
    timeout: Duration::from_sec(10),
    strategy: RetryStrategy::ExponentialBackoff
let config = TopicProducerConfigBuilder::default()
let producer = fluvio.topic_producer_with_config("greetings", config).await?;

In the above example, Fluvio Producer retries at most five times; all retries take a maximum of 10 seconds. The delay time distribution is exponential. The first delay is 10ms, the second is 100ms, then 1000ms, and all others are 2000ms as it’s defined as a maximum allowed delay.


Start Producing

In order to get started with producing streaming data, you’ll need to: