| Repos | \ndragonflydb/dragonfly | \n
|---|---|
| Views | \n![\"views\"](\"https://views.whatilearened.today/views/github/dragonflydb/dragonfly.svg\") | \n
| Stars | \n![\"stars\"](\"https://img.shields.io/github/stars/dragonflydb/dragonfly?color=f2f08d&logo=Undertale&logoColor=eb4630\") | \n
| Forks | \n![\"forks\"](\"https://img.shields.io/github/forks/dragonflydb/dragonfly?color=ba86eb&logo=Handshake&logoColor=ea6aa6\") | \n
| License | \n![\"license\"](\"https://img.shields.io/badge/L-NONE-blue?logo=unlicense\"){kind=icon} | \n
| UpdatedAt | \n![\"last-commit\"](\"https://img.shields.io/github/last-commit/dragonflydb/dragonfly?display_timestamp=committer&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAYAAAA7MK6iAAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHUlEQVR4nLVX7U9aVxwm26dlX%2Fdhbx%2B2%2FQnbkvUbrdUAQgJJIfUDNWDTTmOv1FQUFaPJ4kusrV01Jt1sNpctS2u3botZtmxd9tJSFSoqKqIF5bYDFLCovClefstzJ8wXRLDZLznkcO4557n3d3%2FneZ4rEOQZt1WqF%2B8XFr4%2BfOLEe2joY0zwf8ToyZPvjEgkLY%2Bk0mmrXO6dKinxzGk0fjT0x%2BRyr0UqncYczM1rc4tQ%2BIrp2LGXdo4NC4VvWqTS72wqlc%2Br13ORri6KdXdnbOHLlwlzJpRKn6W4%2BK6poOCNnIAfHj%2F%2BwahIZB4vKnqZf0qJpNIql%2Fv8TU0cNl5rbyc3w0QnTp3y2LTaJ7M1NaxDr2fRn1SpPG6Gia21tfE34TcaOay1iMUVOQFbFYqIWSo1W8TiAVanC0evXOEB7Wp14HFb22zE5fqLOC5ERLQWidNaNI4uEcc9i7hcJldHh2NWrQ5gDdbOlpaumIuLb2atAQDPnz0b8NbWcmxVVRJ3HmxpScwwzOJmKDRGe8LlCZDLG9g7TInV1Ql7dbXbV1e3gT0WKirCFomkPyvwXFlZGJOjV6%2BSt64uudDZOU5EUcox%2FMEQDVvt6MbcN27Y3Ayzhv3spaUrB6Z9qrJSO19ezj8p2pLBkJy%2BcCHJxWI5gW5tcfRRz1dU19GfGkou9PZO4smR9jGFwpex4Dy3bvnmKypotbU13VidjqYZhrj49rvMEt%2F%2FYqLz9d00NjW%2Fczgyo9O51zs6aNlo5FDtu0DZgQFhlGXJ0dBADoNhd6uvp6Whoayg7N9LVGH8mD4b%2FHnftUQoNG4vLQ0gixMqlW%2B4qOjtNHDg3r1f6YiRSGxRy7UvqLb9U4qkqnxPONva5lDpHr1%2ByyKRNKWBZy5edMUHB2m5ry%2B%2BEQw%2Bzgf4zo9%2F0ocN3WRzLBw4J%2BJyPWCrqmIgGYtUOsWD4oxZFQoPUjGpVHqI4%2FafkQPC6fZQeeM1%2BvLuIQnjuBWQDDCscrmHP9eoNPAtBqfOnXuaK%2Bh6JEbGrs%2BpvvMmxeIbh863abVPeYySEo9FJHpNMFJY%2BP5cWZkfg7O1tSwYCeSQLTY3E8Q09%2FBVPJUlxQjshT1BscCY02r9UDUBfvCHB66pcfPA3lyAe3ngr3%2F47XDgaJzsly7xwA6NZtlUUPCuAHqaSjUIP%2Bsue8BRWAC%2FNfQ7JZPZ59s0Gj7VtpISz4hQ%2BCpfXGMKhZcvLpUKxfWM8ohvf7p%2FODjHBfcVF8Isk82g1FHykcVFE%2BUZAAX47aE%2FMl4PO50Pnuh0%2Fx4nmcyWPsdwDhBx6CmkLV%2FgFDjYKxOJOFtb0wQyIhL9RyCwK3AOfIGp1YFEBhnMJcLRWEbKdKQoU6ncTZkIEDicAy%2F81dVuEM5RwPfey4xOx0Ik%2FI2NnFki%2BWafOoFIYFcgYZCyxd7eCUjbc4AmF65ft%2FkMhk3o%2B5hc7sMJyqjJEGvYFaQFIr7Y0wPw8BFAY%2B6%2Bvmk3w6zzRuDMmZVRsfh8RtA0uETSD7uCBT6DYQN6iveU0fpkYLjE6qrVrtOxeNKU9THLZJ9kBU2JBsBhV5AivB%2FoKaQNKgPCBwDYaIfZC4adThOqF4WENViLJwVoXobfLBKVw67AOaTsLc65TaVK21vQ4La99eKcYg5vbxsbObzTQ9N7UKDgUO1wDjiDIIBshh5ztg39nQMLSZBH4OzBOUDEQXm206d3fcLgswbXQA4PhcK3nhswU1Bz8wvQ09RHG%2FoYy3ejfwBNmtoYqLA0XgAAAABJRU5ErkJggg%3D%3D&label=UpdatedAt\") | \n
| CreatedAt | \n![\"create-at\"](\"https://img.shields.io/github/created-at/dragonflydb/dragonfly?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAYAAAA7MK6iAAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHUlEQVR4nLVX7U9aVxwm26dlX%2Fdhbx%2B2%2FQnbkvUbrdUAQgJJIfUDNWDTTmOv1FQUFaPJ4kusrV01Jt1sNpctS2u3botZtmxd9tJSFSoqKqIF5bYDFLCovClefstzJ8wXRLDZLznkcO4557n3d3%2FneZ4rEOQZt1WqF%2B8XFr4%2BfOLEe2joY0zwf8ToyZPvjEgkLY%2Bk0mmrXO6dKinxzGk0fjT0x%2BRyr0UqncYczM1rc4tQ%2BIrp2LGXdo4NC4VvWqTS72wqlc%2Br13ORri6KdXdnbOHLlwlzJpRKn6W4%2BK6poOCNnIAfHj%2F%2BwahIZB4vKnqZf0qJpNIql%2Fv8TU0cNl5rbyc3w0QnTp3y2LTaJ7M1NaxDr2fRn1SpPG6Gia21tfE34TcaOay1iMUVOQFbFYqIWSo1W8TiAVanC0evXOEB7Wp14HFb22zE5fqLOC5ERLQWidNaNI4uEcc9i7hcJldHh2NWrQ5gDdbOlpaumIuLb2atAQDPnz0b8NbWcmxVVRJ3HmxpScwwzOJmKDRGe8LlCZDLG9g7TInV1Ql7dbXbV1e3gT0WKirCFomkPyvwXFlZGJOjV6%2BSt64uudDZOU5EUcox%2FMEQDVvt6MbcN27Y3Ayzhv3spaUrB6Z9qrJSO19ezj8p2pLBkJy%2BcCHJxWI5gW5tcfRRz1dU19GfGkou9PZO4smR9jGFwpex4Dy3bvnmKypotbU13VidjqYZhrj49rvMEt%2F%2FYqLz9d00NjW%2Fczgyo9O51zs6aNlo5FDtu0DZgQFhlGXJ0dBADoNhd6uvp6Whoayg7N9LVGH8mD4b%2FHnftUQoNG4vLQ0gixMqlW%2B4qOjtNHDg3r1f6YiRSGxRy7UvqLb9U4qkqnxPONva5lDpHr1%2ByyKRNKWBZy5edMUHB2m5ry%2B%2BEQw%2Bzgf4zo9%2F0ocN3WRzLBw4J%2BJyPWCrqmIgGYtUOsWD4oxZFQoPUjGpVHqI4%2FafkQPC6fZQeeM1%2BvLuIQnjuBWQDDCscrmHP9eoNPAtBqfOnXuaK%2Bh6JEbGrs%2BpvvMmxeIbh863abVPeYySEo9FJHpNMFJY%2BP5cWZkfg7O1tSwYCeSQLTY3E8Q09%2FBVPJUlxQjshT1BscCY02r9UDUBfvCHB66pcfPA3lyAe3ngr3%2F47XDgaJzsly7xwA6NZtlUUPCuAHqaSjUIP%2Bsue8BRWAC%2FNfQ7JZPZ59s0Gj7VtpISz4hQ%2BCpfXGMKhZcvLpUKxfWM8ohvf7p%2FODjHBfcVF8Isk82g1FHykcVFE%2BUZAAX47aE%2FMl4PO50Pnuh0%2Fx4nmcyWPsdwDhBx6CmkLV%2FgFDjYKxOJOFtb0wQyIhL9RyCwK3AOfIGp1YFEBhnMJcLRWEbKdKQoU6ncTZkIEDicAy%2F81dVuEM5RwPfey4xOx0Ik%2FI2NnFki%2BWafOoFIYFcgYZCyxd7eCUjbc4AmF65ft%2FkMhk3o%2B5hc7sMJyqjJEGvYFaQFIr7Y0wPw8BFAY%2B6%2Bvmk3w6zzRuDMmZVRsfh8RtA0uETSD7uCBT6DYQN6iveU0fpkYLjE6qrVrtOxeNKU9THLZJ9kBU2JBsBhV5AivB%2FoKaQNKgPCBwDYaIfZC4adThOqF4WENViLJwVoXobfLBKVw67AOaTsLc65TaVK21vQ4La99eKcYg5vbxsbObzTQ9N7UKDgUO1wDjiDIIBshh5ztg39nQMLSZBH4OzBOUDEQXm206d3fcLgswbXQA4PhcK3nhswU1Bz8wvQ09RHG%2FoYy3ejfwBNmtoYqLA0XgAAAABJRU5ErkJggg%3D%3D&label=CreatedAt\") | \n
![](\"https://cdn.jsdelivr.net/gh/eryajf/tu@main/img/image_20240420_214408.gif\")
\n| Repos | \ndragonflydb/dragonfly | \n
|---|---|
| Views | \n | \n
| Stars | \n | \n
| Forks | \n | \n
| License | \n | \n
| UpdatedAt | \n | \n
| CreatedAt | \n | \n
\n\n \n ![\"Dragonfly\"](\"/.github/images/logo-full.svg\"){kind=logo}
\n \n
![\"ci-tests\"](\"https://github.com/dragonflydb/dragonfly/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n\n\nBefore moving on, please consider giving us a GitHub star ⭐️. Thank you!
\n
Website • Docs • Quick Start • Community Discord • Dragonfly Forum • Join the Dragonfly Community
\nGitHub Discussions • GitHub Issues • Contributing • Dragonfly Cloud
\nDragonfly is an in-memory data store built for modern application workloads.
\nFully compatible with Redis and Memcached APIs, Dragonfly requires no code changes to adopt. Compared to legacy in-memory datastores, Dragonfly delivers 25X more throughput, higher cache hit rates with lower tail latency, and can run on up to 80% less resources for the same sized workload.
\nWe first compare Dragonfly with Redis on m5.large instance which is commonly used to run Redis
\ndue to its single-threaded architecture. The benchmark program runs from another
\nload-test instance (c5n) in the same AZ using memtier_benchmark -c 20 --test-time 100 -t 4 -d 256 --distinct-client-seed
Dragonfly shows a comparable performance:
\n![\"Twitter](\"https://img.shields.io/twitter/follow/dragonflydbio?style=social\")
--ratio 1:0):| Redis | \nDF | \n
|---|---|
| QPS: 159K, P99.9: 1.16ms, P99: 0.82ms | \nQPS:173K, P99.9: 1.26ms, P99: 0.9ms | \n
| \n | \n |
--ratio 0:1):| Redis | \nDF | \n
|---|---|
| QPS: 194K, P99.9: 0.8ms, P99: 0.65ms | \nQPS: 191K, P99.9: 0.95ms, P99: 0.8ms | \n
The benchmark above shows that the algorithmic layer inside DF that allows it to scale vertically
\ndoes not take a large toll when running single-threaded.
However, if we take a bit stronger instance (m5.xlarge), the gap between DF and Redis starts growing.
\n(memtier_benchmark -c 20 --test-time 100 -t 6 -d 256 --distinct-client-seed):
--ratio 1:0):| Redis | \nDF | \n
|---|---|
| QPS: 190K, P99.9: 2.45ms, P99: 0.97ms | \nQPS: 279K , P99.9: 1.95ms, P99: 1.48ms | \n
--ratio 0:1):| Redis | \nDF | \n
|---|---|
| QPS: 220K, P99.9: 0.98ms , P99: 0.8ms | \nQPS: 305K, P99.9: 1.03ms, P99: 0.87ms | \n
Dragonfly throughput capacity continues to grow with instance size,
\nwhile single-threaded Redis is bottlenecked on CPU and reaches local maxima in terms of performance.
If we compare Dragonfly and Redis on the most network-capable instance c6gn.16xlarge,
\nDragonfly showed a 25X increase in throughput compared to Redis single process, crossing 3.8M QPS.
Dragonfly's 99th percentile latency metrics at its peak throughput:
\n| op | \nr6g | \nc6gn | \nc7g | \n
|---|---|---|---|
| set | \n0.8ms | \n1ms | \n1ms | \n
| get | \n0.9ms | \n0.9ms | \n0.8ms | \n
| setex | \n0.9ms | \n1.1ms | \n1.3ms | \n
All benchmarks were performed using memtier_benchmark (see below) with number of threads tuned per server and instance type. memtier was run on a separate c6gn.16xlarge machine. We set the expiry time to 500 for the SETEX benchmark to ensure it would survive the end of the test.
![](\"http://static.dragonflydb.io/repo-assets/aws-throughput.svg\")
memtier_benchmark --ratio ... -t <threads> -c 30 -n 200000 --distinct-client-seed -d 256 \\\n --expiry-range=...In pipeline mode --pipeline=30, Dragonfly reaches 10M QPS for SET and 15M QPS for GET operations.
We compared Dragonfly with Memcached on a c6gn.16xlarge instance on AWS.
\nWith a comparable latency, Dragonfly throughput outperformed Memcached throughput in both write and read workloads. Dragonfly demonstrated better latency in write workloads due to contention on the write path in Memcached.
\n| Server | \nQPS(thousands qps) | \nlatency 99% | \n99.9% | \n
|---|---|---|---|
| Dragonfly | \n🟩 3844 | \n🟩 0.9ms | \n🟩 2.4ms | \n
| Memcached | \n806 | \n1.6ms | \n3.2ms | \n
| Server | \nQPS(thousands qps) | \nlatency 99% | \n99.9% | \n
|---|---|---|---|
| Dragonfly | \n🟩 3717 | \n1ms | \n2.4ms | \n
| Memcached | \n2100 | \n🟩 0.34ms | \n🟩 0.6ms | \n
Memcached exhibited lower latency for the read benchmark, but also lower throughput.
\nTo test memory efficiency, we filled Dragonfly and Redis with ~5GB of data using the debug populate 5000000 key 1024 command, sent update traffic with memtier, and kicked off the snapshotting with the bgsave command.
This figure demonstrates how each server behaved in terms of memory efficiency.
\nDragonfly was 30% more memory efficient than Redis in the idle state and did not show any visible increase in memory use during the snapshot phase. At peak, Redis memory use increased to almost 3X that of Dragonfly.
\nDragonfly finished the snapshot faster, within a few seconds.
\nFor more info about memory efficiency in Dragonfly, see our Dashtable doc.
\nDragonfly supports common Redis arguments where applicable. For example, you can run: dragonfly --requirepass=foo --bind localhost.
Dragonfly currently supports the following Redis-specific arguments:
\n![](\"http://static.dragonflydb.io/repo-assets/bgsave-memusage.svg\")
port: Redis connection port (default: 6379).bind: Use localhost to only allow localhost connections or a public IP address to allow connections to that IP address (i.e. from outside too). Use 0.0.0.0 to allow all IPv4.requirepass: The password for AUTH authentication (default: \"\").maxmemory: Limit on maximum memory (in human-readable bytes) used by the database (default: 0). A maxmemory value of 0 means the program will automatically determine its maximum memory usage.dir: Dragonfly Docker uses the /data folder for snapshotting by default, the CLI uses \"\". You can use the -v Docker option to map it to your host folder.dbfilename: The filename to save and load the database (default: dump).There are also some Dragonfly-specific arguments:
\nmemcached_port: The port to enable Memcached-compatible API on (default: disabled).
keys_output_limit: Maximum number of returned keys in keys command (default: 8192). Note that keys is a dangerous command. We truncate its result to avoid a blowup in memory use when fetching too many keys.
dbnum: Maximum number of supported databases for select.
cache_mode: See the novel cache design section below.
hz: Key expiry evaluation frequency (default: 100). Lower frequency uses less CPU when idle at the expense of a slower eviction rate.
snapshot_cron: Cron schedule expression for automatic backup snapshots using standard cron syntax with the granularity of minutes (default: \"\").
\nHere are some cron schedule expression examples below, and feel free to read more about this argument in our documentation.
| Cron Schedule Expression | \nDescription | \n
|---|---|
* * * * * | \nAt every minute | \n
*/5 * * * * | \nAt every 5th minute | \n
5 */2 * * * | \nAt minute 5 past every 2nd hour | \n
0 0 * * * | \nAt 00:00 (midnight) every day | \n
0 6 * * 1-5 | \nAt 06:00 (dawn) from Monday through Friday | \n
primary_port_http_enabled: Allows accessing HTTP console on main TCP port if true (default: true).
admin_port: To enable admin access to the console on the assigned port (default: disabled). Supports both HTTP and RESP protocols.
admin_bind: To bind the admin console TCP connection to a given address (default: any). Supports both HTTP and RESP protocols.
admin_nopass: To enable open admin access to console on the assigned port, without auth token needed (default: false). Supports both HTTP and RESP protocols.
cluster_mode: Cluster mode supported (default: \"\"). Currently supports only emulated.
cluster_announce_ip: The IP that cluster commands announce to the client.
announce_port: The port that cluster commands announce to the client, and to replication master.
./dragonfly-x86_64 --logtostderr --requirepass=youshallnotpass --cache_mode=true -dbnum 1 --bind localhost --port 6379 --maxmemory=12gb --keys_output_limit=12288 --dbfilename dump.rdbArguments can be also provided via:
\n--flagfile <filename>: The file should list one flag per line, with equal signs instead of spaces for key-value flags. No quotes are needed for flag values.DFLY_x, where x is the exact name of the flag, case sensitive.For more options like logs management or TLS support, run dragonfly --help.
Dragonfly currently supports ~185 Redis commands and all Memcached commands besides cas. Almost on par with the Redis 5 API, Dragonfly's next milestone will be to stabilize basic functionality and implement the replication API. If there is a command you need that is not implemented yet, please open an issue.
For Dragonfly-native replication, we are designing a distributed log format that will support order-of-magnitude higher speeds.
\nFollowing the replication feature, we will continue adding missing commands for Redis versions 3-6 APIs.
\nPlease see our Command Reference for the current commands supported by Dragonfly.
\nDragonfly has a single, unified, adaptive caching algorithm that is simple and memory efficient.
\nYou can enable caching mode by passing the --cache_mode=true flag. Once this mode is on, Dragonfly will evict items least likely to be stumbled upon in the future but only when it is near the maxmemory limit.
Expiration ranges are limited to ~8 years.
\nExpiration deadlines with millisecond precision (PEXPIRE, PSETEX, etc.) are rounded to the closest second for deadlines greater than 2^28ms, which has less than 0.001% error and should be acceptable for large ranges. If this is not suitable for your use case, get in touch or open an issue explaining your case.
\nFor more detailed differences between Dragonfly expiration deadlines and Redis implementations, see here.
\nBy default, Dragonfly allows HTTP access via its main TCP port (6379). That's right, you can connect to Dragonfly via Redis protocol and via HTTP protocol — the server recognizes the protocol automatically during the connection initiation. Go ahead and try it with your browser. HTTP access currently does not have much info but will include useful debugging and management info in the future.
\nGo to the URL :6379/metrics to view Prometheus-compatible metrics.
The Prometheus exported metrics are compatible with the Grafana dashboard, see here.
\nImportant! The HTTP console is meant to be accessed within a safe network. If you expose Dragonfly's TCP port externally, we advise you to disable the console with --http_admin_console=false or --nohttp_admin_console.
Dragonfly started as an experiment to see how an in-memory datastore could look if it was designed in 2022. Based on lessons learned from our experience as users of memory stores and engineers who worked for cloud companies, we knew that we need to preserve two key properties for Dragonfly: Atomicity guarantees for all operations and low, sub-millisecond latency over very high throughput.
\nOur first challenge was how to fully utilize CPU, memory, and I/O resources using servers that are available today in public clouds. To solve this, we use shared-nothing architecture, which allows us to partition the keyspace of the memory store between threads so that each thread can manage its own slice of dictionary data. We call these slices \"shards\". The library that powers thread and I/O management for shared-nothing architecture is open-sourced here.
\nTo provide atomicity guarantees for multi-key operations, we use the advancements from recent academic research. We chose the paper \"VLL: a lock manager redesign for main memory database systems” to develop the transactional framework for Dragonfly. The choice of shared-nothing architecture and VLL allowed us to compose atomic multi-key operations without using mutexes or spinlocks. This was a major milestone for our PoC and its performance stood out from other commercial and open-source solutions.
\nOur second challenge was to engineer more efficient data structures for the new store. To achieve this goal, we based our core hashtable structure on the paper \"Dash: Scalable Hashing on Persistent Memory\". The paper itself is centered around the persistent memory domain and is not directly related to main-memory stores, but it's still most applicable to our problem. The hashtable design suggested in the paper allowed us to maintain two special properties that are present in the Redis dictionary: The incremental hashing ability during datastore growth the ability to traverse the dictionary under changes using a stateless scan operation. In addition to these two properties, Dash is more efficient in CPU and memory use. By leveraging Dash's design, we were able to innovate further with the following features:
\nOnce we had built the foundation for Dragonfly and we were happy with its performance, we went on to implement the Redis and Memcached functionality. We have to date implemented ~185 Redis commands (roughly equivalent to Redis 5.0 API) and 13 Memcached commands.
\nAnd finally,
\nOur mission is to build a well-designed, ultra-fast, cost-efficient in-memory datastore for cloud workloads that takes advantage of the latest hardware advancements. We intend to address the pain points of current solutions while preserving their product APIs and propositions.
\n