Kafka Message Payload Decoder

A record payload, decoded from base64 or hex. If it starts with a schema registry header, the report says so and names the schema id, because that is the reason it will not parse as anything else.

Base64 is tried before hex, because a record payload usually comes from a console consumer or a log line rather than from a hex dump. Nothing is sent anywhere: the decoding happens in this tab.

Paste below, or drop a file anywhere on this panel

Or drop a file anywhere on this panel. Nothing is uploaded: the analysis runs in this tab.

The answer appears here

Paste on the left and press Decode. Nothing leaves this tab.

Examples

Real input you can load into the tool above. Each one shows a different thing going wrong, because that is what the tool is for.

A base64 JSON payload

What a consumer actually received, decoded through the encodings Kafka tooling prints

eyJpZCI6MTIzfQ==

A plain JSON value

A payload that is already readable, and what the tool says about its shape

{"orderId":1001,"status":"shipped"}

Common mistakes

These are the ones that fail silently. The config is accepted, nothing raises an error, and the consequence arrives later.

  1. Assuming a payload is UTF-8 because it looks like text

    Avro and Protobuf payloads contain readable substrings, so a payload can look like broken text while being perfectly valid binary.

    Instead:Check the first bytes. A Confluent payload starts with a zero magic byte and a schema id.

  2. Reading console-consumer output as the raw bytes

    kafka-console-consumer applies a deserializer, by default a string one, so anything not valid UTF-8 is replaced with substitution characters before you see it.

    Instead:Use a ByteArrayDeserializer with base64 output when the bytes matter.

Why a Kafka payload does not decode as what it looks like

Most payloads that fail to parse are framed rather than corrupt, and the framing is five bytes people do not know are there.

A zero first byte is a schema registry header, not data

The Confluent wire format puts a zero magic byte and a four byte big-endian schema id in front of every payload. So a record written through an Avro or protobuf serializer starts with five bytes that are not the message, and reading the whole buffer as JSON fails on the leading nulls while reading it as text shows a few unprintable characters and then nothing useful. Protobuf adds a message-index array after the id, which moves the offset again.

The schema id is all the record carries

Avro and protobuf binary encodings contain no field names and no type information: the schema turns the bytes into fields, and the record only holds a reference to it. That is what makes them compact, and it is also why losing the registry's _schemas topic makes every existing message permanently undecodable. This page reads the id and stops there, because fetching the schema would mean calling a service.

Base64 or hex is a question about where you copied it from

kafka-console-consumer.sh and most log lines give base64, and a byte dump from a hex editor or xxd gives hex. Base64 is tried first here for that reason, which is the opposite default from the CRC calculator on this site, where the input is usually a byte dump. Same ambiguity, different likely source.

A payload at this level is never compressed

Kafka compresses a whole record batch rather than individual records, and the consumer decompresses the batch before handing over a record. So a payload that looks like compressed bytes is either not a payload, or the producer compressed the value itself before serializing it, which is a decision made in application code rather than by Kafka.

What this cannot see

It does not fetch schemas, so an Avro or protobuf payload stops at the header and the schema id. It also cannot tell a bare Avro payload from any other binary encoding, because without a registry header there is nothing to identify it. For the header itself in more detail, the Confluent wire format decoder on this site reads the magic byte and the message-index array; for checksums the CRC32C calculator verifies a whole record batch.

More kafka tools

