Tag: QUIC Protocol

Geode documentation tagged with QUIC Protocol. QUIC (Quick UDP Internet Connections) is a modern transport protocol that provides the reliability of TCP with the performance of UDP, featuring built-in encryption, multiplexing, and connection migration. <h3 id="introduction-to-quic" class="position-relative d-flex align-items-center group"> Introduction to QUIC <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="introduction-to-quic" aria-haspopup="dialog" aria-label="Share link: Introduction to QUIC"> Share link </button> </h3><div id="headingShareModal" class="heading-share-modal" role="dialog" aria-modal="true" aria-labelledby="headingShareTitle" hidden> <div class="hsm-dialog" role="document"> <div class="hsm-header"> <h2 id="headingShareTitle" class="h6 mb-0 fw-bold">Share this section</h2> <button type="button" class="hsm-close" aria-label="Close"> </button> </div> <div class="hsm-body"> <label for="headingShareInput" class="form-label small text-muted mb-1 text-uppercase fw-bold" style="font-size: 0.7rem; letter-spacing: 0.5px;">Permalink</label> <div class="input-group mb-4 hsm-url-group"> <input id="headingShareInput" type="text" class="form-control font-monospace" readonly aria-readonly="true" style="font-size: 0.85rem;" /> <button class="btn btn-primary hsm-copy" type="button" aria-label="Copy" title="Copy"> </button> </div> <div class="small fw-bold mb-2 text-muted text-uppercase" style="font-size: 0.7rem; letter-spacing: 0.5px;">Share via</div> <div class="hsm-share-grid"> <a id="share-twitter" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Twitter </a> <a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> LinkedIn </a> <a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Facebook </a> </div> </div> </div> </div> <style> .heading-share-modal { position: fixed; inset: 0; display: flex; justify-content: center; align-items: center; background: rgba(0, 0, 0, 0.6); z-index: 1050; padding: 1rem; backdrop-filter: blur(4px); -webkit-backdrop-filter: blur(4px); } .heading-share-modal[hidden] { display: none !important; } .hsm-dialog { max-width: 420px; width: 100%; background: var(--bs-body-bg, #fff); color: var(--bs-body-color, #212529); border: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); border-radius: 1rem; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25); overflow: hidden; animation: hsm-fade-in 0.2s ease-out; } @keyframes hsm-fade-in { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } } [data-bs-theme="dark"] .hsm-dialog { background: #1e293b; border-color: rgba(255,255,255,0.1); color: #f8f9fa; } .hsm-header { display: flex; justify-content: space-between; align-items: center; padding: 1rem 1.5rem; border-bottom: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); background: rgba(0,0,0,0.02); } [data-bs-theme="dark"] .hsm-header { background: rgba(255,255,255,0.02); border-color: rgba(255,255,255,0.1); } .hsm-close { background: transparent; border: none; color: inherit; opacity: 0.5; padding: 0.25rem 0.5rem; border-radius: 0.25rem; font-size: 1.2rem; line-height: 1; transition: opacity 0.2s; } .hsm-close:hover { opacity: 1; } .hsm-body { padding: 1.5rem; } .hsm-url-group { display: flex !important; align-items: stretch; } .hsm-url-group .form-control { flex: 1; min-width: 0; margin: 0; background: var(--bs-secondary-bg, #f8f9fa); border-color: var(--bs-border-color, #dee2e6); border-top-right-radius: 0; border-bottom-right-radius: 0; height: 42px; } .hsm-url-group .btn { flex: 0 0 auto; margin: 0; margin-left: -1px; border-top-left-radius: 0; border-bottom-left-radius: 0; height: 42px; display: flex; align-items: center; justify-content: center; padding: 0 1.25rem; z-index: 2; } [data-bs-theme="dark"] .hsm-url-group .form-control { background: #0f172a; border-color: #334155; color: #e2e8f0; } .hsm-share-grid { display: flex; flex-direction: column; gap: 0.5rem; } .hsm-share-grid .btn { display: flex; align-items: center; justify-content: center; font-size: 0.9rem; padding: 0.6rem; border-color: var(--bs-border-color); width: 100%; } [data-bs-theme="dark"] .hsm-share-grid .btn { color: #e2e8f0; border-color: #475569; } [data-bs-theme="dark"] .hsm-share-grid .btn:hover { background: #334155; border-color: #cbd5e1; } </style> <script> (function(){ const modal = document.getElementById('headingShareModal'); if(!modal) return; const input = modal.querySelector('#headingShareInput'); const copyBtn = modal.querySelector('.hsm-copy'); const twitter = modal.querySelector('#share-twitter'); const linkedin = modal.querySelector('#share-linkedin'); const facebook = modal.querySelector('#share-facebook'); const closeBtn = modal.querySelector('.hsm-close'); let lastFocus=null; let trapBound=false; function buildUrl(id){ return window.location.origin + window.location.pathname + '#' + id; } function isOpen(){ return !modal.hasAttribute('hidden'); } function hydrate(id){ const url=buildUrl(id); input.value=url; const enc=encodeURIComponent(url); const text=encodeURIComponent(document.title); if(twitter) twitter.href=`https://twitter.com/intent/tweet?url=${enc}&text=${text}`; if(linkedin) linkedin.href=`https://www.linkedin.com/sharing/share-offsite/?url=${enc}`; if(facebook) facebook.href=`https://www.facebook.com/sharer/sharer.php?u=${enc}`; } function openModal(id){ lastFocus=document.activeElement; hydrate(id); if(!isOpen()){ modal.removeAttribute('hidden'); } requestAnimationFrame(()=>{ input.focus(); }); trapFocus(); } function closeModal(){ if(!isOpen()) return; modal.setAttribute('hidden',''); if(lastFocus && typeof lastFocus.focus==='function') lastFocus.focus(); } function copyCurrent(){ try{ navigator.clipboard.writeText(input.value).then(()=>feedback(true),()=>fallback()); } catch(e){ fallback(); } } function fallback(){ input.select(); try{ document.execCommand('copy'); feedback(true);}catch(e){ feedback(false);} } function feedback(ok){ if(!copyBtn) return; const icon=copyBtn.querySelector('i'); if(!icon) return; const prev=copyBtn.getAttribute('data-prev')||icon.className; if(!copyBtn.getAttribute('data-prev')) copyBtn.setAttribute('data-prev',prev); icon.className= ok ? 'fa-duotone fa-clipboard-check':'fa-duotone fa-circle-exclamation'; setTimeout(()=>{ icon.className=prev; },1800); } function handleShareClick(e){ e.preventDefault(); const btn=e.currentTarget; const id=btn.getAttribute('data-share-target'); if(id) openModal(id); } function bindShareButtons(){ document.querySelectorAll('.h-share').forEach(btn=>{ if(!btn.dataset.hShareBound){ btn.addEventListener('click', handleShareClick); btn.dataset.hShareBound='1'; } }); } bindShareButtons(); if(document.readyState==='loading'){ document.addEventListener('DOMContentLoaded', bindShareButtons); } else { requestAnimationFrame(bindShareButtons); } document.addEventListener('click', function(e){ const shareBtn=e.target.closest && e.target.closest('.h-share'); if(shareBtn && !shareBtn.dataset.hShareBound){ handleShareClick.call(shareBtn, e); } }, true); document.addEventListener('click', e=>{ if(e.target===modal) closeModal(); if(e.target.closest && e.target.closest('.hsm-close')){ e.preventDefault(); closeModal(); } if(copyBtn && (e.target===copyBtn || (e.target.closest && e.target.closest('.hsm-copy')))) { e.preventDefault(); copyCurrent(); } }); document.addEventListener('keydown', e=>{ if(e.key==='Escape' && isOpen()) closeModal(); }); function trapFocus(){ if(trapBound) return; trapBound=true; modal.addEventListener('keydown', f=>{ if(f.key==='Tab' && isOpen()){ const focusable=[...modal.querySelectorAll('a[href],button,input,textarea,select,[tabindex]:not([tabindex="-1"])')].filter(el=>!el.hasAttribute('disabled')); if(!focusable.length) return; const first=focusable[0]; const last=focusable[focusable.length-1]; if(f.shiftKey && document.activeElement===first){ f.preventDefault(); last.focus(); } else if(!f.shiftKey && document.activeElement===last){ f.preventDefault(); first.focus(); } } }); } if(closeBtn) closeBtn.addEventListener('click', e=>{ e.preventDefault(); closeModal(); }); })(); </script>QUIC is a transport layer protocol initially developed by Google and subsequently standardized by the IETF in RFC 9000 (2021). Unlike TCP, which operates over raw IP and requires a separate TLS handshake for encryption, QUIC runs over UDP and integrates encryption directly into the protocol using TLS 1.3. This design eliminates head-of-line blocking, reduces connection establishment latency, and provides robust connection migration for mobile and multi-homed devices. For database connections, QUIC offers significant advantages over traditional TCP/TLS stacks. The protocol’s stream multiplexing allows multiple concurrent queries over a single connection without one slow query blocking others. Connection migration means mobile applications maintain database connections when switching between WiFi and cellular networks. The 0-RTT resumption feature enables reconnecting clients to send application data immediately without waiting for handshake completion, critical for latency-sensitive applications. Geode exclusively uses QUIC for client-server communication, running on the standard port 3141. There is no TCP fallback—all connections require QUIC support. This bold design choice reflects confidence in QUIC’s maturity and recognition that modern networks and client libraries have excellent QUIC support. By eliminating TCP compatibility layers, Geode achieves a simpler, more efficient wire protocol with guaranteed encryption and superior performance characteristics. <h3 id="key-concepts" class="position-relative d-flex align-items-center group"> Key Concepts <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="key-concepts" aria-haspopup="dialog" aria-label="Share link: Key Concepts"> Share link </button> </h3> <h4 id="udp-based-transport" class="position-relative d-flex align-items-center group"> UDP-Based Transport <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="udp-based-transport" aria-haspopup="dialog" aria-label="Share link: UDP-Based Transport"> Share link </button> </h4>QUIC runs over UDP rather than TCP: <ul> <li>User Datagram Protocol: Connectionless, unreliable packet delivery</li> <li>QUIC Reliability Layer: Implements reliable, ordered delivery on top of UDP</li> <li>Congestion Control: Advanced congestion algorithms (Cubic, BBR)</li> <li>Packet Loss Recovery: Fast retransmission and forward error correction</li> </ul> <h4 id="stream-multiplexing" class="position-relative d-flex align-items-center group"> Stream Multiplexing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="stream-multiplexing" aria-haspopup="dialog" aria-label="Share link: Stream Multiplexing"> Share link </button> </h4>QUIC supports multiple independent streams per connection: <ul> <li>Bidirectional Streams: Both endpoints can send and receive</li> <li>Unidirectional Streams: Data flows in only one direction</li> <li>Stream IDs: Unique identifier for each stream</li> <li>No Head-of-Line Blocking: Packet loss on one stream doesn’t affect others</li> </ul> <h4 id="integrated-encryption" class="position-relative d-flex align-items-center group"> Integrated Encryption <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="integrated-encryption" aria-haspopup="dialog" aria-label="Share link: Integrated Encryption"> Share link </button> </h4>TLS 1.3 is built into QUIC from the ground up: <ul> <li>Mandatory Encryption: All QUIC packets are encrypted</li> <li>TLS 1.3 Handshake: Modern, efficient cryptographic handshake</li> <li>0-RTT Resumption: Resume previous connection without handshake latency</li> <li>Forward Secrecy: Perfect forward secrecy for all connections</li> </ul> <h4 id="connection-migration" class="position-relative d-flex align-items-center group"> Connection Migration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="connection-migration" aria-haspopup="dialog" aria-label="Share link: Connection Migration"> Share link </button> </h4>QUIC connections can migrate across network paths: <ul> <li>Connection IDs: Persistent identifier independent of IP address/port</li> <li>Path Validation: Verify new paths before migration</li> <li>Mobile Scenarios: Seamless WiFi to cellular transitions</li> <li>Multi-homed Hosts: Failover between network interfaces</li> </ul> <h4 id="1-rtt-connection-establishment" class="position-relative d-flex align-items-center group"> 1-RTT Connection Establishment <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="1-rtt-connection-establishment" aria-haspopup="dialog" aria-label="Share link: 1-RTT Connection Establishment"> Share link </button> </h4>QUIC combines transport and encryption handshakes: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Client Server | | | Initial (ClientHello) | |------------------------------------>| | | | <- Initial (ServerHello, Certificate, Finished) | <- Handshake (CRYPTO) | |<------------------------------------| | | | Handshake (Finished) | | 1-RTT (Application Data) | |------------------------------------>| </code></pre></div>Compared to TCP + TLS (2-RTT minimum), QUIC achieves 1-RTT connection establishment, and 0-RTT for resumed connections. <h3 id="how-quic-works-in-geode" class="position-relative d-flex align-items-center group"> How QUIC Works in Geode <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="how-quic-works-in-geode" aria-haspopup="dialog" aria-label="Share link: How QUIC Works in Geode"> Share link </button> </h3> <h4 id="wire-protocol-architecture" class="position-relative d-flex align-items-center group"> Wire Protocol Architecture <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="wire-protocol-architecture" aria-haspopup="dialog" aria-label="Share link: Wire Protocol Architecture"> Share link </button> </h4>Geode’s wire protocol leverages QUIC streams: <ol> <li>Connection Establishment: Client initiates QUIC connection to port 3141</li> <li>Stream Allocation: Each query executes on a dedicated bidirectional stream</li> <li>Request/Response: Protobuf wire protocol messages flow over streams</li> <li>Concurrent Queries: Multiple queries execute in parallel using different streams</li> <li>Connection Pooling: Clients maintain persistent QUIC connections</li> </ol> <h4 id="protobuf-messages-over-quic" class="position-relative d-flex align-items-center group"> Protobuf Messages Over QUIC <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="protobuf-messages-over-quic" aria-haspopup="dialog" aria-label="Share link: Protobuf Messages Over QUIC"> Share link </button> </h4>Each QUIC stream carries a request-response conversation using Protobuf messages: <ul> <li><code>ExecuteRequest</code> → <code>ExecutionResponse</code> (schema + first page)</li> <li><code>PullRequest</code> → <code>ExecutionResponse</code> (subsequent pages)</li> </ul> <h4 id="stream-management" class="position-relative d-flex align-items-center group"> Stream Management <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="stream-management" aria-haspopup="dialog" aria-label="Share link: Stream Management"> Share link </button> </h4>Geode uses QUIC streams efficiently: <ul> <li>Query Streams: One bidirectional stream per query</li> <li>Control Stream: Stream 0 reserved for connection control messages</li> <li>CDC Streams: Unidirectional server-to-client streams for change events</li> <li>Multiplexing: Up to 100 concurrent streams per connection by default</li> </ul> <h4 id="connection-migration-support" class="position-relative d-flex align-items-center group"> Connection Migration Support <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="connection-migration-support" aria-haspopup="dialog" aria-label="Share link: Connection Migration Support"> Share link </button> </h4>Geode fully supports QUIC connection migration: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">import geode_client # Client maintains connection during network changes client = geode_client.open_database('quic://db.example.com:3141') async with client.connection() as conn: # Execute query on WiFi result, _ = await conn.query("MATCH (n:Person) RETURN count(n)") # User moves from WiFi to cellular - connection migrates automatically # Network stack detects new path, validates it, and migrates connection # Subsequent query uses migrated connection without interruption result, _ = await conn.query("MATCH (n:Product) RETURN count(n)") </code></pre></div> <h4 id="0-rtt-resumption" class="position-relative d-flex align-items-center group"> 0-RTT Resumption <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="0-rtt-resumption" aria-haspopup="dialog" aria-label="Share link: 0-RTT Resumption"> Share link </button> </h4>Geode supports 0-RTT for repeat connections: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># First connection: 1-RTT handshake client = geode_client.open_database('quic://db.example.com:3141') async with client.connection() as conn: result, _ = await conn.query("MATCH (n) RETURN count(n)") # Server sends session ticket for resumption # Second connection within ticket lifetime: 0-RTT client = geode_client.open_database('quic://db.example.com:3141') async with client.connection() as conn: # Query sent in first packet, no handshake wait result, _ = await conn.query("MATCH (n) RETURN count(n)") </code></pre></div> <h3 id="use-cases" class="position-relative d-flex align-items-center group"> Use Cases <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="use-cases" aria-haspopup="dialog" aria-label="Share link: Use Cases"> Share link </button> </h3> <h4 id="low-latency-query-execution" class="position-relative d-flex align-items-center group"> Low-Latency Query Execution <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="low-latency-query-execution" aria-haspopup="dialog" aria-label="Share link: Low-Latency Query Execution"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">import geode_client import asyncio async def measure_query_latency(): """Measure end-to-end query latency with QUIC.""" client = geode_client.open_database('quic://localhost:3141') async with client.connection() as conn: for i in range(100): start = asyncio.get_event_loop().time() result, _ = await conn.query( "MATCH (n:Person {id: $id}) RETURN n.name", {"id": i} ) row = result.rows[0] if result.rows else None latency = (asyncio.get_event_loop().time() - start) * 1000 print(f"Query {i}: {latency:.2f}ms") # Typical latencies with QUIC: # Local: 0.5-2ms # Same datacenter: 2-5ms # Cross-region: 50-150ms </code></pre></div> <h4 id="concurrent-query-execution" class="position-relative d-flex align-items-center group"> Concurrent Query Execution <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="concurrent-query-execution" aria-haspopup="dialog" aria-label="Share link: Concurrent Query Execution"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">async def concurrent_queries(): """Execute multiple queries in parallel over QUIC streams.""" client = geode_client.open_database('quic://localhost:3141') async with client.connection() as conn: # All queries use the same QUIC connection but different streams results = await asyncio.gather( conn.execute("MATCH (p:Person) RETURN count(p)"), conn.execute("MATCH (c:Company) RETURN count(c)"), conn.execute("MATCH (p:Product) RETURN count(p)"), conn.execute("MATCH ()-[r]->() RETURN count(r)") ) for i, result in enumerate(results): row = result.rows[0] if result.rows else None print(f"Query {i}: {row[0]} entities") # QUIC multiplexing allows all queries to execute concurrently # without head-of-line blocking </code></pre></div> <h4 id="mobile-application-resilience" class="position-relative d-flex align-items-center group"> Mobile Application Resilience <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="mobile-application-resilience" aria-haspopup="dialog" aria-label="Share link: Mobile Application Resilience"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">import asyncio from geode_client import GeodeConnectionError, open_database class MobileClient: """Database client that retries on transient network loss.""" def __init__(self, url: str): self.client = open_database(url) async def query(self, gql: str): """Execute query with a simple reconnect loop.""" while True: try: async with self.client.connection() as conn: result, _ = await conn.query(gql) return result.rows except GeodeConnectionError: await asyncio.sleep(0.5) # Usage in mobile app client = MobileClient('quic://db.example.com:3141') # Works seamlessly across WiFi/cellular transitions results = await client.query("MATCH (n:Person) RETURN n.name LIMIT 10") </code></pre></div> <h4 id="wan-optimization" class="position-relative d-flex align-items-center group"> WAN Optimization <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="wan-optimization" aria-haspopup="dialog" aria-label="Share link: WAN Optimization"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from geode_client import ConnectionPool async def wan_optimized_queries(): """Optimize queries over high-latency WAN links.""" pool = ConnectionPool(host="remote-db.example.com", port=3141, max_size=20) async with pool: async def run_query(i: int): async with pool.acquire() as conn: result, _ = await conn.query( "MATCH (n:Person {id: $id}) RETURN n", {"id": i}, ) return result.rows results = await asyncio.gather(*(run_query(i) for i in range(50))) </code></pre></div> <h3 id="best-practices" class="position-relative d-flex align-items-center group"> Best Practices <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="best-practices" aria-haspopup="dialog" aria-label="Share link: Best Practices"> Share link </button> </h3> <h4 id="connection-management" class="position-relative d-flex align-items-center group"> Connection Management <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="connection-management" aria-haspopup="dialog" aria-label="Share link: Connection Management"> Share link </button> </h4><ol> <li>Connection Pooling: Reuse QUIC connections for multiple queries</li> <li>Connection Limits: Configure appropriate max streams per connection</li> <li>Idle Timeout: Set reasonable idle timeout for connection reuse</li> <li>Graceful Shutdown: Close streams and connections cleanly</li> </ol> <h4 id="performance-tuning" class="position-relative d-flex align-items-center group"> Performance Tuning <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="performance-tuning" aria-haspopup="dialog" aria-label="Share link: Performance Tuning"> Share link </button> </h4><ol> <li>Stream Concurrency: Adjust max concurrent streams for workload</li> <li>Congestion Control: Choose appropriate algorithm (Cubic vs BBR)</li> <li>0-RTT Enablement: Enable for repeat connections to reduce latency</li> <li>Buffer Sizes: Tune send/receive buffers for throughput</li> </ol> <h4 id="security-configuration" class="position-relative d-flex align-items-center group"> Security Configuration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="security-configuration" aria-haspopup="dialog" aria-label="Share link: Security Configuration"> Share link </button> </h4><ol> <li>Certificate Validation: Always validate server certificates</li> <li>TLS 1.3 Only: Ensure only TLS 1.3 is enabled</li> <li>Cipher Suites: Use strong, modern cipher suites</li> <li>Session Tickets: Manage session ticket security appropriately</li> </ol> <h4 id="network-considerations" class="position-relative d-flex align-items-center group"> Network Considerations <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="network-considerations" aria-haspopup="dialog" aria-label="Share link: Network Considerations"> Share link </button> </h4><ol> <li>Firewall Rules: Ensure UDP port 3141 is open</li> <li>NAT Traversal: QUIC handles NAT better than TCP</li> <li>Path MTU: QUIC performs automatic path MTU discovery</li> <li>QoS: Configure appropriate QoS for UDP traffic</li> </ol> <h3 id="performance-considerations" class="position-relative d-flex align-items-center group"> Performance Considerations <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="performance-considerations" aria-haspopup="dialog" aria-label="Share link: Performance Considerations"> Share link </button> </h3> <h4 id="latency-improvements" class="position-relative d-flex align-items-center group"> Latency Improvements <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="latency-improvements" aria-haspopup="dialog" aria-label="Share link: Latency Improvements"> Share link </button> </h4>QUIC reduces latency through: <ul> <li>1-RTT Handshake: 50% faster than TCP+TLS</li> <li>0-RTT Resumption: Eliminates handshake for repeat connections</li> <li>No Head-of-Line Blocking: Packet loss doesn’t block other streams</li> <li>Fast Retransmission: Rapid packet loss recovery</li> </ul> Typical improvements over TCP+TLS: <ul> <li>First connection: 20-30% faster</li> <li>Resumed connection: 50-70% faster</li> <li>Lossy networks: 2-5x faster query execution</li> </ul> <h4 id="throughput-characteristics" class="position-relative d-flex align-items-center group"> Throughput Characteristics <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="throughput-characteristics" aria-haspopup="dialog" aria-label="Share link: Throughput Characteristics"> Share link </button> </h4>QUIC throughput is excellent: <ul> <li>Single Stream: Comparable to TCP (within 5%)</li> <li>Multiple Streams: 50-200% better than TCP due to multiplexing</li> <li>Lossy Links: 100-300% better than TCP</li> <li>High-Latency Links: BBR congestion control excels</li> </ul> <h4 id="resource-usage" class="position-relative d-flex align-items-center group"> Resource Usage <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="resource-usage" aria-haspopup="dialog" aria-label="Share link: Resource Usage"> Share link </button> </h4>QUIC resource consumption is modest: <ul> <li>Memory: ~100KB per connection (vs ~50KB for TCP+TLS)</li> <li>CPU: ~10% higher than TCP+TLS for encryption/decryption</li> <li>Bandwidth: 1-2% overhead from QUIC headers</li> <li>Ports: Single UDP port vs separate TCP ports</li> </ul> <h3 id="troubleshooting" class="position-relative d-flex align-items-center group"> Troubleshooting <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="troubleshooting" aria-haspopup="dialog" aria-label="Share link: Troubleshooting"> Share link </button> </h3> <h4 id="connection-failures" class="position-relative d-flex align-items-center group"> Connection Failures <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="connection-failures" aria-haspopup="dialog" aria-label="Share link: Connection Failures"> Share link </button> </h4>Symptom: Unable to establish QUIC connection Solutions: <ul> <li>Verify UDP port 3141 is reachable</li> <li>Check firewall rules allow UDP traffic</li> <li>Ensure client supports QUIC (all official clients do)</li> <li>Verify server certificate is valid</li> <li>Check for NAT or middlebox interference</li> </ul> <h4 id="high-latency" class="position-relative d-flex align-items-center group"> High Latency <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="high-latency" aria-haspopup="dialog" aria-label="Share link: High Latency"> Share link </button> </h4>Symptom: Queries slower than expected Solutions: <ul> <li>Check network latency with ping/traceroute</li> <li>Verify no packet loss on link</li> <li>Tune congestion control algorithm</li> <li>Increase max concurrent streams</li> <li>Enable 0-RTT for repeat connections</li> </ul> <h4 id="stream-errors" class="position-relative d-flex align-items-center group"> Stream Errors <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="stream-errors" aria-haspopup="dialog" aria-label="Share link: Stream Errors"> Share link </button> </h4>Symptom: Stream reset or connection closed unexpectedly Solutions: <ul> <li>Check for max streams exceeded</li> <li>Verify proper stream lifecycle management</li> <li>Review server logs for errors</li> <li>Ensure queries complete before closing streams</li> <li>Monitor connection idle timeout</li> </ul> <h4 id="connection-migration-issues" class="position-relative d-flex align-items-center group"> Connection Migration Issues <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="connection-migration-issues" aria-haspopup="dialog" aria-label="Share link: Connection Migration Issues"> Share link </button> </h4>Symptom: Connection fails during network transition Solutions: <ul> <li>Verify connection migration is enabled</li> <li>Check path validation succeeds</li> <li>Review NAT rebinding behavior</li> <li>Ensure sufficient timeout for migration</li> <li>Monitor connection ID management</li> </ul> <h3 id="related-topics" class="position-relative d-flex align-items-center group"> Related Topics <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="related-topics" aria-haspopup="dialog" aria-label="Share link: Related Topics"> Share link </button> </h3><ul> <li><a href="/tags/protocol/" >Protocol</a> - Wire protocol specification</li> <li><a href="/tags/networking/" >Networking</a> - Network architecture and design</li> <li><a href="/tags/encryption/" >TLS/Encryption</a> - Transport security</li> <li><a href="/tags/performance/" >Performance</a> - Performance optimization</li> <li><a href="/tags/client-library/" >Client Libraries</a> - Client implementation details</li> <li><a href="/tags/connections/" >Connections</a> - Connection management</li> </ul> <h3 id="further-reading" class="position-relative d-flex align-items-center group"> Further Reading <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="further-reading" aria-haspopup="dialog" aria-label="Share link: Further Reading"> Share link </button> </h3><ul> <li><a href="https://datatracker.ietf.org/doc/html/rfc9000" aria-label="QUIC Specification (RFC 9000) – opens in new window" target="_blank" rel="noopener noreferrer" >QUIC Specification (RFC 9000) ↗ </a> - Official IETF specification</li> <li><a href="/docs/architecture/wire-protocol/" >Wire Protocol</a> - Protobuf wire protocol over QUIC</li> <li><a href="/docs/configuration/server-configuration/" >Server Configuration</a> - Server and connection configuration options</li> <li><a href="/docs/query/performance-tuning/" >Performance Tuning</a> - Optimizing connections and queries</li> <li><a href="/docs/protocol/" >Protocol Documentation</a> - Geode protocol design</li> </ul>

Popular

Related Articles

Go Client

Python Client

Rust Client

Zig Client

Node.js Client