[{"data":1,"prerenderedAt":434},["ShallowReactive",2],{"docs-nav":3,"docs-page-\u002Fdocs\u002Fdata-clone\u002Fpre-flight":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":115,"body":135,"description":425,"extension":426,"lastUpdated":427,"meta":428,"navTitle":116,"navigation":429,"order":47,"path":114,"seo":430,"sitemap":431,"stem":432,"__hash__":433},"docs\u002Fdocs\u002Fdata-clone\u002Fpre-flight.md",{"type":136,"value":137,"toc":413},"minimark",[138,147,150,155,158,177,180,184,191,200,203,263,266,270,273,288,291,295,298,315,321,324,328,331,342,345,349,354,357,364,372,376,379,382,385,392,396],[139,140,141,142,146],"p",{},"Select ",[143,144,145],"strong",{},"Run pre-flight"," to inspect the source, target, schemas, message range,\nand masking rules. Nothing is written to the target until you review the plan\nand start the clone.",[139,148,149],{},"Run pre-flight again after changing the source topics, scope, range, masking,\ntarget, naming, or partition settings.",[151,152,154],"h2",{"id":153},"what-pre-flight-checks","What pre-flight checks",[139,156,157],{},"Pre-flight determines:",[159,160,161,165,168,171,174],"ul",{},[162,163,164],"li",{},"Which target topics already exist and which Kafma will create.",[162,166,167],{},"Whether existing target partition counts differ from the plan.",[162,169,170],{},"Which schemas already exist, must be registered, or need a decision.",[162,172,173],{},"The approximate message count and whether the clone is a heavy workload.",[162,175,176],{},"Whether each masking rule can be applied to sampled records.",[139,178,179],{},"The result is an execution plan for the current selection, not a continuous\nview of either cluster.",[151,181,183],{"id":182},"read-the-execution-plan","Read the execution plan",[139,185,186,187,190],{},"The summary shows the topic, action, and estimated message counts, together\nwith the time the plan was generated. Review the rows below it before selecting\n",[143,188,189],{},"Start Clone",".",[139,192,193],{},[194,195],"img",{"alt":196,"height":197,"src":198,"width":199},"Ready Kafka data clone execution plan with topic and schema actions",1182,"https:\u002F\u002Fmedia.kafma.app\u002Fdocs\u002Fdata-clone\u002Fpre-flight\u002Fpreflight-ready.png",1860,[139,201,202],{},"Common topic actions include:",[204,205,206,219],"table",{},[207,208,209],"thead",{},[210,211,212,216],"tr",{},[213,214,215],"th",{},"Plan result",[213,217,218],{},"What will happen",[220,221,222,233,243,253],"tbody",{},[210,223,224,230],{},[225,226,227],"td",{},[143,228,229],{},"Create",[225,231,232],{},"The target topic is missing and a structure scope will create it",[210,234,235,240],{},[225,236,237],{},[143,238,239],{},"Append Msgs",[225,241,242],{},"The target topic exists and Kafma will append the selected messages",[210,244,245,250],{},[225,246,247],{},[143,248,249],{},"Skip",[225,251,252],{},"No topic or schema change is required, or the selected scope does not permit it",[210,254,255,260],{},[225,256,257],{},[143,258,259],{},"Warning",[225,261,262],{},"Review the row; some warnings skip work, while masking and unresolved Schema Registry warnings block the clone",[139,264,265],{},"Each topic lists its schema and masking checks underneath. Schema rows show\nwhat Kafma plans to register or skip. Mask rows show whether each rule can be\napplied to sampled messages.",[151,267,269],{"id":268},"review-topic-schema-message-and-masking-actions","Review topic, schema, message, and masking actions",[139,271,272],{},"Check four things:",[274,275,276,279,282,285],"ol",{},[162,277,278],{},"Every listed topic is intentional, including its target name.",[162,280,281],{},"The range estimate is small enough for the debugging or test task.",[162,283,284],{},"Each schema row has the expected target action. The execution log reports\nschema versions discovered from selected messages.",[162,286,287],{},"Every masking rule targets the expected field without a warning.",[139,289,290],{},"If the target topic already exists, Kafma keeps its current configuration and\npartition count. A different partition count does not block the clone;\nmessages are appended to the target's existing partitions.",[151,292,294],{"id":293},"understand-warnings-and-blockers","Understand warnings and blockers",[139,296,297],{},"Pre-flight surfaces planned skips, required decisions, and potential problems\nbefore the clone:",[159,299,300,306,309,312],{},[162,301,302,305],{},[143,303,304],{},"Data only"," skips a topic that does not exist on the target.",[162,307,308],{},"A missing or unreachable target Schema Registry requires a decision for\nschema-backed data.",[162,310,311],{},"An invalid or unmatched masking rule blocks the clone until it is fixed or\nremoved.",[162,313,314],{},"A large estimated copy warns that Data Clone may be the wrong tool for the\nworkload.",[139,316,317],{},[194,318],{"alt":319,"height":197,"src":320,"width":199},"A masking warning blocking a Kafka data clone","https:\u002F\u002Fmedia.kafma.app\u002Fdocs\u002Fdata-clone\u002Fmasking\u002Fmask-preflight.png",[139,322,323],{},"Use a narrower range for local debugging. For continuous or full-cluster\nreplication, use infrastructure designed for that workload rather than a\ndesktop clone.",[151,325,327],{"id":326},"resolve-schema-registry-decisions","Resolve Schema Registry decisions",[139,329,330],{},"For a structure scope, if the target has no reachable Schema Registry, choose\none of the resolutions offered by pre-flight:",[159,332,333,336,339],{},[162,334,335],{},"Configure the target Schema Registry and run pre-flight again.",[162,337,338],{},"Copy raw bytes only when target consumers can resolve the unchanged source\nschema IDs through the same compatible Schema Registry.",[162,340,341],{},"Skip the affected topics.",[139,343,344],{},"Masking is unavailable with raw bytes because Kafma cannot reach the fields\nwithout decoding the value.",[151,346,348],{"id":347},"start-and-monitor-the-clone","Start and monitor the clone",[139,350,141,351,353],{},[143,352,189],{}," after the plan is ready. The execution panel reports\ntopic progress, copied messages, schema actions, masking failures, and elapsed\ntime.",[139,355,356],{},"Pause takes effect at the next batch or topic boundary and can resume within\nthe same run. Abort stops further work; records already written remain on the\ntarget.",[139,358,359,360,363],{},"The completion summary distinguishes copied messages from failed or dropped\nrecords. Use ",[143,361,362],{},"View target topics"," to inspect the result.",[139,365,366],{},[194,367],{"alt":368,"height":369,"src":370,"width":371},"Completed Kafka data clone with copied messages and execution log",1192,"https:\u002F\u002Fmedia.kafma.app\u002Fdocs\u002Fdata-clone\u002Fpre-flight\u002Fclone-execution.png",1858,[151,373,375],{"id":374},"interrupted-runs-and-duplicate-messages","Interrupted runs and duplicate messages",[139,377,378],{},"Data Clone does not remove or deduplicate messages already copied. If you run\nthe same range again after an abort or failure, messages copied before the\ninterruption may be added to the target a second time.",[139,380,381],{},"For a clean retry, use a new target topic name. Otherwise, accept the duplicates\nonly when they do not affect the test.",[151,383,132],{"id":384},"activity-logs",[139,386,387,388,391],{},"Each completed, failed, or aborted clone creates one entry in\n",[389,390,132],"a",{"href":130},". The entry shows the source and\ntarget clusters, message count, topic outcome, and any dropped records.",[151,393,395],{"id":394},"next-steps","Next steps",[159,397,398,403,408],{},[162,399,400],{},[389,401,402],{"href":58},"Inspect the target topics",[162,404,405],{},[389,406,407],{"href":36},"Consume the cloned messages",[162,409,410],{},[389,411,412],{"href":130},"Review Data Clone activity",{"title":414,"searchDepth":26,"depth":26,"links":415},"",[416,417,418,419,420,421,422,423,424],{"id":153,"depth":21,"text":154},{"id":182,"depth":21,"text":183},{"id":268,"depth":21,"text":269},{"id":293,"depth":21,"text":294},{"id":326,"depth":21,"text":327},{"id":347,"depth":21,"text":348},{"id":374,"depth":21,"text":375},{"id":384,"depth":21,"text":132},{"id":394,"depth":21,"text":395},"Run pre-flight checks before a Kafka data clone in Kafma. Review planned topic, schema, masking, and message actions before writing to the target.","md","2026-08-01",{},true,{"title":115,"description":425},{"loc":114},"docs\u002Fdata-clone\u002Fpre-flight","6nVZduuXvBY3TB_kuH1FOgo5FIFEa5aT0hJV0mPnxX4",1785561255672]