Kafka Confluent Wire Format Decoder The five junk bytes in front of your payload Kafka Key to Partition Mapper Which partition does this key land on? Kafka Topic Name Validator Legal, risky, or 249 characters too long? Kafka Replication Safety Checker How many brokers can you lose Kafka Producer Config Linter Will it start, and will it lose a record? Kafka Connect Source Connector Generator tasks.max is a ceiling, not a count Kafka Connect Sink Connector Generator A dead letter queue with no context headers is a pile of records Kafka Connect SMT Chain Builder The order is the transforms list Kafka MirrorMaker 2 Config Generator It renames every topic by default Kafka Partition Reassignment Generator The throttle is not optional Strimzi Kafka Resource Generator Without the cluster label, nothing happens Kafka mTLS Config Generator The certificate is the identity Kafka Schema Registry Config Generator The compatibility direction is your deployment order Kafka Exactly-Once Config Generator Half of it is worse than none Kafka Broker and KRaft Config Generator The internal topics that break a one-broker cluster Kafka Quota Generator Byte rates are per broker, not per cluster Kafka Streams Config Generator application.id is four things at once Kafka Connect Worker Config Generator Security three times, or the tasks fail Kafka Retention and Unit Converter log.retention.hours does not take milliseconds Kafka Timestamp Converter Two sentinels and two meanings Kafka .properties to YAML Converter Dotted keys stay flat Kafka Streams Internal Topic Predictor Create them before Streams does Kafka ACL Generator The grant you forgot is on another resource type Kafka Topic Config Generator min.insync.replicas is the one that matters Kafka client.properties Generator The file every CLI tool asks for Kafka Producer Config Generator No password field, on purpose Kafka Consumer Config Generator The commit mode decides the semantics Kafka Disk and Retention Calculator retention.bytes is per partition Kafka Partition Count Calculator The number you can never reduce Kafka Cluster Sizing Calculator The traffic no client metric shows Kafka Consumer Lag Catch-Up Calculator Whether it ever clears, not just when Kafka Producer Batching Calculator linger.ms=0 still batches Kafka Segment and Index Sizing Why retention.ms is a lower bound Kafka Rebalance Duration Estimator What a rolling restart really costs Kafka Cost Estimator Your rates, so nothing goes stale Kafka Config Explorer by Version The answer depends on the release Kafka Default Config Reference What moved under a config you never edited Kafka OAuth Bearer Token Decoder Will Kafka accept it, and can it refresh Kafka Record Header Viewer Headers are a list, not a map Kafka Topic Regex Subscription Tester Kafka matches the whole name Kafka ACL Permission Matrix Viewer DENY beats every ALLOW Kafka Connect Config Validator The mistakes that raise no error Kafka Consumer Group Id Validator Which broker coordinates the group Kafka Partition Assignment Visualizer Leadership is the load, not replicas Kafka Consumer Assignment Visualizer The three assignors disagree Kafka ZooKeeper to KRaft Config Converter The authorizer class nobody changes Kafka Config to Strimzi Half of it belongs elsewhere Kafka Docker Compose Generator (KRaft) Reachable from inside and outside Kafka JAAS Config Decoder The line that stops SASL working Kafka CRC32C Calculator Which CRC, over which bytes Kafka Config Upgrade Checker What breaks when you upgrade Kafka Kafka Config Diff Which change actually changed something Kafka Consumer Config Linter Why the group rebalances, and where the records went Kafka Avro Schema Validator The defaults Avro accepts and rejects Kafka Schema Compatibility Checker What the registry will say, before you ask it Kafka Avro Schema Diff Which direction each change breaks Kafka Compression Comparison Measured on your bytes Kafka Delivery Semantics Exactly-once has a consumer half Kafka ksqlDB Query Builder It looks like SQL and the rules are not Kafka Connect SMT Predicate Tester negate reads backwards Kafka Streams Topology Viewer Count the repartitions Kafka Connect Pipeline Visualizer The order things really run in Kafka Protobuf Binary Decoder Works without the .proto Kafka Protobuf JSON Converter Why your JSON does not round-trip Kafka Protobuf to Avro Schema What does not survive the conversion Kafka Avro Binary Decoder Wrong schema, no error Kafka Avro JSON Converter Why the console producer rejects your line Kafka Avro Sample Data Generator Records that actually serialize Kafka JSON to Avro Schema What JSON cannot tell you Kafka JSON Schema to Avro What does not survive the conversion Kafka SASL JAAS Generator One login module, four syntaxes Kafka CLI Command Builder kcat is librdkafka, not Kafka

Elsewhere on the site