github.com/m3db/m3@v1.5.1-0.20231129193456-75a402aa583b/src/msg/README.md (about)

     1  # M3Msg
     2  
     3  A partitioned message queueing, routing and delivery library designed for very small messages at very high speeds that don't require disk durability. This makes it quite useful for metrics ingestion pipelines.
     4  
     5  ## m3msg writer
     6  
     7  Messages are written in the following manner:
     8  1. Write to the public `Writer` in `writer.go`, which acquires read lock on writer (can be concurrent).
     9  2. That writes to all registered `consumerServiceWriter` writers (one per downstream service) in a sequential loop, one after another.
    10  3. The `consumerServiceWriter` selects a shard by asking message what shard it is and writes immediately to that shard's `shardWriter`, without taking any locks in any of this process (should check for out of bounds of the shard in future).
    11  4. The `shardWriter` then acquires a read lock and writes it to a `messageWriter`.
    12  5. The `messageWriter` then acquires a write lock on itself and pushes the message onto a queue.
    13  6. The `messageWriter` has a background routine that periodically acquires it's writeLock and scans the queue for new writes to forward to downstream consumers.
    14  7. If `messageWriter` is part of a `sharedShardWriter` it will have many downstream consumer instances. Otherwise, if it's part of a `replicatedShardWriter` there
    15  is only one consumer instance at a time.
    16  6. The `consumerWriter` (one per downstream consumer instance) then takes a write lock for the connection index selected every write that it receives. The `messageWriter` selects the connection index based on the shard ID so that shards should balance the connection they ultimately use to send data downstream to instances (so IO is not blocked on a per downstream instance).