{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Kafka event streaming troubleshooting","description":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API.","siteUrl":"https://docs.upvest.co","image":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png","keywords":"documentation, api","lang":"en-US","meta":[{"name":"description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:title","content":"Welcome to the Upvest API Documentation"},{"name":"twitter:image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"},{"name":"twitter:description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"og:url","content":"https://docs.upvest.co/"},{"name":"og:title","content":"Welcome to the Upvest API Documentation"},{"name":"og:description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"og:image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"}]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"kafka-event-streaming-troubleshooting","__idx":0},"children":["Kafka event streaming troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-failed","__idx":1},"children":["Authentication failed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the username and password. Both values are case-sensitive. Also, confirm that you are using the credentials for the correct environment, and that the SASL mechanism matches the one provided by Upvest."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connection-refused-or-timeout","__idx":2},"children":["Connection refused or timeout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm the bootstrap server hostname and port match what Upvest provided, and that your network allows outbound TCP to the broker. Check any corporate firewall rules."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"topic-not-found","__idx":3},"children":["Topic not found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify the topic name matches exactly, as names are case-sensitive. If a topic should be accessible but is not, contact your Upvest representative."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tls-errors","__idx":4},"children":["TLS errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No custom certificate is required on your side. Make sure your runtime's system CA bundle is up to date, and never disable TLS verification in production."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"events-arriving-out-of-order","__idx":5},"children":["Events arriving out of order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whether this is expected depends on your topic's partition key — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tol/getting_started/event_streaming/implementing_kafka#partitioning"},"children":["Partitioning"]}," to confirm which one applies to your topic."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tenant keying"]},": all your events are on a single partition, so Kafka guarantees order across your entire stream. Out-of-order events are not expected from Kafka itself — check whether your consumer processes messages concurrently in a way that can reorder them."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User or entity keying"]},": only events sharing the same key are ordered relative to each other. Events under different keys can land on different partitions and interleave — this is expected, not a fault."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"consumer-not-receiving-events-or-load-is-uneven-across-instances","__idx":6},"children":["Consumer not receiving events, or load is uneven across instances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Kafka assigns each partition to exactly one consumer instance within a group. If you run more instances than your topic has partitions, the extra instances will not receive any events — this is expected, not a fault. If one instance lags while others sit idle, check whether a single partition (and the key driving it) is carrying disproportionate traffic."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"consumer-stuck-on-one-event","__idx":7},"children":["Consumer stuck on one event"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the offset on one partition stops moving while your consumer lag grows, your application is likely retrying the same event. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tol/getting_started/event_streaming/implementing_kafka#handling-failed-events"},"children":["Handling failed events"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getting-help","__idx":8},"children":["Getting help"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For access requests, credential issues, or integration questions, contact your Upvest representative or your agreed support channel."]}]},"headings":[{"value":"Kafka event streaming troubleshooting","id":"kafka-event-streaming-troubleshooting","depth":1},{"value":"Authentication failed","id":"authentication-failed","depth":3},{"value":"Connection refused or timeout","id":"connection-refused-or-timeout","depth":3},{"value":"Topic not found","id":"topic-not-found","depth":3},{"value":"TLS errors","id":"tls-errors","depth":3},{"value":"Events arriving out of order","id":"events-arriving-out-of-order","depth":3},{"value":"Consumer not receiving events, or load is uneven across instances","id":"consumer-not-receiving-events-or-load-is-uneven-across-instances","depth":3},{"value":"Consumer stuck on one event","id":"consumer-stuck-on-one-event","depth":3},{"value":"Getting help","id":"getting-help","depth":3}],"frontmatter":{"seo":{"title":"Kafka event streaming troubleshooting"}},"lastModified":"2026-10-27T13:06:14.336Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/tol/getting_started/event_streaming/kafka_troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}