[{"data":1,"prerenderedAt":1937},["ShallowReactive",2],{"navigation":3,"banner":339,"\u002Fdocs\u002Foperating\u002Flicence-tool":354,"\u002Fdocs\u002Foperating\u002Flicence-tool-surround":1932},[4,43,91,154,181,224,267,298],{"title":5,"path":6,"stem":7,"children":8,"icon":42},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[9,12,17,22,27,32,37],{"title":10,"path":6,"stem":7,"icon":11},"Getting started","i-lucide-flag",{"title":13,"path":14,"stem":15,"icon":16},"Modules overview","\u002Fdocs\u002Fgetting-started\u002Fmodules-overview","1.docs\u002F1.getting-started\u002F2.modules-overview","i-lucide-boxes",{"title":18,"path":19,"stem":20,"icon":21},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","1.docs\u002F1.getting-started\u002F3.installation","i-lucide-download",{"title":23,"path":24,"stem":25,"icon":26},"Licence configuration","\u002Fdocs\u002Fgetting-started\u002Flicence-configuration","1.docs\u002F1.getting-started\u002F4.licence-configuration","i-lucide-key-round",{"title":28,"path":29,"stem":30,"icon":31},"Your first app","\u002Fdocs\u002Fgetting-started\u002Ffirst-app","1.docs\u002F1.getting-started\u002F5.first-app","i-lucide-square-play",{"title":33,"path":34,"stem":35,"icon":36},"Project setup","\u002Fdocs\u002Fgetting-started\u002Fproject-setup","1.docs\u002F1.getting-started\u002F6.project-setup","i-lucide-package",{"title":38,"path":39,"stem":40,"icon":41},"AI assistants","\u002Fdocs\u002Fgetting-started\u002Fai-assistants","1.docs\u002F1.getting-started\u002F7.ai-assistants","i-lucide-bot",false,{"title":44,"path":45,"stem":46,"children":47,"icon":50},"Core Concepts","\u002Fdocs\u002Fconcepts","1.docs\u002F2.concepts\u002F1.index",[48,51,56,61,66,71,76,81,86],{"title":49,"path":45,"stem":46,"icon":50},"Core concepts","i-lucide-book-open",{"title":52,"path":53,"stem":54,"icon":55},"Architecture","\u002Fdocs\u002Fconcepts\u002Farchitecture","1.docs\u002F2.concepts\u002F2.architecture","i-lucide-layers",{"title":57,"path":58,"stem":59,"icon":60},"Exactly-once semantics","\u002Fdocs\u002Fconcepts\u002Fexactly-once","1.docs\u002F2.concepts\u002F3.exactly-once","i-lucide-shield-check",{"title":62,"path":63,"stem":64,"icon":65},"Lanes and parallelism","\u002Fdocs\u002Fconcepts\u002Flanes-and-parallelism","1.docs\u002F2.concepts\u002F4.lanes-and-parallelism","i-lucide-split",{"title":67,"path":68,"stem":69,"icon":70},"State and thread-safety","\u002Fdocs\u002Fconcepts\u002Fstate-and-thread-safety","1.docs\u002F2.concepts\u002F5.state-and-thread-safety","i-lucide-lock",{"title":72,"path":73,"stem":74,"icon":75},"Event time and watermarks","\u002Fdocs\u002Fconcepts\u002Fevent-time-and-watermarks","1.docs\u002F2.concepts\u002F6.event-time-and-watermarks","i-lucide-clock",{"title":77,"path":78,"stem":79,"icon":80},"The configuration model","\u002Fdocs\u002Fconcepts\u002Fconfiguration-model","1.docs\u002F2.concepts\u002F7.configuration-model","i-lucide-sliders-horizontal",{"title":82,"path":83,"stem":84,"icon":85},"The error-handling model","\u002Fdocs\u002Fconcepts\u002Ferror-handling-model","1.docs\u002F2.concepts\u002F8.error-handling-model","i-lucide-triangle-alert",{"title":87,"path":88,"stem":89,"icon":90},"How StoatFlow differs from Kafka Streams","\u002Fdocs\u002Fconcepts\u002Fhow-stoatflow-differs-from-ks","1.docs\u002F2.concepts\u002F9.how-stoatflow-differs-from-ks","i-lucide-arrow-left-right",{"title":92,"path":93,"stem":94,"children":95,"icon":98},"Building Topologies","\u002Fdocs\u002Fbuilding","1.docs\u002F3.building\u002F1.index",[96,99,104,109,114,119,124,129,134,139,144,149],{"title":97,"path":93,"stem":94,"icon":98},"Building topologies","i-lucide-blocks",{"title":100,"path":101,"stem":102,"icon":103},"Error handling and DLQ","\u002Fdocs\u002Fbuilding\u002Ferror-handling-dlq","1.docs\u002F3.building\u002F10.error-handling-dlq","i-lucide-circle-x",{"title":105,"path":106,"stem":107,"icon":108},"State stores","\u002Fdocs\u002Fbuilding\u002Fstate-stores","1.docs\u002F3.building\u002F11.state-stores","i-lucide-database",{"title":110,"path":111,"stem":112,"icon":113},"Testing topologies","\u002Fdocs\u002Fbuilding\u002Ftesting","1.docs\u002F3.building\u002F12.testing","i-lucide-flask-conical",{"title":115,"path":116,"stem":117,"icon":118},"Sources and sinks","\u002Fdocs\u002Fbuilding\u002Fstreams-builder","1.docs\u002F3.building\u002F2.streams-builder","i-lucide-import",{"title":120,"path":121,"stem":122,"icon":123},"KStream and KTable operations","\u002Fdocs\u002Fbuilding\u002Fkstream-ktable","1.docs\u002F3.building\u002F3.kstream-ktable","i-lucide-waypoints",{"title":125,"path":126,"stem":127,"icon":128},"Aggregations","\u002Fdocs\u002Fbuilding\u002Faggregations","1.docs\u002F3.building\u002F4.aggregations","i-lucide-sigma",{"title":130,"path":131,"stem":132,"icon":133},"Windowing","\u002Fdocs\u002Fbuilding\u002Fwindowing","1.docs\u002F3.building\u002F5.windowing","i-lucide-calendar-clock",{"title":135,"path":136,"stem":137,"icon":138},"Joins","\u002Fdocs\u002Fbuilding\u002Fjoins","1.docs\u002F3.building\u002F6.joins","i-lucide-git-merge",{"title":140,"path":141,"stem":142,"icon":143},"The Processor API","\u002Fdocs\u002Fbuilding\u002Fprocessor-api","1.docs\u002F3.building\u002F7.processor-api","i-lucide-cpu",{"title":145,"path":146,"stem":147,"icon":148},"Scheduled sources","\u002Fdocs\u002Fbuilding\u002Fscheduled-sources","1.docs\u002F3.building\u002F8.scheduled-sources","i-lucide-timer",{"title":150,"path":151,"stem":152,"icon":153},"Serdes and Avro","\u002Fdocs\u002Fbuilding\u002Fserdes","1.docs\u002F3.building\u002F9.serdes","i-lucide-binary",{"title":155,"path":156,"stem":157,"children":158,"icon":80},"Configuration","\u002Fdocs\u002Fconfiguration","1.docs\u002F4.configuration\u002F1.index",[159,161,166,171,176],{"title":160,"path":156,"stem":157,"icon":80},"How configuration works",{"title":162,"path":163,"stem":164,"icon":165},"Engine configuration (:core)","\u002Fdocs\u002Fconfiguration\u002Fcore-config","1.docs\u002F4.configuration\u002F2.core-config","i-lucide-settings-2",{"title":167,"path":168,"stem":169,"icon":170},"Runtime configuration (:runtime)","\u002Fdocs\u002Fconfiguration\u002Fruntime-config","1.docs\u002F4.configuration\u002F3.runtime-config","i-lucide-server-cog",{"title":172,"path":173,"stem":174,"icon":175},"Defaults, adaptivity, and presets","\u002Fdocs\u002Fconfiguration\u002Fdefaults-and-presets","1.docs\u002F4.configuration\u002F4.defaults-and-presets","i-lucide-gauge",{"title":177,"path":178,"stem":179,"icon":180},"Kafka client configuration","\u002Fdocs\u002Fconfiguration\u002Fkafka-client-config","1.docs\u002F4.configuration\u002F5.kafka-client-config","i-lucide-plug",{"title":182,"path":183,"stem":184,"children":185,"icon":188},"Running in Production","\u002Fdocs\u002Fruntime","1.docs\u002F5.runtime\u002F1.index",[186,189,194,199,204,209,214,219],{"title":187,"path":183,"stem":184,"icon":188},"The runtime","i-lucide-server",{"title":190,"path":191,"stem":192,"icon":193},"The REST API","\u002Fdocs\u002Fruntime\u002Frest-api","1.docs\u002F5.runtime\u002F2.rest-api","i-lucide-globe",{"title":195,"path":196,"stem":197,"icon":198},"Health checks","\u002Fdocs\u002Fruntime\u002Fhealth-checks","1.docs\u002F5.runtime\u002F3.health-checks","i-lucide-heart-pulse",{"title":200,"path":201,"stem":202,"icon":203},"Metrics","\u002Fdocs\u002Fruntime\u002Fmetrics","1.docs\u002F5.runtime\u002F4.metrics","i-lucide-activity",{"title":205,"path":206,"stem":207,"icon":208},"Pause and resume","\u002Fdocs\u002Fruntime\u002Fpause-unpause","1.docs\u002F5.runtime\u002F5.pause-unpause","i-lucide-pause",{"title":210,"path":211,"stem":212,"icon":213},"Plugins and lifecycle hooks","\u002Fdocs\u002Fruntime\u002Fplugins","1.docs\u002F5.runtime\u002F6.plugins","i-lucide-puzzle",{"title":215,"path":216,"stem":217,"icon":218},"Docker images","\u002Fdocs\u002Fruntime\u002Fdocker","1.docs\u002F5.runtime\u002F7.docker","i-lucide-container",{"title":220,"path":221,"stem":222,"icon":223},"GraalVM native image","\u002Fdocs\u002Fruntime\u002Fnative-image","1.docs\u002F5.runtime\u002F8.native-image","i-lucide-zap",{"title":225,"path":226,"stem":227,"children":228,"icon":231},"Deploying & Operating","\u002Fdocs\u002Foperating","1.docs\u002F6.operating\u002F1.index",[229,232,237,242,247,252,257,262],{"title":230,"path":226,"stem":227,"icon":231},"Deploying and operating","i-lucide-life-buoy",{"title":233,"path":234,"stem":235,"icon":236},"Running on Kubernetes","\u002Fdocs\u002Foperating\u002Fkubernetes","1.docs\u002F6.operating\u002F2.kubernetes","i-lucide-ship",{"title":238,"path":239,"stem":240,"icon":241},"High availability","\u002Fdocs\u002Foperating\u002Fhigh-availability","1.docs\u002F6.operating\u002F3.high-availability","i-lucide-copy",{"title":243,"path":244,"stem":245,"icon":246},"Liveness and readiness probes","\u002Fdocs\u002Foperating\u002Fprobes","1.docs\u002F6.operating\u002F4.probes","i-lucide-stethoscope",{"title":248,"path":249,"stem":250,"icon":251},"Observability","\u002Fdocs\u002Foperating\u002Fobservability","1.docs\u002F6.operating\u002F5.observability","i-lucide-telescope",{"title":253,"path":254,"stem":255,"icon":256},"Tuning under load","\u002Fdocs\u002Foperating\u002Ftuning","1.docs\u002F6.operating\u002F6.tuning","i-lucide-sliders",{"title":258,"path":259,"stem":260,"icon":261},"Production checklist","\u002Fdocs\u002Foperating\u002Fproduction-checklist","1.docs\u002F6.operating\u002F7.production-checklist","i-lucide-clipboard-check",{"title":263,"path":264,"stem":265,"icon":266},"The licence tool","\u002Fdocs\u002Foperating\u002Flicence-tool","1.docs\u002F6.operating\u002F8.licence-tool","i-lucide-badge-check",{"title":268,"path":269,"stem":270,"children":271,"icon":90},"Migrating from Kafka Streams","\u002Fdocs\u002Fmigration","1.docs\u002F7.migration\u002F1.index",[272,273,278,283,288,293],{"title":268,"path":269,"stem":270,"icon":90},{"title":274,"path":275,"stem":276,"icon":277},"Automated port","\u002Fdocs\u002Fmigration\u002Fautomated-port","1.docs\u002F7.migration\u002F2.automated-port","i-lucide-wand-sparkles",{"title":279,"path":280,"stem":281,"icon":282},"Migration without carrying state","\u002Fdocs\u002Fmigration\u002Fwithout-data-migration","1.docs\u002F7.migration\u002F3.without-data-migration","i-lucide-sparkles",{"title":284,"path":285,"stem":286,"icon":287},"Migration carrying state","\u002Fdocs\u002Fmigration\u002Fwith-data-migration","1.docs\u002F7.migration\u002F4.with-data-migration","i-lucide-database-backup",{"title":289,"path":290,"stem":291,"icon":292},"The migration tool","\u002Fdocs\u002Fmigration\u002Fmigration-tool","1.docs\u002F7.migration\u002F5.migration-tool","i-lucide-truck",{"title":294,"path":295,"stem":296,"icon":297},"Reusing your Kafka Streams dashboards","\u002Fdocs\u002Fmigration\u002Freusing-kafka-streams-dashboards","1.docs\u002F7.migration\u002F6.reusing-kafka-streams-dashboards","i-lucide-line-chart",{"title":299,"path":300,"stem":301,"children":302,"icon":304},"Reference","\u002Fdocs\u002Freference","1.docs\u002F8.reference\u002F1.index",[303,305,310,315,320,325,330,334],{"title":299,"path":300,"stem":301,"icon":304},"i-lucide-list",{"title":306,"path":307,"stem":308,"icon":309},"Configuration reference","\u002Fdocs\u002Freference\u002Fconfiguration-reference","1.docs\u002F8.reference\u002F2.configuration-reference","i-lucide-table",{"title":311,"path":312,"stem":313,"icon":314},"REST API reference","\u002Fdocs\u002Freference\u002Frest-api-reference","1.docs\u002F8.reference\u002F3.rest-api-reference","i-lucide-network",{"title":316,"path":317,"stem":318,"icon":319},"Gradle plugin reference","\u002Fdocs\u002Freference\u002Fgradle-plugin-reference","1.docs\u002F8.reference\u002F4.gradle-plugin-reference","i-lucide-box",{"title":321,"path":322,"stem":323,"icon":324},"Maven reference","\u002Fdocs\u002Freference\u002Fmaven-reference","1.docs\u002F8.reference\u002F5.maven-reference","i-simple-icons-apachemaven",{"title":326,"path":327,"stem":328,"icon":329},"Kafka Streams compatibility matrix","\u002Fdocs\u002Freference\u002Fks-compatibility-matrix","1.docs\u002F8.reference\u002F6.ks-compatibility-matrix","i-lucide-table-2",{"title":331,"path":332,"stem":333,"icon":175},"Metrics reference","\u002Fdocs\u002Freference\u002Fmetrics-reference","1.docs\u002F8.reference\u002F7.metrics-reference",{"title":335,"path":336,"stem":337,"icon":338},"Glossary","\u002Fdocs\u002Freference\u002Fglossary","1.docs\u002F8.reference\u002F8.glossary","i-lucide-book-a",{"id":340,"cta":341,"enabled":342,"event":343,"extension":344,"invite":345,"key":346,"lead":347,"meta":348,"slot":349,"stem":350,"talk":351,"to":352,"__hash__":353},"banner\u002F8.banner.yml","Get the StoatFlow 1.0 launch email →",true,"Current San Francisco?","yml","Catch my talk","current-sf-2026","At",{},"Wed 4 Nov · 4:15 PM · Room 2012","8.banner","Kafka Streams Needs Real Timers","\u002Flaunch-list?src=banner","8xQWDSTSRv0J-LCPpHS5tuTxGF0xsQ8wMt5x2ajR2W0",{"id":355,"title":263,"body":356,"description":1923,"extension":1924,"meta":1925,"navigation":1926,"ogImage":1927,"pageType":1928,"path":264,"seo":1929,"sitemap":1930,"stem":265,"__hash__":1931},"docs\u002F1.docs\u002F6.operating\u002F8.licence-tool.md",{"type":357,"value":358,"toc":1913},"minimark",[359,371,427,432,439,544,551,555,564,636,651,653,677,697,699,733,738,800,803,805,831,838,856,858,906,940,959,1754,1757,1759,1836,1854,1858,1909],[360,361,362,366,367,370],"p",{},[363,364,365],"code",{},"stoatflow-licence-tool"," is a small command-line tool for your StoatFlow licences. It verifies a licence offline with the same code the engine runs, applies a licence to a Kafka cluster's licence registry (that is how renewals reach running applications), shows what the registry counts, and writes the usage reports your licence agreement may ask for. How licensing works is on ",[368,369,23],"a",{"href":24},"; this page is the how-to.",[372,373,374],"tldr-panel",{},[375,376,377,387,395,403,421],"ul",{},[378,379,380,386],"li",{},[381,382,383],"strong",{},[363,384,385],{},"verify"," a licence offline: what it grants, until when, and whether it verifies.",[378,388,389,394],{},[381,390,391],{},[363,392,393],{},"apply"," a licence to a cluster: running instances of the same licence id switch to it at once when its sequence number is higher — renewals, band changes and trial extensions, with no restart.",[378,396,397,402],{},[381,398,399],{},[363,400,401],{},"status"," shows what the licence registry holds and counts, per licence.",[378,404,405,410,411,414,415,420],{},[381,406,407],{},[363,408,409],{},"report"," writes the usage report (",[363,412,413],{},"stoatflow-usage\u002F1",") of one licence on one cluster; ",[381,416,417],{},[363,418,419],{},"fleet-report"," merges several clusters' reports.",[378,422,423,424,426],{},"It needs JDK 25 or newer and, for everything but ",[363,425,385],{},", network access to the brokers.",[428,429,431],"h2",{"id":430},"getting-the-tool","Getting the tool",[360,433,434,435,438],{},"Your Reposilite credentials (the same ones your build uses for StoatFlow artifacts) fetch the fat jar directly; use the version of the StoatFlow your applications run (currently ",[436,437],"stoatflow-version",{},"):",[440,441,446],"pre",{"className":442,"code":443,"language":444,"meta":445,"style":445},"language-bash shiki shiki-themes vitesse-light","curl -u customer-\u003Cslug>:\u003Ctoken> -O \\\n  \"https:\u002F\u002Fmaven.stoatflow.io\u002Freleases\u002Fio\u002Fstoatflow\u002Fstoatflow-licence-tool\u002F\u003Cversion>\u002Fstoatflow-licence-tool-\u003Cversion>-all.jar\"\n\njava -jar stoatflow-licence-tool-\u003Cversion>-all.jar --help\n","bash","",[363,447,448,498,511,517],{"__ignoreMap":445},[449,450,453,457,461,465,469,472,476,479,482,484,487,490,492,495],"span",{"class":451,"line":452},"line",1,[449,454,456],{"class":455},"sySUi","curl",[449,458,460],{"class":459},"sEi1f"," -u",[449,462,464],{"class":463},"spphp"," customer-",[449,466,468],{"class":467},"si04Y","\u003C",[449,470,471],{"class":463},"slu",[449,473,475],{"class":474},"suHK_","g",[449,477,478],{"class":467},">",[449,480,481],{"class":463},":",[449,483,468],{"class":467},[449,485,486],{"class":463},"toke",[449,488,489],{"class":474},"n",[449,491,478],{"class":467},[449,493,494],{"class":459}," -O",[449,496,497],{"class":459}," \\\n",[449,499,501,505,508],{"class":451,"line":500},2,[449,502,504],{"class":503},"sSP4y","  \"",[449,506,507],{"class":463},"https:\u002F\u002Fmaven.stoatflow.io\u002Freleases\u002Fio\u002Fstoatflow\u002Fstoatflow-licence-tool\u002F\u003Cversion>\u002Fstoatflow-licence-tool-\u003Cversion>-all.jar",[449,509,510],{"class":503},"\"\n",[449,512,514],{"class":451,"line":513},3,[449,515,516],{"emptyLinePlaceholder":342},"\n",[449,518,520,523,526,529,531,534,536,538,541],{"class":451,"line":519},4,[449,521,522],{"class":455},"java",[449,524,525],{"class":459}," -jar",[449,527,528],{"class":463}," stoatflow-licence-tool-",[449,530,468],{"class":467},[449,532,533],{"class":463},"versio",[449,535,489],{"class":474},[449,537,478],{"class":467},[449,539,540],{"class":463},"-all.jar",[449,542,543],{"class":459}," --help\n",[360,545,546,547,550],{},"Teams that resolve through their build can depend on ",[363,548,549],{},"io.stoatflow:stoatflow-licence-tool:\u003Cversion>:all",".",[428,552,554],{"id":553},"connecting-to-kafka","Connecting to Kafka",[360,556,557,558,560,561,563],{},"Every command but ",[363,559,385],{}," and ",[363,562,419],{}," (from files) takes:",[565,566,567,580],"table",{},[568,569,570],"thead",{},[571,572,573,577],"tr",{},[574,575,576],"th",{},"Option",[574,578,579],{},"Meaning",[581,582,583,594,615],"tbody",{},[571,584,585,591],{},[586,587,588],"td",{},[363,589,590],{},"--bootstrap-server",[586,592,593],{},"the Kafka cluster's bootstrap servers",[571,595,596,601],{},[586,597,598],{},[363,599,600],{},"--command-config",[586,602,603,604,607,608,607,611,614],{},"a properties file of client settings — ",[363,605,606],{},"security.protocol",", ",[363,609,610],{},"sasl.*",[363,612,613],{},"ssl.*"," — as Kafka's own tools take it",[571,616,617,622],{},[586,618,619],{},[363,620,621],{},"--topic",[586,623,624,625,628,629,632,633],{},"the licence registry topic, default ",[363,626,627],{},"__stoatflow_licence"," (the history topic is ",[363,630,631],{},"\u003Ctopic>_history","); set it when your applications set ",[363,634,635],{},"stoatflow.licence.registry.topic",[360,637,638,639,641,642,644,645,560,647,650],{},"The principal needs, per command: for ",[363,640,401],{},", DESCRIBE and READ on the registry topic; for ",[363,643,393],{},", WRITE on it too (and CREATE if it does not exist yet); for ",[363,646,409],{},[363,648,649],{},"fleet-report --bootstrap-servers",", DESCRIBE and READ on the registry topic (for the licence's terms) and on the history topic.",[428,652,385],{"id":385},[440,654,656],{"className":442,"code":655,"language":444,"meta":445,"style":445},"java -jar stoatflow-licence-tool-all.jar verify licence.sfl1     # a file, `-` for stdin, or the sfl1 string\n",[363,657,658],{"__ignoreMap":445},[449,659,660,662,664,667,670,673],{"class":451,"line":452},[449,661,522],{"class":455},[449,663,525],{"class":459},[449,665,666],{"class":463}," stoatflow-licence-tool-all.jar",[449,668,669],{"class":463}," verify",[449,671,672],{"class":463}," licence.sfl1",[449,674,676],{"class":675},"s8zF2","     # a file, `-` for stdin, or the sfl1 string\n",[360,678,679,680,683,684,607,687,607,690,607,693,696],{},"Prints the licence as JSON — licence id and sequence number, licensee, tier, allowances, standbys, cluster binding, expiry and ",[363,681,682],{},"\"expired\""," — and exits 0. A licence that does not verify is refused with its code (",[363,685,686],{},"MALFORMED",[363,688,689],{},"INVALID_SIGNATURE",[363,691,692],{},"UNKNOWN_KEY",[363,694,695],{},"KEY_SCOPE",") and exit code 1. No network access is used.",[428,698,393],{"id":393},[440,700,702],{"className":442,"code":701,"language":444,"meta":445,"style":445},"java -jar stoatflow-licence-tool-all.jar apply licence.sfl1 --bootstrap-server kafka:9092 \\\n  --command-config client.properties\n",[363,703,704,725],{"__ignoreMap":445},[449,705,706,708,710,712,715,717,720,723],{"class":451,"line":452},[449,707,522],{"class":455},[449,709,525],{"class":459},[449,711,666],{"class":463},[449,713,714],{"class":463}," apply",[449,716,672],{"class":463},[449,718,719],{"class":459}," --bootstrap-server",[449,721,722],{"class":463}," kafka:9092",[449,724,497],{"class":459},[449,726,727,730],{"class":451,"line":500},[449,728,729],{"class":459},"  --command-config",[449,731,732],{"class":463}," client.properties\n",[360,734,735,737],{},[363,736,393],{}," verifies the licence offline, then writes it to the registry topic (creating the topic if it does not exist):",[375,739,740,746,752,789],{},[378,741,742,745],{},[381,743,744],{},"Running instances"," of the same licence id switch to it at once when its sequence number is higher than theirs, and log the switch. A renewal ends a restart grace; a trial extension cancels a pending trial stop.",[378,747,748,751],{},[381,749,750],{},"Instances that start later"," use it too: the registry's licence wins over a configured one with a lower sequence number — also when the configured one has expired, or does not cover the instance's Kafka cluster or environment class.",[378,753,754,757,758,760,761,764,765,607,768,607,771,774,775,778,779,782,783,785,786,550],{},[381,755,756],{},"Refused:"," a licence that does not verify, one that has expired, one bound to other Kafka clusters (applied here, every restart would be refused), and one whose sequence number is not above the one already applied for its id — there is no rollback, also when a newer version of the tool applied that licence with a signing key this version does not hold. The refusal names that key: use the newest tool, and if it says the same, the record is not a StoatFlow licence — re-run ",[363,759,393],{}," with ",[363,762,763],{},"--replace-unverifiable"," to replace it. A record with a bad signature never blocks one. When runs apply the same licence at once, the highest sequence number stays applied, and the output of a run that lost says so (",[363,766,767],{},"\"applied\": false",[363,769,770],{},"\"superseded\": true",[363,772,773],{},"restoredSeq","); when the check for such a run cannot read the registry after the write, the output says ",[363,776,777],{},"\"concurrencyChecked\": false",", and when applies kept landing until it gave up, ",[363,780,781],{},"\"concurrencySettled\": false"," — run ",[363,784,401],{}," to see which licence the registry holds. When the cluster id cannot be read, a licence bound to clusters is applied unchecked, and the output says ",[363,787,788],{},"\"clusterChecked\": false",[378,790,791,792,795,796,799],{},"With ",[363,793,794],{},"stoatflow.licence.source: registry",", applications that configure no licence adopt it (see ",[368,797,23],{"href":798},"\u002Fdocs\u002Fgetting-started\u002Flicence-configuration#the-licence-registry-topics",").",[360,801,802],{},"A licence applied to one cluster reaches only that cluster's applications: apply it to each cluster.",[428,804,401],{"id":401},[440,806,808],{"className":442,"code":807,"language":444,"meta":445,"style":445},"java -jar stoatflow-licence-tool-all.jar status --bootstrap-server kafka:9092 [--licence lic_7Q2…]\n",[363,809,810],{"__ignoreMap":445},[449,811,812,814,816,818,821,823,825,828],{"class":451,"line":452},[449,813,522],{"class":455},[449,815,525],{"class":459},[449,817,666],{"class":463},[449,819,820],{"class":463}," status",[449,822,719],{"class":459},[449,824,722],{"class":463},[449,826,827],{"class":474}," [--licence ",[449,829,830],{"class":463},"lic_7Q2…]\n",[360,832,833,834,837],{},"Prints, per licence id on the registry topic: the applied licence (or ",[363,835,836],{},"null"," when none was applied), the live count per environment class — registered, starting, standbys running and counted, against the licensed count and cap — the counted services with their application ids, and the trial ledger entry for a trial. It writes nothing.",[360,839,840,841,844,845,848,849,852,853,799],{},"An instance counts as live by the brokers' clock — within 90 seconds of the topic's newest record — so the count does not depend on the clock of the machine running the tool (",[363,842,843],{},"\"liveness\": \"brokers\"","). When the newest record is older than that 90-second window plus five minutes (about 6.5 minutes) by that machine's clock, no instance is heartbeating and the output says ",[363,846,847],{},"\"stale\": true",". On a registry topic with ",[363,850,851],{},"message.timestamp.type=CreateTime"," each record is judged by its writer's clock against the tool's (",[363,854,855],{},"\"liveness\": \"writer-clock\"",[428,857,409],{"id":409},[440,859,861],{"className":442,"code":860,"language":444,"meta":445,"style":445},"java -jar stoatflow-licence-tool-all.jar report --bootstrap-server kafka:9092 \\\n  --licence lic_7Q2… --from 2026-10-01 --to 2027-09-30 --output usage-acme-2027.json\n",[363,862,863,880],{"__ignoreMap":445},[449,864,865,867,869,871,874,876,878],{"class":451,"line":452},[449,866,522],{"class":455},[449,868,525],{"class":459},[449,870,666],{"class":463},[449,872,873],{"class":463}," report",[449,875,719],{"class":459},[449,877,722],{"class":463},[449,879,497],{"class":459},[449,881,882,885,888,891,894,897,900,903],{"class":451,"line":500},[449,883,884],{"class":459},"  --licence",[449,886,887],{"class":463}," lic_7Q2…",[449,889,890],{"class":459}," --from",[449,892,893],{"class":463}," 2026-10-01",[449,895,896],{"class":459}," --to",[449,898,899],{"class":463}," 2027-09-30",[449,901,902],{"class":459}," --output",[449,904,905],{"class":463}," usage-acme-2027.json\n",[360,907,908,909,912,913,916,917,920,921,924,925,928,929,932,933,936,937,550],{},"The usage report of one licence on this cluster for the UTC days ",[363,910,911],{},"--from"," to ",[363,914,915],{},"--to"," (default: today), read from the history topic by time window. ",[363,918,919],{},"--licence"," takes the licence id — its terms then come from the licence applied to the registry, when there is one — or the licence itself (a file or the ",[363,922,923],{},"sfl1"," string); an argument that names no file and is not a licence id (",[363,926,927],{},"lic_…",") is a usage error. Application ids and services appear as hashes unless you add ",[363,930,931],{},"--include-app-names",". What it contains is described on ",[368,934,23],{"href":935},"\u002Fdocs\u002Fgetting-started\u002Flicence-configuration#usage-history-and-reports","; a running application serves the same report at ",[363,938,939],{},"GET \u002Flicence\u002Fusage",[360,941,942,943,946,947,950,951,954,955,958],{},"The history read may take two minutes; ",[363,944,945],{},"--timeout"," gives it more, as an ISO-8601 duration (",[363,948,949],{},"--timeout PT10M"," for a year's report over a slow link). A missing history topic is reported at once. ",[363,952,953],{},"registry.brokerClock"," says whether the history topic carries your brokers' clock (",[363,956,957],{},"message.timestamp.type=LogAppendTime",", as StoatFlow creates it).",[440,960,964],{"className":961,"code":962,"language":963,"meta":445,"style":445},"language-json shiki shiki-themes vitesse-light","{\n  \"format\": \"stoatflow-usage\u002F1\",\n  \"licence\": {\"lid\": \"lic_7Q2…\", \"seq\": 3, \"licensee\": \"ACME Corp\", \"tier\": \"production\",\n              \"allowances\": {\"production\": {\"services\": 25}}, \"standbys\": {\"free\": 1}},\n  \"cluster\": {\"id\": \"\u003CKafka cluster id>\"},\n  \"period\": {\"from\": \"2026-10-01\", \"to\": \"2027-09-30\"},\n  \"registry\": {\"brokerClock\": true, \"unverifiedHours\": 0, \"historyGapHours\": 0},\n  \"classes\": {\n    \"production\": {\"peakConcurrent\": 26, \"p95DailyPeak\": 24, \"avgDailyPeak\": 21.3, \"distinctServices\": 31,\n                   \"daysOverLicensed\": 2, \"standbys\": {\"peakRunning\": 4, \"peakCounted\": 1}},\n    \"staging\": {\"peakConcurrent\": 22, \"distinctServices\": 40}\n  },\n  \"environments\": [{\"label\": \"prd-eu\", \"class\": \"production\", \"peak\": 14}],\n  \"services\": [{\"service\": \"\u003Chash>\", \"environment\": \"prd-eu\", \"class\": \"production\", \"applicationIds\": [\"\u003Chash>\"]}],\n  \"daily\": [{\"date\": \"2026-10-01\", \"class\": \"production\", \"distinct\": 19, \"peak\": 19, \"standbysCounted\": 0}],\n  \"engineVersions\": {\"1.0.3\": 18, \"1.1.0\": 23}\n}\n","json",[363,965,966,972,996,1080,1145,1178,1228,1284,1299,1369,1424,1465,1471,1536,1621,1707,1749],{"__ignoreMap":445},[449,967,968],{"class":451,"line":452},[449,969,971],{"class":970},"sYZai","{\n",[449,973,974,977,981,984,986,989,991,993],{"class":451,"line":500},[449,975,504],{"class":976},"s61at",[449,978,980],{"class":979},"su6XF","format",[449,982,983],{"class":976},"\"",[449,985,481],{"class":970},[449,987,988],{"class":503}," \"",[449,990,413],{"class":463},[449,992,983],{"class":503},[449,994,995],{"class":970},",\n",[449,997,998,1000,1003,1005,1007,1010,1012,1015,1017,1019,1021,1024,1026,1029,1031,1034,1036,1038,1042,1044,1046,1049,1051,1053,1055,1058,1060,1062,1064,1067,1069,1071,1073,1076,1078],{"class":451,"line":513},[449,999,504],{"class":976},[449,1001,1002],{"class":979},"licence",[449,1004,983],{"class":976},[449,1006,481],{"class":970},[449,1008,1009],{"class":970}," {",[449,1011,983],{"class":976},[449,1013,1014],{"class":979},"lid",[449,1016,983],{"class":976},[449,1018,481],{"class":970},[449,1020,988],{"class":503},[449,1022,1023],{"class":463},"lic_7Q2…",[449,1025,983],{"class":503},[449,1027,1028],{"class":970},",",[449,1030,988],{"class":976},[449,1032,1033],{"class":979},"seq",[449,1035,983],{"class":976},[449,1037,481],{"class":970},[449,1039,1041],{"class":1040},"s-TwI"," 3",[449,1043,1028],{"class":970},[449,1045,988],{"class":976},[449,1047,1048],{"class":979},"licensee",[449,1050,983],{"class":976},[449,1052,481],{"class":970},[449,1054,988],{"class":503},[449,1056,1057],{"class":463},"ACME Corp",[449,1059,983],{"class":503},[449,1061,1028],{"class":970},[449,1063,988],{"class":976},[449,1065,1066],{"class":979},"tier",[449,1068,983],{"class":976},[449,1070,481],{"class":970},[449,1072,988],{"class":503},[449,1074,1075],{"class":463},"production",[449,1077,983],{"class":503},[449,1079,995],{"class":970},[449,1081,1082,1085,1088,1090,1092,1094,1096,1098,1100,1102,1104,1106,1109,1111,1113,1116,1119,1121,1124,1126,1128,1130,1132,1135,1137,1139,1142],{"class":451,"line":519},[449,1083,1084],{"class":976},"              \"",[449,1086,1087],{"class":979},"allowances",[449,1089,983],{"class":976},[449,1091,481],{"class":970},[449,1093,1009],{"class":970},[449,1095,983],{"class":976},[449,1097,1075],{"class":979},[449,1099,983],{"class":976},[449,1101,481],{"class":970},[449,1103,1009],{"class":970},[449,1105,983],{"class":976},[449,1107,1108],{"class":979},"services",[449,1110,983],{"class":976},[449,1112,481],{"class":970},[449,1114,1115],{"class":1040}," 25",[449,1117,1118],{"class":970},"}},",[449,1120,988],{"class":976},[449,1122,1123],{"class":979},"standbys",[449,1125,983],{"class":976},[449,1127,481],{"class":970},[449,1129,1009],{"class":970},[449,1131,983],{"class":976},[449,1133,1134],{"class":979},"free",[449,1136,983],{"class":976},[449,1138,481],{"class":970},[449,1140,1141],{"class":1040}," 1",[449,1143,1144],{"class":970},"}},\n",[449,1146,1148,1150,1153,1155,1157,1159,1161,1164,1166,1168,1170,1173,1175],{"class":451,"line":1147},5,[449,1149,504],{"class":976},[449,1151,1152],{"class":979},"cluster",[449,1154,983],{"class":976},[449,1156,481],{"class":970},[449,1158,1009],{"class":970},[449,1160,983],{"class":976},[449,1162,1163],{"class":979},"id",[449,1165,983],{"class":976},[449,1167,481],{"class":970},[449,1169,988],{"class":503},[449,1171,1172],{"class":463},"\u003CKafka cluster id>",[449,1174,983],{"class":503},[449,1176,1177],{"class":970},"},\n",[449,1179,1181,1183,1186,1188,1190,1192,1194,1197,1199,1201,1203,1206,1208,1210,1212,1215,1217,1219,1221,1224,1226],{"class":451,"line":1180},6,[449,1182,504],{"class":976},[449,1184,1185],{"class":979},"period",[449,1187,983],{"class":976},[449,1189,481],{"class":970},[449,1191,1009],{"class":970},[449,1193,983],{"class":976},[449,1195,1196],{"class":979},"from",[449,1198,983],{"class":976},[449,1200,481],{"class":970},[449,1202,988],{"class":503},[449,1204,1205],{"class":463},"2026-10-01",[449,1207,983],{"class":503},[449,1209,1028],{"class":970},[449,1211,988],{"class":976},[449,1213,1214],{"class":979},"to",[449,1216,983],{"class":976},[449,1218,481],{"class":970},[449,1220,988],{"class":503},[449,1222,1223],{"class":463},"2027-09-30",[449,1225,983],{"class":503},[449,1227,1177],{"class":970},[449,1229,1231,1233,1236,1238,1240,1242,1244,1247,1249,1251,1255,1257,1259,1262,1264,1266,1269,1271,1273,1276,1278,1280,1282],{"class":451,"line":1230},7,[449,1232,504],{"class":976},[449,1234,1235],{"class":979},"registry",[449,1237,983],{"class":976},[449,1239,481],{"class":970},[449,1241,1009],{"class":970},[449,1243,983],{"class":976},[449,1245,1246],{"class":979},"brokerClock",[449,1248,983],{"class":976},[449,1250,481],{"class":970},[449,1252,1254],{"class":1253},"sbBg2"," true",[449,1256,1028],{"class":970},[449,1258,988],{"class":976},[449,1260,1261],{"class":979},"unverifiedHours",[449,1263,983],{"class":976},[449,1265,481],{"class":970},[449,1267,1268],{"class":1040}," 0",[449,1270,1028],{"class":970},[449,1272,988],{"class":976},[449,1274,1275],{"class":979},"historyGapHours",[449,1277,983],{"class":976},[449,1279,481],{"class":970},[449,1281,1268],{"class":1040},[449,1283,1177],{"class":970},[449,1285,1287,1289,1292,1294,1296],{"class":451,"line":1286},8,[449,1288,504],{"class":976},[449,1290,1291],{"class":979},"classes",[449,1293,983],{"class":976},[449,1295,481],{"class":970},[449,1297,1298],{"class":970}," {\n",[449,1300,1302,1305,1307,1309,1311,1313,1315,1318,1320,1322,1325,1327,1329,1332,1334,1336,1339,1341,1343,1346,1348,1350,1353,1355,1357,1360,1362,1364,1367],{"class":451,"line":1301},9,[449,1303,1304],{"class":976},"    \"",[449,1306,1075],{"class":979},[449,1308,983],{"class":976},[449,1310,481],{"class":970},[449,1312,1009],{"class":970},[449,1314,983],{"class":976},[449,1316,1317],{"class":979},"peakConcurrent",[449,1319,983],{"class":976},[449,1321,481],{"class":970},[449,1323,1324],{"class":1040}," 26",[449,1326,1028],{"class":970},[449,1328,988],{"class":976},[449,1330,1331],{"class":979},"p95DailyPeak",[449,1333,983],{"class":976},[449,1335,481],{"class":970},[449,1337,1338],{"class":1040}," 24",[449,1340,1028],{"class":970},[449,1342,988],{"class":976},[449,1344,1345],{"class":979},"avgDailyPeak",[449,1347,983],{"class":976},[449,1349,481],{"class":970},[449,1351,1352],{"class":1040}," 21.3",[449,1354,1028],{"class":970},[449,1356,988],{"class":976},[449,1358,1359],{"class":979},"distinctServices",[449,1361,983],{"class":976},[449,1363,481],{"class":970},[449,1365,1366],{"class":1040}," 31",[449,1368,995],{"class":970},[449,1370,1372,1375,1378,1380,1382,1385,1387,1389,1391,1393,1395,1397,1399,1402,1404,1406,1409,1411,1413,1416,1418,1420,1422],{"class":451,"line":1371},10,[449,1373,1374],{"class":976},"                   \"",[449,1376,1377],{"class":979},"daysOverLicensed",[449,1379,983],{"class":976},[449,1381,481],{"class":970},[449,1383,1384],{"class":1040}," 2",[449,1386,1028],{"class":970},[449,1388,988],{"class":976},[449,1390,1123],{"class":979},[449,1392,983],{"class":976},[449,1394,481],{"class":970},[449,1396,1009],{"class":970},[449,1398,983],{"class":976},[449,1400,1401],{"class":979},"peakRunning",[449,1403,983],{"class":976},[449,1405,481],{"class":970},[449,1407,1408],{"class":1040}," 4",[449,1410,1028],{"class":970},[449,1412,988],{"class":976},[449,1414,1415],{"class":979},"peakCounted",[449,1417,983],{"class":976},[449,1419,481],{"class":970},[449,1421,1141],{"class":1040},[449,1423,1144],{"class":970},[449,1425,1427,1429,1432,1434,1436,1438,1440,1442,1444,1446,1449,1451,1453,1455,1457,1459,1462],{"class":451,"line":1426},11,[449,1428,1304],{"class":976},[449,1430,1431],{"class":979},"staging",[449,1433,983],{"class":976},[449,1435,481],{"class":970},[449,1437,1009],{"class":970},[449,1439,983],{"class":976},[449,1441,1317],{"class":979},[449,1443,983],{"class":976},[449,1445,481],{"class":970},[449,1447,1448],{"class":1040}," 22",[449,1450,1028],{"class":970},[449,1452,988],{"class":976},[449,1454,1359],{"class":979},[449,1456,983],{"class":976},[449,1458,481],{"class":970},[449,1460,1461],{"class":1040}," 40",[449,1463,1464],{"class":970},"}\n",[449,1466,1468],{"class":451,"line":1467},12,[449,1469,1470],{"class":970},"  },\n",[449,1472,1474,1476,1479,1481,1483,1486,1488,1491,1493,1495,1497,1500,1502,1504,1506,1509,1511,1513,1515,1517,1519,1521,1523,1526,1528,1530,1533],{"class":451,"line":1473},13,[449,1475,504],{"class":976},[449,1477,1478],{"class":979},"environments",[449,1480,983],{"class":976},[449,1482,481],{"class":970},[449,1484,1485],{"class":970}," [{",[449,1487,983],{"class":976},[449,1489,1490],{"class":979},"label",[449,1492,983],{"class":976},[449,1494,481],{"class":970},[449,1496,988],{"class":503},[449,1498,1499],{"class":463},"prd-eu",[449,1501,983],{"class":503},[449,1503,1028],{"class":970},[449,1505,988],{"class":976},[449,1507,1508],{"class":979},"class",[449,1510,983],{"class":976},[449,1512,481],{"class":970},[449,1514,988],{"class":503},[449,1516,1075],{"class":463},[449,1518,983],{"class":503},[449,1520,1028],{"class":970},[449,1522,988],{"class":976},[449,1524,1525],{"class":979},"peak",[449,1527,983],{"class":976},[449,1529,481],{"class":970},[449,1531,1532],{"class":1040}," 14",[449,1534,1535],{"class":970},"}],\n",[449,1537,1539,1541,1543,1545,1547,1549,1551,1554,1556,1558,1560,1563,1565,1567,1569,1572,1574,1576,1578,1580,1582,1584,1586,1588,1590,1592,1594,1596,1598,1600,1602,1605,1607,1609,1612,1614,1616,1618],{"class":451,"line":1538},14,[449,1540,504],{"class":976},[449,1542,1108],{"class":979},[449,1544,983],{"class":976},[449,1546,481],{"class":970},[449,1548,1485],{"class":970},[449,1550,983],{"class":976},[449,1552,1553],{"class":979},"service",[449,1555,983],{"class":976},[449,1557,481],{"class":970},[449,1559,988],{"class":503},[449,1561,1562],{"class":463},"\u003Chash>",[449,1564,983],{"class":503},[449,1566,1028],{"class":970},[449,1568,988],{"class":976},[449,1570,1571],{"class":979},"environment",[449,1573,983],{"class":976},[449,1575,481],{"class":970},[449,1577,988],{"class":503},[449,1579,1499],{"class":463},[449,1581,983],{"class":503},[449,1583,1028],{"class":970},[449,1585,988],{"class":976},[449,1587,1508],{"class":979},[449,1589,983],{"class":976},[449,1591,481],{"class":970},[449,1593,988],{"class":503},[449,1595,1075],{"class":463},[449,1597,983],{"class":503},[449,1599,1028],{"class":970},[449,1601,988],{"class":976},[449,1603,1604],{"class":979},"applicationIds",[449,1606,983],{"class":976},[449,1608,481],{"class":970},[449,1610,1611],{"class":970}," [",[449,1613,983],{"class":503},[449,1615,1562],{"class":463},[449,1617,983],{"class":503},[449,1619,1620],{"class":970},"]}],\n",[449,1622,1624,1626,1629,1631,1633,1635,1637,1640,1642,1644,1646,1648,1650,1652,1654,1656,1658,1660,1662,1664,1666,1668,1670,1673,1675,1677,1680,1682,1684,1686,1688,1690,1692,1694,1696,1699,1701,1703,1705],{"class":451,"line":1623},15,[449,1625,504],{"class":976},[449,1627,1628],{"class":979},"daily",[449,1630,983],{"class":976},[449,1632,481],{"class":970},[449,1634,1485],{"class":970},[449,1636,983],{"class":976},[449,1638,1639],{"class":979},"date",[449,1641,983],{"class":976},[449,1643,481],{"class":970},[449,1645,988],{"class":503},[449,1647,1205],{"class":463},[449,1649,983],{"class":503},[449,1651,1028],{"class":970},[449,1653,988],{"class":976},[449,1655,1508],{"class":979},[449,1657,983],{"class":976},[449,1659,481],{"class":970},[449,1661,988],{"class":503},[449,1663,1075],{"class":463},[449,1665,983],{"class":503},[449,1667,1028],{"class":970},[449,1669,988],{"class":976},[449,1671,1672],{"class":979},"distinct",[449,1674,983],{"class":976},[449,1676,481],{"class":970},[449,1678,1679],{"class":1040}," 19",[449,1681,1028],{"class":970},[449,1683,988],{"class":976},[449,1685,1525],{"class":979},[449,1687,983],{"class":976},[449,1689,481],{"class":970},[449,1691,1679],{"class":1040},[449,1693,1028],{"class":970},[449,1695,988],{"class":976},[449,1697,1698],{"class":979},"standbysCounted",[449,1700,983],{"class":976},[449,1702,481],{"class":970},[449,1704,1268],{"class":1040},[449,1706,1535],{"class":970},[449,1708,1710,1712,1715,1717,1719,1721,1723,1726,1728,1730,1733,1735,1737,1740,1742,1744,1747],{"class":451,"line":1709},16,[449,1711,504],{"class":976},[449,1713,1714],{"class":979},"engineVersions",[449,1716,983],{"class":976},[449,1718,481],{"class":970},[449,1720,1009],{"class":970},[449,1722,983],{"class":976},[449,1724,1725],{"class":979},"1.0.3",[449,1727,983],{"class":976},[449,1729,481],{"class":970},[449,1731,1732],{"class":1040}," 18",[449,1734,1028],{"class":970},[449,1736,988],{"class":976},[449,1738,1739],{"class":979},"1.1.0",[449,1741,983],{"class":976},[449,1743,481],{"class":970},[449,1745,1746],{"class":1040}," 23",[449,1748,1464],{"class":970},[449,1750,1752],{"class":451,"line":1751},17,[449,1753,1464],{"class":970},[360,1755,1756],{},"The report is yours: read every byte before you send it.",[428,1758,419],{"id":419},[440,1760,1762],{"className":442,"code":1761,"language":444,"meta":445,"style":445},"java -jar stoatflow-licence-tool-all.jar fleet-report usage-eu.json usage-us.json usage-apac.json\n# or build each cluster's report first:\njava -jar stoatflow-licence-tool-all.jar fleet-report --licence lic_7Q2… --from 2026-10-01 --to 2027-09-30 \\\n  --bootstrap-servers kafka-eu-1:9092,kafka-eu-2:9092 --bootstrap-servers kafka-us-1:9092 \\\n  --command-config client.properties\n",[363,1763,1764,1784,1789,1814,1830],{"__ignoreMap":445},[449,1765,1766,1768,1770,1772,1775,1778,1781],{"class":451,"line":452},[449,1767,522],{"class":455},[449,1769,525],{"class":459},[449,1771,666],{"class":463},[449,1773,1774],{"class":463}," fleet-report",[449,1776,1777],{"class":463}," usage-eu.json",[449,1779,1780],{"class":463}," usage-us.json",[449,1782,1783],{"class":463}," usage-apac.json\n",[449,1785,1786],{"class":451,"line":500},[449,1787,1788],{"class":675},"# or build each cluster's report first:\n",[449,1790,1791,1793,1795,1797,1799,1802,1804,1806,1808,1810,1812],{"class":451,"line":513},[449,1792,522],{"class":455},[449,1794,525],{"class":459},[449,1796,666],{"class":463},[449,1798,1774],{"class":463},[449,1800,1801],{"class":459}," --licence",[449,1803,887],{"class":463},[449,1805,890],{"class":459},[449,1807,893],{"class":463},[449,1809,896],{"class":459},[449,1811,899],{"class":463},[449,1813,497],{"class":459},[449,1815,1816,1819,1822,1825,1828],{"class":451,"line":519},[449,1817,1818],{"class":459},"  --bootstrap-servers",[449,1820,1821],{"class":463}," kafka-eu-1:9092,kafka-eu-2:9092",[449,1823,1824],{"class":459}," --bootstrap-servers",[449,1826,1827],{"class":463}," kafka-us-1:9092",[449,1829,497],{"class":459},[449,1831,1832,1834],{"class":451,"line":1147},[449,1833,729],{"class":459},[449,1835,732],{"class":463},[360,1837,1838,1839,1842,1843,1846,1847,1850,1851,1853],{},"Merges one licence's per-cluster reports into one document (",[363,1840,1841],{},"stoatflow-fleet-usage\u002F1","): each class's ",[381,1844,1845],{},"daily total is the sum of each cluster's daily peak"," — an upper bound, since a service lives in one cluster and clusters may peak at different hours — with its peak, 95th percentile and average over the period, the days over the licensed count, and the list of clusters. Give ",[363,1848,1849],{},"--bootstrap-servers"," once per cluster, each with that cluster's bootstrap servers; ",[363,1852,945],{}," applies to each cluster's history read. Reports of different licences or different periods, two of one cluster, or one without a cluster id are refused.",[428,1855,1857],{"id":1856},"exit-codes","Exit codes",[565,1859,1860,1869],{},[568,1861,1862],{},[571,1863,1864,1867],{},[574,1865,1866],{},"Code",[574,1868,579],{},[581,1870,1871,1889,1899],{},[571,1872,1873,1878],{},[586,1874,1875],{},[363,1876,1877],{},"0",[586,1879,1880,1881,1884,1885,1888],{},"done; the JSON is on stdout — with ",[363,1882,1883],{},"report --output",", the report is in the file and stdout has a ",[363,1886,1887],{},"written"," confirmation (logs go to stderr)",[571,1890,1891,1896],{},[586,1892,1893],{},[363,1894,1895],{},"1",[586,1897,1898],{},"refused: a licence that does not verify, a sequence number that is not higher, a report of another format",[571,1900,1901,1906],{},[586,1902,1903],{},[363,1904,1905],{},"2",[586,1907,1908],{},"a usage or connection error",[1910,1911,1912],"style",{},"html pre.shiki code .sySUi, html code.shiki .sySUi{--shiki-default:#59873A}html pre.shiki code .sEi1f, html code.shiki .sEi1f{--shiki-default:#A65E2B}html pre.shiki code .spphp, html code.shiki .spphp{--shiki-default:#B56959}html pre.shiki code .si04Y, html code.shiki .si04Y{--shiki-default:#AB5959}html pre.shiki code .suHK_, html code.shiki .suHK_{--shiki-default:#393A34}html pre.shiki code .sSP4y, html code.shiki .sSP4y{--shiki-default:#B5695977}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .s8zF2, html code.shiki .s8zF2{--shiki-default:#A0ADA0}html pre.shiki code .sYZai, html code.shiki .sYZai{--shiki-default:#999999}html pre.shiki code .s61at, html code.shiki .s61at{--shiki-default:#99841877}html pre.shiki code .su6XF, html code.shiki .su6XF{--shiki-default:#998418}html pre.shiki code .s-TwI, html code.shiki .s-TwI{--shiki-default:#2F798A}html pre.shiki code .sbBg2, html code.shiki .sbBg2{--shiki-default:#1E754F}",{"title":445,"searchDepth":500,"depth":500,"links":1914},[1915,1916,1917,1918,1919,1920,1921,1922],{"id":430,"depth":500,"text":431},{"id":553,"depth":500,"text":554},{"id":385,"depth":500,"text":385},{"id":393,"depth":500,"text":393},{"id":401,"depth":500,"text":401},{"id":409,"depth":500,"text":409},{"id":419,"depth":500,"text":419},{"id":1856,"depth":500,"text":1857},"How to run stoatflow-licence-tool — verify a StoatFlow licence offline, apply a renewal to a Kafka cluster's licence registry without a restart, see what the registry counts, and produce the usage and fleet reports.","md",{},{"icon":266},null,"how-to",{"title":263,"description":1923},{"loc":264},"FpeP6ewjVG5ZHw8D6dNYs388lr6bUVjwhzF3UEKHG5c",[1933,1935],{"title":258,"path":259,"stem":260,"description":1934,"icon":261,"children":-1},"A go-live checklist for StoatFlow — replica count, licence, probes, metrics, error policies, tuning, and thread safety — each item linking to the canonical page that covers it in full.",{"title":268,"path":269,"stem":270,"description":1936,"icon":90,"children":-1},"What carries over unchanged when you move a Kafka Streams topology to StoatFlow, what changes operationally, and how to decide between a green-field cutover and a state-carrying migration.",1795299047672]