ceph-syn - ceph synthetic workload generator
Contents
Availability
ceph-syn is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to
the Ceph documentation at https://docs.ceph.com for more information.
Copyright
2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share
Alike 3.0 (CC-BY-SA-3.0)
dev May 22, 2025 CEPH-SYN(8)
Description
ceph-syn is a simple synthetic workload generator for the Ceph distributed file system. It uses the
userspace client library to generate simple workloads against a currently running file system. The file
system need not be mounted via ceph-fuse(8) or the kernel client.
One or more --syn command arguments specify the particular workload, as documented below.
Name
ceph-syn - ceph synthetic workload generator
Options
-d Detach from console and daemonize after startup.
-cceph.conf,--conf=ceph.conf
Use ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to determine monitor
addresses during startup.
-mmonaddress[:port]
Connect to specified monitor (instead of looking through ceph.conf).
--num_clientnum
Run num different clients, each in a separate thread.
--synworkloadspec
Run the given workload. May be specified as many times as needed. Workloads will normally run
sequentially.
See Also
ceph(8), ceph-fuse(8)
Synopsis
ceph-syn [ -m monaddr:port ] --syn command...
Workloads
Each workload should be preceded by --syn on the command line. This is not a complete list.
mknappathsnapname
Create a snapshot called snapname on path.
rmsnappathsnapname
Delete snapshot called snapname on path.
rmfilepath
Delete/unlink path.
writefilesizeinmbblocksize
Create a file, named after our client id, that is sizeinmb MB by writing blocksize chunks.
readfilesizeinmbblocksize
Read file, named after our client id, that is sizeinmb MB by writing blocksize chunks.
rwsizeinmbblocksize
Write file, then read it back, as above.
makedirsnumsubdirsnumfilesdepth
Create a hierarchy of directories that is depth levels deep. Give each directory numsubdirs
subdirectories and numfiles files.
walk Recursively walk the file system (like find).
