HAPPY J. Palet Martinez Internet-Draft The IPv6 Company Intended status: Informational P. S. Tiesel Expires: 19 May 2027 SAP SE 15 November 2026 Considerations for Happy Eyeballs Error Reporting draft-palet-happy-reporting-considerations-02 Abstract This document introduces different aspects to be considered for the Happy Eyeballs error reporting. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on 19 May 2027. Copyright Notice Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 1] Internet-Draft HE Failures Reporting November 2026 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Use cases . . . . . . . . . . . . . . . . . . . . . . . . . . 2 3. What to report? . . . . . . . . . . . . . . . . . . . . . . . 4 4. When to report? . . . . . . . . . . . . . . . . . . . . . . . 5 5. How to report? . . . . . . . . . . . . . . . . . . . . . . . 5 6. Privacy Considerations . . . . . . . . . . . . . . . . . . . 6 7. Security Considerations . . . . . . . . . . . . . . . . . . . 8 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 8 9. References . . . . . . . . . . . . . . . . . . . . . . . . . 8 9.1. Normative References . . . . . . . . . . . . . . . . . . 8 9.2. Informative References . . . . . . . . . . . . . . . . . 8 Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 9 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 9 1. Introduction Happy Eyeballs ([I-D.ietf-happy-happyeyeballs-v3]) provides a way for improving user-visible delay when FQDN's have multiple IP addresses and connectivity is performing worse in those that should be the preferred ones. However, this hides possible connectivity issues to the operator or other parties in the chain between the client and the service being accessed, because users will not notice anything broken, so they will not report it to the providers. For example, in the case of a dual- stack web site, if IPv6 connectivity is somehow broken at any point between the client and the hosting service, Happy Eyeballs (HE across the rest of this document), will quickly fall-back to IPv4. The goal of this document is to discuss different aspects to be considered, in order to provide a decision path towards the best possible choice for the final error reporting solution for HE. The error reporting solution should allow an integral HE error reporting mechanism that enables setting up alarms and triggering further investigations so to improve network reliability, facilitating the detection of failures as soon as they appear, without the need of additional external monitoring. 2. Use cases For HE reporting, we consider five different personas and identified the following use cases covering parts of the network that can cause HE fallback (IPv6 to IPv4 or QUIC to TCP): Application developers and users (DU): Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 2] Internet-Draft HE Failures Reporting November 2026 To validate their own applications and infrastructure as well as providing support, application developers may want to be able to trace why certain communication prefer IPv4 instead of IPv6. In this case, it is especially important to understand whether the client has received an AAAA RR, whether connecting IPv6 was actually tried (and potentially why not) and how the attempt failed, e.g., lost race, TCP/TLS/QUIC handshake failed, ... Especially for web applications, exposing this information through developer tools or performance logs is crucial. Technical capable users and support personnel can use the same mechanisms. Corporate and other managed network operators (CO): Corporate middle-boxes like firewalls and other endpoint security solutions often infer with IPv6 and QUIC. Therefore, application feedback is essential to diagnose issues with these solutions and their configuration. Service provider operators (SP): The service provider is usually the primary party for receiving and acting on reports. Within its administrative realm, HE fallback can be caused by issues on the (provider managed) CE, routers and middle-box misconfiguration inside the provider network, or issues at direct peerings/transits. In cellular dual-stack deployments, the problem is typically in the provider network rather than in the UE or customer LAN. Even when the customer manages parts of the CE or internal network, fallback reports remain useful to the provider because they can indicate customer-impacting misconfiguration Intermediate transit operators (TO): While not the most likely source of HE fallbacks, also misconfigurations in these networks may lead to IPv6 or protocol degradation. While fine-grained analysis of reporting is likely infeasible, sampling may be used as an indicator for larger issues. Content providers (CP): This has been the most common source of the problem for some time, for instance, content providers having configured AAAA RR's when IPv6 connectivity was not good or even inexistent, wrong configuration in load-balancers or firewalls, etc. Internet Community (IC): The broader Internet community, including researchers and standardization bodies, can use highly aggregated and anonymized HE fallback statistics to understand trends, identify common issues, and improve protocols and deployment practices. Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 3] Internet-Draft HE Failures Reporting November 2026 Note that the areas of control differ for each persona. For example, if the error reporting is sent to the content provider, they will only be able to fix it if it is a general problem, affecting any possible source address in the Internet. However, they are usually unable to understand an fix problems along the path and need support from other personas fix problems in their administrative domain. In many cases, the Service Provider should be able to forward the case to the next(s) level(s) when the problem is not in their own network. For instance, it is very common that a SP discover issues generated in the Intermediate Transit, and this one should be able to quickly fix it. 3. What to report? As the privacy impact heavily depend on the persona, the reporting solutions should also differ in the information exposed. The following information may be included into a report if relevant and permissible by privacy considerations: * FQDN accessed. Recommend to include for DU, CO, and CP personas. * Source address failed (possibly just a prefix aggregate or AS number to maintain privacy). Recommend to include for all personas except IC, for which it may be collected in an aggregated form. * Destination address failed (possibly just a prefix aggregate or domain to maintain privacy). Recommend to include for all personas except IC, for which it may be collected in an aggregated form. * If the problem was on IP (fallback IPv6/IPv4) or Transport level (fallback QUIC/TLS/TCP). Recommend to include for all personas. * Information about what which source address, destination address, and transport finally succeeded. Recommend to include for DU, CO, and CP personas. * Timers or events that caused the fallback (Resolution Delay, Connection Attempt Delay, ICMP error, ...). Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 4] Internet-Draft HE Failures Reporting November 2026 Recommend to include for DU, and CO personas. Possibly for CP persona in a less detailed form. Note that vendors may collect different sets of information on an opt-in/out basis, for example for different research purposes. 4. When to report? The case for reporting failures varies depending on the persona involved. Application developers and users (DU): Report every failure as long as reporting is enabled. Corporate and other managed network operators (CO): Configure reporting granularity through the network administrator and integrate it into client management policies. Service provider operators (SP): Use aggregated or sampled reporting to avoid excessive load on the reporting infrastructure. Intermediate transit operators (TO): Use aggregated or sampled reporting to avoid excessive load on the reporting infrastructure. Content providers (CP): Report in an aggregated form or on demand, e.g., using a mechanism like W3C Network Error Logging ([NEL]) or a JavaScript reporting API. Internet Community (IC): Report in an aggregated form after opt-in from the user. 5. How to report? The reporting mechanisms will depend on the persona, and the use case, but in general, we can consider the following options: Developer Tools Plug-in: Developer tools, like browser developer tools or profiling tools, can be extended to visualize HE decisions. As these tools are typically very domain specific, the extensions can take the way the environments implements Happy Eyeballs into account. Debug and Performance Logs: Existing debugging and performance Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 5] Internet-Draft HE Failures Reporting November 2026 tracing logs can be leveraged to report HE decisions. This allows developers to understand the behavior of HE without introducing new reporting mechanisms, and can be integrated with existing tracing and logging infrastructure. The logging format should be consistent with existing practices in the environment or use [I-D.kuehlewind-happy-qlog]. System Logging: For corporate and managed network operators, using existing mechanism that integrate into the client management like syslog, systemd-journal, or windows events is crucial to be able to integrate the reporting into the existing monitoring and alerting systems. W3C Network Error Logging (NEL): An extension W3C Network Error Logging [NEL]) could be used to report HE decisions from content providers, allowing them to communicate errors to a centralized collector on content provider side. JavaScript Happy Eyeballs Object: A JavaScript object could be used to report HE decisions from web applications, allowing developers to capture and send HE-related events to a centralized collector. ICMP-based Reporting: To send signals about HE failures to the network, a new ICMP error type as described in [I-D.trammell-happy-sad]) could be used. Browser Telemetry: Browser vendor telemetry can collect and analyze HE decisions and allow the verdors and Internet community to gain insights into HE behavior across different environments and networks. 6. Privacy Considerations TBD. Very draft text follows from previous work and list inputs. The goal is to provide the operator information about the failures detected by HE, without requiring specific users traffic information. Towards this, it will be sufficient to provide to the error collector details about the failed destination address and source prefix. So privacy issues regarding identification of a specific device or users are avoided. Nowadays, operators already log this information in order to comply with lawful interception regulations, and in general, data protection regulations allow this logging when technically required. Data protection regulations explicitly say that the data can't be disclosed, and there is no need to do so. Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 6] Internet-Draft HE Failures Reporting November 2026 In general, vendors also collect telemetry data from devices, in order to improve OSs and in some situations, there are regulations that enforce offering the user to enable/disable that feature. So we could consider offering the same feature for this mechanism. When the mechanism described in this document detects a failure, the operator will need to find if the problem is related to: * A specific subscriber (customer internal networks, or even at their CE). * A group of subscribers or the entire service provider network (e.g., one or several part service provider network). * Intermediate transits. * Content provider. Those cases, in terms of privacy considerations, will fall into one of the following categories: a. Failure cause in customer internal network: The operator may decide, depending on their country regulations and services offered to that customer, to inform the customer (and decide what information is provided), or ignore the failure and include it in a "while list" (i.e., list of "don't care" failures), so the monitoring system doesn't keep providing alerts on it. b. Failure cause due to the service provider network: The operator will need to find the cause and fix the failure, without disclosing any personal data. c. Failure cause due to third parties (intermediate transits or content provider): The operator don't need to disclose any specific user source address/prefix, because in this case, the shorter prefix (typically the RIR allocated prefix or part of it, when is being announced split among different BGP peers), from which the failure has been verified is sufficient to re-verify the error. In the most extreme case, a more restrictive usage of this procedure, not involving logging any user source address/prefix, will be to log only the failed destination address. In a big percentage of the cases, it will be enough for the service provider to detect the failure (use cases 2, 3, and 4), as experience shows that HE fallback occurs mainly because path or destination misconfiguration or issues. So, the service provider could replicate the failure from any other source address in its network to the same failed destination. If we Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 7] Internet-Draft HE Failures Reporting November 2026 take this approach, failures internal to a specific subscriber, could not be reported by the operator to the customer (as there is no source data logging), and together with partial failures of the operator network will require extra work from operator's staff to research the cause of the failure (i.e., it is in my network, part of it, a specific customer or external). So, there is any distinction between the privacy issues from this protocol compared to regular network operation and management, abuse reporting, etc. ? TBD: In the case of content providers reporting, something like Network Error Logging and/or Navigation Timing could help for content providers in a way where more detailed information can be sent to an endpoint within a TLS connection in a way that isn't exposing anything to the network.? 7. Security Considerations This document does not have any specific security considerations. 8. IANA Considerations This document does not have any IANA considerations. 9. References 9.1. Normative References [I-D.ietf-happy-happyeyeballs-v3] Pauly, T., Schinazi, D., Jaju, N., and K. Ishibashi, "Happy Eyeballs Version 3: Better Connectivity Using Concurrency", Work in Progress, Internet-Draft, draft- ietf-happy-happyeyeballs-v3-05, 2 November 2026, . 9.2. Informative References [I-D.trammell-happy-sad] Trammell, B., "Slow Alternate Detection for Happy Eyeballs", Work in Progress, Internet-Draft, draft- trammell-happy-sad-01, 26 July 2026, . Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 8] Internet-Draft HE Failures Reporting November 2026 [I-D.kuehlewind-happy-qlog] Kühlewind, M., "Happy Eyeballs v3 (HEv3) Event Logging with qlog", Work in Progress, Internet-Draft, draft- kuehlewind-happy-qlog-00, 6 July 2026, . [NEL] "Network Error Logging", . Acknowledgements The author would like to acknowledge the inputs of Gert Doering, Erik Nygren ... Authors' Addresses Jordi Palet Martinez The IPv6 Company Molino de la Navata, 75 28420 La Navata - Galapagar Madrid Spain Email: jordi.palet@theipv6company.com URI: http://www.theipv6company.com/ Philipp S. Tiesel SAP SE Email: philipp@tiesel.net Palet Martinez & S. Tiesel Expires 19 May 2027 [Page 9]