May Updates v1.5.0: Geolocation, Website Revamp & New Observations

Welcome to v1.5.0 of rtcStats! This release zooms out from raw stats and onto the map: you can now see where TURN, STUN, and candidate pairs actually live, browse a freshly revamped website, and lean on a new batch of observations to catch issues that used to stay hidden.

A bit of cartography, a bit of spring cleaning, and a few sharper signals - let's dive in! 🗺️

🚀 Major Improvements

Geolocation in Connectivity Diagrams 🌍 (rtcstats-server)

Connectivity issues are often a story of distance. In this release, we now surface the geolocation of TURN/STUN servers and any IP from the candidate pairs, directly inside the connection diagrams.

One glance is enough to spot a TURN server on the wrong continent, a relay path that takes a detour, or a remote peer much further away than expected. Best part: this works for every account type.

On the integration side, geolocation requires rtcstats-server wired up to a MaxMind database. The server enriches each rtcstats file with IP-to-location data at ingestion time, and rtcStats then picks it up to draw the diagrams and decorate the logs.

Read more about geolocation enrichment in rtcstats-server.

Geolocation in Connectivity Diagrams

A Refreshed rtcStats Website ✨

The public side of rtcStats got a serious makeover. We've rewritten large chunks of the marketing copy, redesigned the layout for a cleaner reading experience, and reorganized the top navigation to make it easier to find what you're looking for.

Two new entry points stand out:

• Open Source page: a dedicated home for the open-source bits of the rtcStats ecosystem - what we've put out there, why, and how to contribute
• Resources entry in the top navigation: a single jump-off point that gathers the blog, the Knowledge Base, the Showcase, and the API documentation - so you don't have to hunt through menus anymore

Refreshed rtcStats Website

New Observations: AEC, AGC & getUserMedia (Developer Plan) 🔍

The Observations engine keeps growing. This release brings a fresh batch of signals to catch issues that were previously hidden in raw logs:

• AEC disabled: flags peer connections where the Acoustic Echo Canceller is off - a frequent culprit for echo and poor audio quality
• AGC disabled: flags peer connections where the Automatic Gain Control is off - the microphone signal is no longer auto-leveled, which can lead to too-quiet or clipped audio.
• Broader getUserMedia errors: a wider range of failed device permission and capture errors are now reported as observations, with the original browser error surfaced in the logs

New Observations: AEC, AGC & getUserMedia

🛠️ Other Enhancements

Logs and Devices Improvements 🎙️

The logs panel got several quality-of-life improvements that make it easier to follow what's actually happening during a session:

• New transceiver layout: transceiver-related entries are now grouped and rendered with a cleaner layout, so you can scan direction changes and codec negotiations at a glance.
• Device change events: the browser's devicechange event is now captured in logs, perfect to spot a hot-unplugged microphone or a freshly added camera mid-call.
• Inline geolocation for candidates:beyond the diagram view, geolocation is now shown directly on candidate log lines - so you don't have to switch panels to know where a given candidate resolves to.

More Knowledge Base Articles & Mermaid Diagrams 📚

The Knowledge Base keeps growing. This release adds a brand new reference statistics article that lays out the WebRTC stats surface in one place - a handy companion when you're trying to figure out which metric tells which story.

On top of that, KB markdown now renders Mermaid diagrams natively. Flows, timelines, and state machines no longer have to hide in screenshots - they're drawn live, stay readable, and can be updated alongside the prose.

🐞 Bug Fixes

• Security updates:  We've added a new set of HTTP security headers including a strict Content Security Policy and X-Frame-Options: DENY to prevent header injection, hijacking, and clickjacking attempts.

We're excited to see how you use the new geolocation insights and the refreshed website to share your WebRTC findings! As always, the latest version of rtcstats-js is available - make sure you're up to date to get the best out of these new features.

Happy debugging! 💎