[{"data":1,"prerenderedAt":379},["ShallowReactive",2],{"docs-nav":3,"docs-page-\u002Fdocs\u002Fconsumer-groups\u002Flag":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":92,"body":135,"description":370,"extension":371,"lastUpdated":372,"meta":373,"navTitle":93,"navigation":374,"order":21,"path":91,"seo":375,"sitemap":376,"stem":377,"__hash__":378},"docs\u002Fdocs\u002Fconsumer-groups\u002Flag.md",{"type":136,"value":137,"toc":361},"minimark",[138,142,147,150,153,156,171,175,178,228,231,240,244,255,258,262,265,315,318,322,333,336,340],[139,140,141],"p",{},"Kafma provides Kafka consumer lag monitoring at the group, topic, partition,\nand member levels. Start with the group total, then narrow the investigation to\nthe partition where progress has slowed.",[143,144,146],"h2",{"id":145},"what-is-kafka-consumer-lag","What is Kafka consumer lag?",[139,148,149],{},"Kafka consumer lag is the difference between a partition's end offset and the\nconsumer group's committed offset. Lag increases when new records arrive\nfaster than the group advances its committed position.",[139,151,152],{},"Kafma measures lag from committed offsets. After a consumer processes records,\nlag decreases only when the group commits a new offset.",[139,154,155],{},"Lag belongs to a group, topic, and partition—not to a topic alone. Two consumer\ngroups reading the same partition can therefore report different lag.",[139,157,158,159,163,164,166,167,170],{},"A partition without a committed offset is shown as ",[160,161,162],"strong",{},"Not committed",". In group\ndetails, total and max lag include only partitions with committed offsets.\n",[160,165,162],{}," or ",[160,168,169],{},"Partial"," indicates that other partitions do not yet\nhave a reliable lag value.",[143,172,174],{"id":173},"read-kafka-consumer-lag-metrics","Read Kafka consumer lag metrics",[139,176,177],{},"Open a group to compare three signals:",[179,180,181,194],"table",{},[182,183,184],"thead",{},[185,186,187,191],"tr",{},[188,189,190],"th",{},"Metric",[188,192,193],{},"Use it to",[195,196,197,208,218],"tbody",{},[185,198,199,205],{},[200,201,202],"td",{},[160,203,204],{},"Total lag",[200,206,207],{},"See the combined committed lag across the group",[185,209,210,215],{},[200,211,212],{},[160,213,214],{},"Max lag",[200,216,217],{},"Find the committed partition with the largest lag",[185,219,220,225],{},[200,221,222],{},[160,223,224],{},"Trend",[200,226,227],{},"See whether recent lag samples are rising or falling",[139,229,230],{},"The trend uses recent samples collected while group details refresh; it is not\nlong-term monitoring history.",[139,232,233],{},[234,235],"img",{"alt":236,"height":237,"src":238,"width":239},"Kafka consumer lag details with total lag, max lag, trend, and partition lag",1356,"https:\u002F\u002Fmedia.kafma.app\u002Fdocs\u002Fconsumer-groups\u002Flag\u002Fconsumer-lag-details.png",1562,[143,241,243],{"id":242},"find-lag-by-topic-partition-and-member","Find lag by topic, partition, and member",[139,245,246,247,250,251,254],{},"Expand ",[160,248,249],{},"Topic Assignments"," to compare topic totals and individual partitions.\nEach partition shows its committed offset, lag, and whether a member is assigned.\nAn ",[160,252,253],{},"Unassigned"," partition has no current member, but its saved offset can still\nfall behind as new records arrive.",[139,256,257],{},"Member lag is the sum of lag across that member's committed partitions. Expand\na member to find which assigned partition contributes the backlog. A partition\ncan be assigned to only one member of the group at a time.",[143,259,261],{"id":260},"diagnose-increasing-kafka-consumer-lag","Diagnose increasing Kafka consumer lag",[139,263,264],{},"Use these signals to decide what to check next:",[179,266,267,277],{},[182,268,269],{},[185,270,271,274],{},[188,272,273],{},"Signal",[188,275,276],{},"Check next",[195,278,279,287,295,303],{},[185,280,281,284],{},[200,282,283],{},"Lag rises across many assigned partitions",[200,285,286],{},"Consumer throughput, processing time, or downstream dependencies",[185,288,289,292],{},[200,290,291],{},"Lag is concentrated in one partition",[200,293,294],{},"Key distribution, partition traffic, or repeated processing failures",[185,296,297,300],{},[200,298,299],{},"Lag appears on an unassigned partition",[200,301,302],{},"Whether the group is rebalancing or no active member subscribes to the topic",[185,304,305,312],{},[200,306,307,308,311],{},"Group is ",[160,309,310],{},"Empty"," and lag rises",[200,313,314],{},"Whether the consumer application is stopped or failing",[139,316,317],{},"Kafka retention can move a partition's earliest available offset forward.\nRecords already removed by retention cannot be recovered by the consumer or by\nresetting its offsets.",[143,319,321],{"id":320},"inspect-lagging-messages-in-the-console","Inspect lagging messages in the Console",[139,323,324,325,328,329,332],{},"From an expanded topic in the group drawer, open the Console in ",[160,326,327],{},"Watch Group","\nmode. For an assigned partition, hover over the partition and select ",[160,330,331],{},"Inspect","\nto watch only that partition. Kafma shows a bounded window around the committed\nposition of each partition without joining the group or changing its offsets.",[139,334,335],{},"The view separates records before the committed position from pending records\nat the front of the backlog. Use it to inspect the keys and values near a\nstalled position.",[143,337,339],{"id":338},"next-steps","Next steps",[341,342,343,350,355],"ul",{},[344,345,346],"li",{},[347,348,349],"a",{"href":88},"Browse consumer groups and assignments",[344,351,352],{},[347,353,354],{"href":95},"Reset Kafka consumer group offsets",[344,356,357],{},[347,358,360],{"href":359},"\u002Fdocs\u002Fconsole\u002Fconsuming-messages#live-and-watch-group-modes","Use Watch Group in the Console",{"title":362,"searchDepth":26,"depth":26,"links":363},"",[364,365,366,367,368,369],{"id":145,"depth":21,"text":146},{"id":173,"depth":21,"text":174},{"id":242,"depth":21,"text":243},{"id":260,"depth":21,"text":261},{"id":320,"depth":21,"text":321},{"id":338,"depth":21,"text":339},"Monitor Kafka consumer lag in Kafma. Compare total lag, max lag, per-topic and per-partition lag, assignments, and live trends.","md","2026-08-01",{},true,{"title":92,"description":370},{"loc":91},"docs\u002Fconsumer-groups\u002Flag","PeZi_FwlL_O4aWAoXc3hlOgupsBXlE5Tmzg-_e0P9Yw",1785561255515]