[{"data":1,"prerenderedAt":419},["ShallowReactive",2],{"docs-nav":3,"docs-page-\u002Fdocs\u002Fkafka-connect\u002Fcreate-and-configure":152},[4,27,53,68,87,102,121,136],{"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","Kafka Console Overview","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, Forward, and Export Kafka Messages","Replay, forward & 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,83],{"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",{"path":84,"title":85,"navTitle":86,"order":47},"\u002Fdocs\u002Fschema-registry\u002Faws-glue","Use AWS Glue Schema Registry in Kafma","AWS Glue",{"slug":88,"label":89,"pages":90},"consumer-groups","Consumer Groups",[91,94,98],{"path":92,"title":93,"navTitle":34,"order":16},"\u002Fdocs\u002Fconsumer-groups\u002Foverview","Browse Kafka Consumer Groups and Assignments",{"path":95,"title":96,"navTitle":97,"order":21},"\u002Fdocs\u002Fconsumer-groups\u002Flag","Monitor Kafka Consumer Lag","Lag",{"path":99,"title":100,"navTitle":101,"order":26},"\u002Fdocs\u002Fconsumer-groups\u002Freset-offsets","Reset Kafka Consumer Group Offsets","Reset offsets",{"slug":103,"label":104,"pages":105},"data-clone","Data Clone",[106,109,113,117],{"path":107,"title":108,"navTitle":34,"order":16},"\u002Fdocs\u002Fdata-clone\u002Foverview","Clone Kafka Topics Between Clusters",{"path":110,"title":111,"navTitle":112,"order":21},"\u002Fdocs\u002Fdata-clone\u002Fscope-and-range","Configure Kafka Topic Cloning","Scope & range",{"path":114,"title":115,"navTitle":116,"order":26},"\u002Fdocs\u002Fdata-clone\u002Fmasking","Mask Sensitive Data in Kafka Messages","Masking",{"path":118,"title":119,"navTitle":120,"order":47},"\u002Fdocs\u002Fdata-clone\u002Fpre-flight","Run Pre-flight Checks Before a Kafka Data Clone","Pre-flight",{"slug":122,"label":123,"pages":124},"kafka-connect","Kafka Connect",[125,128,132],{"path":126,"title":127,"navTitle":34,"order":16},"\u002Fdocs\u002Fkafka-connect\u002Foverview","Manage Kafka Connect in Kafma",{"path":129,"title":130,"navTitle":131,"order":21},"\u002Fdocs\u002Fkafka-connect\u002Fcreate-and-configure","Create and Configure Kafka Connectors","Create & configure",{"path":133,"title":134,"navTitle":135,"order":26},"\u002Fdocs\u002Fkafka-connect\u002Ftasks-and-offsets","Troubleshoot Kafka Connect Tasks and Inspect Offsets","Tasks & offsets",{"slug":137,"label":138,"pages":139},"operate","Operate",[140,144,148],{"path":141,"title":142,"navTitle":143,"order":16},"\u002Fdocs\u002Foperate\u002Fbrokers","Inspect Kafka Brokers and Cluster Configuration","Brokers",{"path":145,"title":146,"navTitle":147,"order":21},"\u002Fdocs\u002Foperate\u002Faccess-control","Inspect Kafka ACLs and Simulate Access","Access Control",{"path":149,"title":150,"navTitle":151,"order":26},"\u002Fdocs\u002Foperate\u002Factivity-logs","Review Kafka Changes in Kafma Activity Logs","Activity Logs",{"id":153,"title":130,"body":154,"datePublished":410,"description":411,"extension":412,"image":214,"lastUpdated":410,"meta":413,"navTitle":131,"navigation":414,"order":21,"path":129,"seo":415,"seoTitle":15,"sitemap":416,"stem":417,"__hash__":418},"docs\u002Fdocs\u002Fkafka-connect\u002Fcreate-and-configure.md",{"type":155,"value":156,"toc":401},"minimark",[157,161,166,204,207,216,223,227,248,263,266,270,273,323,328,340,344,351,358,361,365,372,378,382],[158,159,160],"p",{},"Create a connector from a plugin installed on your Connect cluster, or open an existing connector to edit its configuration. Kafma sends configuration validation requests to Kafka Connect and shows the results beside the fields.",[162,163,165],"h2",{"id":164},"create-a-connector","Create a connector",[167,168,169,181,184,187,198],"ol",{},[170,171,172,173,176,177,180],"li",{},"Open ",[174,175,123],"strong",{}," and select ",[174,178,179],{},"Create Connector",".",[170,182,183],{},"Choose the Connect cluster where it should run.",[170,185,186],{},"Select an installed source or sink plugin and enter a connector name.",[170,188,189,190,193,194,197],{},"Complete its configuration in ",[174,191,192],{},"Form"," or ",[174,195,196],{},"JSON"," mode.",[170,199,200,201,180],{},"Resolve any validation errors, then select ",[174,202,203],{},"Create",[158,205,206],{},"Plugin availability depends on the selected Connect cluster. Install a missing plugin on its workers before creating the connector; selecting it in Kafma does not install it.",[158,208,209],{},[210,211],"img",{"alt":212,"height":213,"src":214,"width":215},"Creating a source connector from an installed plugin, with Form and JSON modes and configuration validation",1520,"https:\u002F\u002Fmedia.kafma.app\u002Fdocs\u002Fkafka-connect\u002Fcreate-and-configure\u002Fnew-connector.png",2602,[158,217,218,219,222],{},"Kafka Connect validates the configuration before creating the connector. A successful creation means that the configuration was accepted; check the ",[174,220,221],{},"Tasks"," tab to confirm that its tasks started successfully.",[162,224,226],{"id":225},"edit-configuration","Edit configuration",[158,228,229,230,233,234,237,238,241,242,244,245,247],{},"Open the connector's ",[174,231,232],{},"Configuration"," tab and select ",[174,235,236],{},"Edit",", or choose ",[174,239,240],{},"Edit Configuration"," from its row menu in the connector list. Use ",[174,243,192],{}," for individual settings or ",[174,246,196],{}," for the full configuration. The form displays field documentation where the plugin provides it, plus validation errors returned by Kafka Connect.",[158,249,250,251,254,255,258,259,262],{},"Select ",[174,252,253],{},"Review"," to validate the draft and compare it with the current configuration. Check the added, removed, and changed settings, then select ",[174,256,257],{},"Apply Changes",", or ",[174,260,261],{},"Apply to Production"," for a Production cluster.",[158,264,265],{},"Applying configuration changes restarts the connector and its tasks. If the validation request could not complete, the review shows a warning; Kafka Connect still checks the configuration when it is applied.",[162,267,269],{"id":268},"pause-resume-and-stop","Pause, resume, and stop",[158,271,272],{},"Open the connector's action menu to control its lifecycle:",[274,275,276,289],"table",{},[277,278,279],"thead",{},[280,281,282,286],"tr",{},[283,284,285],"th",{},"Action",[283,287,288],{},"Effect",[290,291,292,303,313],"tbody",{},[280,293,294,300],{},[295,296,297],"td",{},[174,298,299],{},"Pause",[295,301,302],{},"Tasks stop processing but stay on their workers, keeping resources such as database connections",[280,304,305,310],{},[295,306,307],{},[174,308,309],{},"Resume",[295,311,312],{},"Resumes a paused connector or starts a stopped connector",[280,314,315,320],{},[295,316,317],{},[174,318,319],{},"Stop",[295,321,322],{},"Shuts down the connector and its tasks, freeing their resources; configuration and offsets are kept",[158,324,325,327],{},[174,326,319],{}," requires Kafka Connect 3.5 or later. The status can take a moment to reflect a lifecycle change while tasks transition.",[158,329,330,331,334,335,180],{},"For ",[174,332,333],{},"Restart",", failed-task recovery, and individual task restarts, see ",[336,337,339],"a",{"href":338},"\u002Fdocs\u002Fkafka-connect\u002Ftasks-and-offsets#restart-failed-tasks","Troubleshoot tasks and inspect offsets",[162,341,343],{"id":342},"delete-a-connector","Delete a connector",[158,345,346,347,350],{},"In the connector list, open the connector's row menu and select ",[174,348,349],{},"Delete Connector",", then review the confirmation. Deletion isn't available from the connector's details. Deletion stops its tasks and removes its configuration.",[158,352,353,354,357],{},"Deleting a connector does not clear its stored offsets. Source offsets remain in Connect's offset storage; a sink's committed offsets remain in its consumer group. A new connector with the same name ",[174,355,356],{},"may resume from the stored offsets"," instead of starting over. Sink offsets can expire, and a different configuration can use different offsets, so resuming is not guaranteed.",[158,359,360],{},"Deletion does not delete the Kafka topics or their messages. Recreating a connector is not an offset reset.",[162,362,364],{"id":363},"read-only-and-activity-logs","Read-Only and Activity Logs",[158,366,367,368,371],{},"Connector creation, configuration changes, lifecycle actions, task restarts, and deletion respect the Kafka cluster's ",[174,369,370],{},"Read-Only"," setting. Existing connectors continue processing when you enable Read-Only; it blocks changes made through Kafma.",[158,373,374,375,377],{},"Changes appear in ",[336,376,151],{"href":149},". Sensitive configuration values are redacted in the logs.",[162,379,381],{"id":380},"next-steps","Next steps",[383,384,385,390,396],"ul",{},[170,386,387],{},[336,388,389],{"href":133},"Troubleshoot connector tasks",[170,391,392],{},[336,393,395],{"href":394},"\u002Fdocs\u002Fkafka-connect\u002Foverview#add-a-connect-cluster","Configure Connect clusters",[170,397,398],{},[336,399,400],{"href":149},"Review Activity Logs",{"title":402,"searchDepth":26,"depth":26,"links":403},"",[404,405,406,407,408,409],{"id":164,"depth":21,"text":165},{"id":225,"depth":21,"text":226},{"id":268,"depth":21,"text":269},{"id":342,"depth":21,"text":343},{"id":363,"depth":21,"text":364},{"id":380,"depth":21,"text":381},"2026-10-01","Create Kafka connectors from installed plugins. Validate configs, review changes, and pause, resume, stop, or delete connectors in Kafka Connect.","md",{},true,{"title":130,"description":411},{"loc":129},"docs\u002Fkafka-connect\u002Fcreate-and-configure","8cSxMnN4fYcretTv9XsvKMx17rzNI6JBLIoWvfl-z5A",1790862044373]