[{"data":1,"prerenderedAt":478},["ShallowReactive",2],{"docs-nav":3,"docs-page-\u002Fdocs\u002Fdata-clone\u002Fscope-and-range":133},[4,27,53,68,83,98,117],{"slug":5,"label":6,"pages":7},"get-started","Get Started",[8,12,17,22],{"path":9,"title":10,"order":11},"\u002Fdocs","Welcome",0,{"path":13,"title":14,"navTitle":15,"order":16},"\u002Fdocs\u002Fget-started\u002Fquickstart","Quickstart",null,1,{"path":18,"title":19,"navTitle":20,"order":21},"\u002Fdocs\u002Fget-started\u002Fconnect-to-a-cluster","Connecting to a Kafka Cluster","Clusters",2,{"path":23,"title":24,"navTitle":25,"order":26},"\u002Fdocs\u002Fget-started\u002Flicense","Licensing and Activation","License",3,{"slug":28,"label":29,"pages":30},"console","Console",[31,35,39,43,48],{"path":32,"title":33,"navTitle":34,"order":16},"\u002Fdocs\u002Fconsole\u002Foverview","Produce and Consume Messages in the Kafka Console","Overview",{"path":36,"title":37,"navTitle":38,"order":21},"\u002Fdocs\u002Fconsole\u002Fconsuming-messages","Kafka Consumer: Reading Messages from a Topic","Consuming",{"path":40,"title":41,"navTitle":42,"order":26},"\u002Fdocs\u002Fconsole\u002Fdecoding-messages","Decoding Kafka Avro and Protobuf Messages","Decoding",{"path":44,"title":45,"navTitle":46,"order":47},"\u002Fdocs\u002Fconsole\u002Fproducing-messages","Kafka Producer: Sending Messages to a Topic","Producing",4,{"path":49,"title":50,"navTitle":51,"order":52},"\u002Fdocs\u002Fconsole\u002Freplay-forward-and-export","Replay and Export Kafka Messages","Replay & export",5,{"slug":54,"label":55,"pages":56},"topics","Topics",[57,60,64],{"path":58,"title":59,"navTitle":34,"order":16},"\u002Fdocs\u002Ftopics\u002Foverview","Browse and Inspect Kafka Topics",{"path":61,"title":62,"navTitle":63,"order":21},"\u002Fdocs\u002Ftopics\u002Fcreate-a-topic","Create a Kafka Topic: Partitions, Replication, and Retention","Create a topic",{"path":65,"title":66,"navTitle":67,"order":26},"\u002Fdocs\u002Ftopics\u002Fpartitions-and-records","Adding Kafka Partitions and Deleting Records","Partitions & records",{"slug":69,"label":70,"pages":71},"schema-registry","Schema Registry",[72,75,79],{"path":73,"title":74,"navTitle":34,"order":16},"\u002Fdocs\u002Fschema-registry\u002Foverview","Browse Kafka Schema Registry Subjects and Versions",{"path":76,"title":77,"navTitle":78,"order":21},"\u002Fdocs\u002Fschema-registry\u002Fnew-versions","Register Kafka Schemas and Publish New Versions","New versions",{"path":80,"title":81,"navTitle":82,"order":26},"\u002Fdocs\u002Fschema-registry\u002Fmock-and-lab","Avro Schema Validator and Mock Data Generator","Mock & Lab",{"slug":84,"label":85,"pages":86},"consumer-groups","Consumer Groups",[87,90,94],{"path":88,"title":89,"navTitle":34,"order":16},"\u002Fdocs\u002Fconsumer-groups\u002Foverview","Browse Kafka Consumer Groups and Assignments",{"path":91,"title":92,"navTitle":93,"order":21},"\u002Fdocs\u002Fconsumer-groups\u002Flag","Monitor Kafka Consumer Lag","Lag",{"path":95,"title":96,"navTitle":97,"order":26},"\u002Fdocs\u002Fconsumer-groups\u002Freset-offsets","Reset Kafka Consumer Group Offsets","Reset offsets",{"slug":99,"label":100,"pages":101},"data-clone","Data Clone",[102,105,109,113],{"path":103,"title":104,"navTitle":34,"order":16},"\u002Fdocs\u002Fdata-clone\u002Foverview","Clone Kafka Topics Between Clusters",{"path":106,"title":107,"navTitle":108,"order":21},"\u002Fdocs\u002Fdata-clone\u002Fscope-and-range","Configure Kafka Topic Cloning","Scope & range",{"path":110,"title":111,"navTitle":112,"order":26},"\u002Fdocs\u002Fdata-clone\u002Fmasking","Mask Sensitive Data in Kafka Messages","Masking",{"path":114,"title":115,"navTitle":116,"order":47},"\u002Fdocs\u002Fdata-clone\u002Fpre-flight","Run Pre-flight Checks Before a Kafka Data Clone","Pre-flight",{"slug":118,"label":119,"pages":120},"operate","Operate",[121,125,129],{"path":122,"title":123,"navTitle":124,"order":16},"\u002Fdocs\u002Foperate\u002Fbrokers","Inspect Kafka Brokers and Cluster Configuration","Brokers",{"path":126,"title":127,"navTitle":128,"order":21},"\u002Fdocs\u002Foperate\u002Faccess-control","Inspect Kafka ACLs and Simulate Access","Access Control",{"path":130,"title":131,"navTitle":132,"order":26},"\u002Fdocs\u002Foperate\u002Factivity-logs","Review Kafka Changes in Kafma Activity Logs","Activity Logs",{"id":134,"title":107,"body":135,"description":469,"extension":470,"lastUpdated":471,"meta":472,"navTitle":108,"navigation":473,"order":21,"path":106,"seo":474,"sitemap":475,"stem":476,"__hash__":477},"docs\u002Fdocs\u002Fdata-clone\u002Fscope-and-range.md",{"type":136,"value":137,"toc":458},"minimark",[138,142,147,150,153,157,220,230,239,243,246,300,308,315,321,325,333,336,340,384,387,397,401,404,419,424,427,431,434,441,445],[139,140,141],"p",{},"Select the Kafka topics you need, then use scope and range to control what\nreaches the target. A focused clone is faster to inspect and avoids copying\nunrelated production data.",[143,144,146],"h2",{"id":145},"select-the-topics-to-clone","Select the topics to clone",[139,148,149],{},"Choose a source cluster and select one or more topics. The format badge beside a\ntopic shows when Kafma detects an Avro, JSON Schema, or Protobuf subject by\ntopic name. A topic without a badge can still use RecordNameStrategy or\nTopicRecordNameStrategy.",[139,151,152],{},"Data Clone copies only the topics you select. It does not copy consumer groups\nor broker settings.",[143,154,156],{"id":155},"choose-structure-data-or-both","Choose structure, data, or both",[158,159,160,176],"table",{},[161,162,163],"thead",{},[164,165,166,170,173],"tr",{},[167,168,169],"th",{},"Scope",[167,171,172],{},"What Kafma does",[167,174,175],{},"Use it when",[177,178,179,194,207],"tbody",{},[164,180,181,188,191],{},[182,183,184],"td",{},[185,186,187],"strong",{},"Structure + Data",[182,189,190],{},"Creates missing topics, syncs the latest TopicNameStrategy schemas, registers any additional versions used by the selected messages, and appends those messages",[182,192,193],{},"Reproducing an issue or creating a working local copy",[164,195,196,201,204],{},[182,197,198],{},[185,199,200],{},"Structure only",[182,202,203],{},"Creates missing topics and registers the latest discovered schemas, but copies no messages",[182,205,206],{},"You want production-like structure for your own test data",[164,208,209,214,217],{},[182,210,211],{},[185,212,213],{},"Data only",[182,215,216],{},"Appends messages to existing topics and skips missing topics; it does not create topics or register schemas",[182,218,219],{},"The target structure is managed elsewhere",[139,221,222,223,225,226,229],{},"With ",[185,224,200],{},", TopicNameStrategy subjects sync without reading\nmessages. Enable ",[185,227,228],{},"Sample messages for record-name schemas"," to discover\nRecordNameStrategy and TopicRecordNameStrategy subjects. Sampling only finds\nschemas; it does not copy messages.",[139,231,232],{},[233,234],"img",{"alt":235,"height":236,"src":237,"width":238},"Using Structure only with optional message sampling to discover record-name schemas",686,"https:\u002F\u002Fmedia.kafma.app\u002Fdocs\u002Fdata-clone\u002Fscope-and-range\u002Fclone-structure-only.png",1840,[143,240,242],{"id":241},"clone-the-messages-needed-to-reproduce-an-issue","Clone the messages needed to reproduce an issue",[139,244,245],{},"The range applies to every selected topic:",[158,247,248,258],{},[161,249,250],{},[164,251,252,255],{},[167,253,254],{},"Range",[167,256,257],{},"Messages selected",[177,259,260,270,280,290],{},[164,261,262,267],{},[182,263,264],{},[185,265,266],{},"Latest 10k msgs \u002F partition",[182,268,269],{},"Up to the newest 10,000 retained records from each partition",[164,271,272,277],{},[182,273,274],{},[185,275,276],{},"Time window",[182,278,279],{},"Records at or after the start time and before the end time",[164,281,282,287],{},[182,283,284],{},[185,285,286],{},"Offset range",[182,288,289],{},"Records from the start offset through the end offset in each partition",[164,291,292,297],{},[182,293,294],{},[185,295,296],{},"All messages",[182,298,299],{},"Every record the source currently retains",[139,301,302],{},[233,303],{"alt":304,"height":305,"src":306,"width":307},"Selecting a message range while matching target topic names and partition counts",736,"https:\u002F\u002Fmedia.kafma.app\u002Fdocs\u002Fdata-clone\u002Fscope-and-range\u002Fclone-range-and-target.png",1850,[139,309,310,311,314],{},"Message counts are per partition. On a topic with 20 partitions, ",[185,312,313],{},"Latest 10k\nmsgs \u002F partition"," can copy as many as 200,000 records.",[139,316,317,318,320],{},"For an incident, start with the narrowest time window that contains the failure.\nUse an offset range when you know the relevant partition positions. Choose\n",[185,319,296],{}," only for a small topic; Data Clone is designed for bounded\ndebugging and test data, not full-cluster replication.",[143,322,324],{"id":323},"understand-per-partition-ranges","Understand per-partition ranges",[139,326,327,328,332],{},"Each partition has its own offsets. If you enter ",[329,330,331],"code",{},"100-200",", Kafma looks for\noffsets 100 through 200 in every partition. A partition without those offsets\ncontributes no messages.",[139,334,335],{},"A time window also resolves to a separate offset span in each partition. Kafma\ncopies records from the selected interval and stops at the snapshot boundary;\nit does not continue following new messages.",[143,337,339],{"id":338},"set-target-topic-names","Set target topic names",[158,341,342,352],{},[161,343,344],{},[164,345,346,349],{},[167,347,348],{},"Naming",[167,350,351],{},"Result",[177,353,354,364,374],{},[164,355,356,361],{},[182,357,358],{},[185,359,360],{},"Match Source",[182,362,363],{},"Keep each source topic name",[164,365,366,371],{},[182,367,368],{},[185,369,370],{},"Add Prefix",[182,372,373],{},"Add one prefix to every selected topic",[164,375,376,381],{},[182,377,378],{},[185,379,380],{},"Add Suffix",[182,382,383],{},"Add one suffix to every selected topic",[139,385,386],{},"Keep the source names when an application on a separate target cluster expects\nthem. Use a prefix or suffix to isolate test data or keep clones from different\nenvironments apart.",[139,388,389,390,392,393,396],{},"When source and target are the same cluster, ",[185,391,360],{}," is unavailable.\nKafma defaults to the ",[329,394,395],{},"-copy"," suffix so the target cannot overlap the source\ntopic.",[143,398,400],{"id":399},"choose-target-partition-counts","Choose target partition counts",[139,402,403],{},"For a cross-cluster, non-production target, choose:",[405,406,407,413],"ul",{},[408,409,410,412],"li",{},[185,411,360],{}," to create missing topics with the source partition count.",[408,414,415,418],{},[185,416,417],{},"1 Partition per topic"," when one partition is enough for local testing.",[139,420,421,423],{},[185,422,360],{}," copies the partition count, not each record's source partition\nnumber. The target producer repartitions keyed records by key and assigns\nunkeyed records automatically. A record can therefore land on a different\npartition even when the source and target have the same partition count.\nChoosing one partition removes partition-level parallelism, but can simplify a\nlocal debugging setup.",[139,425,426],{},"If the target topic already exists, Kafma keeps its current partition count and\nconfiguration. Pre-flight reports a partition-count difference instead of\nmodifying it.",[143,428,430],{"id":429},"same-cluster-and-production-safeguards","Same-cluster and production safeguards",[139,432,433],{},"For a same-cluster clone, a prefix or suffix is mandatory. The source remains\nread-only, and the new records go to separate topic names.",[139,435,436,437,440],{},"When the target is marked as production, type its cluster name to confirm the\nwrite. Kafma hides the ",[185,438,439],{},"Partitions"," selector. New target topics use the source\npartition count; existing topics keep their current count.",[143,442,444],{"id":443},"next-steps","Next steps",[405,446,447,453],{},[408,448,449],{},[450,451,452],"a",{"href":110},"Mask sensitive fields before cloning",[408,454,455],{},[450,456,457],{"href":114},"Review the clone in pre-flight",{"title":459,"searchDepth":26,"depth":26,"links":460},"",[461,462,463,464,465,466,467,468],{"id":145,"depth":21,"text":146},{"id":155,"depth":21,"text":156},{"id":241,"depth":21,"text":242},{"id":323,"depth":21,"text":324},{"id":338,"depth":21,"text":339},{"id":399,"depth":21,"text":400},{"id":429,"depth":21,"text":430},{"id":443,"depth":21,"text":444},"Configure Kafka topic cloning in Kafma. Choose structure or data, limit messages by time or offset, and set target topic names and partitions.","md","2026-08-01",{},true,{"title":107,"description":469},{"loc":106},"docs\u002Fdata-clone\u002Fscope-and-range","TtvdeyoNPabDC7M29zFbrMgdrYXZiXyypQFT9Kf61UY",1785561255691]