npm - com.wallstop-studios.dxmessaging - Versions diffs - 2.1.7 → 2.1.9 - Mend

com.wallstop-studios.dxmessaging 2.1.7 → 2.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1408) hide show

package/site/guides/diagnostics/index.html DELETED Viewed

@@ -1,110 +0,0 @@
-<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="High-performance type-safe messaging library for Unity"><meta name=author content="Wallstop Studios"><link href=https://wallstop.github.io/DxMessaging/guides/diagnostics/ rel=canonical><link href=../testing/ rel=prev><link href=../advanced/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Diagnostics - DxMessaging Documentation</title><link rel=stylesheet href=../../assets/stylesheets/main.484c7ddc.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ab4e12ef.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../css/timeago.css><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#diagnostics class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class="md-header md-header--shadow md-header--lifted" data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="DxMessaging Documentation" class="md-header__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> DxMessaging Documentation </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Diagnostics </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to dark mode" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme=slate data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <a href=javascript:void(0) class="md-search__icon md-icon" title=Share aria-label=Share data-clipboard data-clipboard-text data-md-component=search-share tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg> </a> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> <div class=md-search__suggest data-md-component=search-suggest></div> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> </nav> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Home </a> </li> <li class=md-tabs__item> <a href=../../getting-started/ class=md-tabs__link> Getting Started </a> </li> <li class=md-tabs__item> <a href=../../concepts/ class=md-tabs__link> Concepts </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../patterns/ class=md-tabs__link> Guides </a> </li> <li class=md-tabs__item> <a href=../../architecture/design-and-architecture/ class=md-tabs__link> Architecture </a> </li> <li class=md-tabs__item> <a href=../../advanced/emit-shorthands/ class=md-tabs__link> Advanced </a> </li> <li class=md-tabs__item> <a href=../../integrations/ class=md-tabs__link> Integrations </a> </li> <li class=md-tabs__item> <a href=../../examples/end-to-end/ class=md-tabs__link> Examples </a> </li> <li class=md-tabs__item> <a href=../../reference/reference/ class=md-tabs__link> Reference </a> </li> </ul> </div> </nav> </header> <div class=md-container data-md-component=container> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="DxMessaging Documentation" class="md-nav__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> DxMessaging Documentation </label> <div class=md-nav__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Home </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_2> <div class="md-nav__link md-nav__container"> <a href=../../getting-started/ class="md-nav__link "> <span class=md-ellipsis> Getting Started </span> </a> <label class="md-nav__link " for=__nav_2 id=__nav_2_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../getting-started/overview/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/install/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/quick-start/ class=md-nav__link> <span class=md-ellipsis> Quick Start </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/getting-started/ class=md-nav__link> <span class=md-ellipsis> Getting Started Guide </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/visual-guide/ class=md-nav__link> <span class=md-ellipsis> Visual Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_3> <div class="md-nav__link md-nav__container"> <a href=../../concepts/ class="md-nav__link "> <span class=md-ellipsis> Concepts </span> </a> <label class="md-nav__link " for=__nav_3 id=__nav_3_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Concepts </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../concepts/mental-model/ class=md-nav__link> <span class=md-ellipsis> Mental Model </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/message-types/ class=md-nav__link> <span class=md-ellipsis> Message Types </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/listening-patterns/ class=md-nav__link> <span class=md-ellipsis> Listening Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/targeting-and-context/ class=md-nav__link> <span class=md-ellipsis> Targeting & Context </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/interceptors-and-ordering/ class=md-nav__link> <span class=md-ellipsis> Interceptors & Ordering </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4 checked> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex> <span class=md-ellipsis> Guides </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_4_label aria-expanded=true> <label class=md-nav__title for=__nav_4> <span class="md-nav__icon md-icon"></span> Guides </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../patterns/ class=md-nav__link> <span class=md-ellipsis> Patterns </span> </a> </li> <li class=md-nav__item> <a href=../unity-integration/ class=md-nav__link> <span class=md-ellipsis> Unity Integration </span> </a> </li> <li class=md-nav__item> <a href=../testing/ class=md-nav__link> <span class=md-ellipsis> Testing </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Diagnostics </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Diagnostics </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#diagnosticstarget-enum class=md-nav__link> <span class=md-ellipsis> DiagnosticsTarget Enum </span> </a> </li> <li class=md-nav__item> <a href=#configuration-toggles class=md-nav__link> <span class=md-ellipsis> Configuration Toggles </span> </a> <nav class=md-nav aria-label="Configuration Toggles"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#global-defaults class=md-nav__link> <span class=md-ellipsis> Global Defaults </span> </a> </li> <li class=md-nav__item> <a href=#per-bus-and-per-token class=md-nav__link> <span class=md-ellipsis> Per-Bus and Per-Token </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#registrationlog-api class=md-nav__link> <span class=md-ellipsis> RegistrationLog API </span> </a> <nav class=md-nav aria-label="RegistrationLog API"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#properties class=md-nav__link> <span class=md-ellipsis> Properties </span> </a> </li> <li class=md-nav__item> <a href=#methods class=md-nav__link> <span class=md-ellipsis> Methods </span> </a> <nav class=md-nav aria-label=Methods> <ul class=md-nav__list> <li class=md-nav__item> <a href=#logmessagingregistration-registration class=md-nav__link> <span class=md-ellipsis> Log(MessagingRegistration registration) </span> </a> </li> <li class=md-nav__item> <a href=#getregistrationsinstanceid-instanceid class=md-nav__link> <span class=md-ellipsis> GetRegistrations(InstanceId instanceId) </span> </a> </li> <li class=md-nav__item> <a href=#tostring-and-tostringfunc-serializer class=md-nav__link> <span class=md-ellipsis> ToString() and ToString(Func&lt;MessagingRegistration, string&gt; serializer) </span> </a> </li> <li class=md-nav__item> <a href=#clearpredicate-shouldremove--null class=md-nav__link> <span class=md-ellipsis> Clear(Predicate&lt;MessagingRegistration&gt; shouldRemove = null) </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#messagingregistration-struct class=md-nav__link> <span class=md-ellipsis> MessagingRegistration Struct </span> </a> <nav class=md-nav aria-label="MessagingRegistration Struct"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#registrationmethod-values class=md-nav__link> <span class=md-ellipsis> RegistrationMethod Values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#emission-history class=md-nav__link> <span class=md-ellipsis> Emission History </span> </a> </li> <li class=md-nav__item> <a href=#logging-integration class=md-nav__link> <span class=md-ellipsis> Logging Integration </span> </a> </li> <li class=md-nav__item> <a href=#per-environment-configuration class=md-nav__link> <span class=md-ellipsis> Per-Environment Configuration </span> </a> <nav class=md-nav aria-label="Per-Environment Configuration"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#editor-only-diagnostics class=md-nav__link> <span class=md-ellipsis> Editor-Only Diagnostics </span> </a> </li> <li class=md-nav__item> <a href=#runtime-diagnostics-for-qa-builds class=md-nav__link> <span class=md-ellipsis> Runtime Diagnostics for QA Builds </span> </a> </li> <li class=md-nav__item> <a href=#conditional-logging-based-on-build-type class=md-nav__link> <span class=md-ellipsis> Conditional Logging Based on Build Type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#performance-considerations class=md-nav__link> <span class=md-ellipsis> Performance Considerations </span> </a> <nav class=md-nav aria-label="Performance Considerations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#memory-impact class=md-nav__link> <span class=md-ellipsis> Memory Impact </span> </a> </li> <li class=md-nav__item> <a href=#cpu-impact class=md-nav__link> <span class=md-ellipsis> CPU Impact </span> </a> </li> <li class=md-nav__item> <a href=#recommendations class=md-nav__link> <span class=md-ellipsis> Recommendations </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#editor-integration-inspector class=md-nav__link> <span class=md-ellipsis> Editor Integration (Inspector) </span> </a> </li> <li class=md-nav__item> <a href=#tips class=md-nav__link> <span class=md-ellipsis> Tips </span> </a> </li> <li class=md-nav__item> <a href=#related class=md-nav__link> <span class=md-ellipsis> Related </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../advanced/ class=md-nav__link> <span class=md-ellipsis> Advanced Topics </span> </a> </li> <li class=md-nav__item> <a href=../migration-guide/ class=md-nav__link> <span class=md-ellipsis> Migration Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_5> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex=0> <span class=md-ellipsis> Architecture </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_5_label aria-expanded=false> <label class=md-nav__title for=__nav_5> <span class="md-nav__icon md-icon"></span> Architecture </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../architecture/design-and-architecture/ class=md-nav__link> <span class=md-ellipsis> Design & Architecture </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/comparisons/ class=md-nav__link> <span class=md-ellipsis> Comparisons </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/performance/ class=md-nav__link> <span class=md-ellipsis> Performance </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Advanced </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Advanced </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../advanced/emit-shorthands/ class=md-nav__link> <span class=md-ellipsis> Emit Shorthands </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/message-bus-providers/ class=md-nav__link> <span class=md-ellipsis> Message Bus Providers </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/registration-builders/ class=md-nav__link> <span class=md-ellipsis> Registration Builders </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/runtime-configuration/ class=md-nav__link> <span class=md-ellipsis> Runtime Configuration </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/string-messages/ class=md-nav__link> <span class=md-ellipsis> String Messages </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_7> <div class="md-nav__link md-nav__container"> <a href=../../integrations/ class="md-nav__link "> <span class=md-ellipsis> Integrations </span> </a> <label class="md-nav__link " for=__nav_7 id=__nav_7_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Integrations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../integrations/vcontainer/ class=md-nav__link> <span class=md-ellipsis> VContainer </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/zenject/ class=md-nav__link> <span class=md-ellipsis> Zenject </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/reflex/ class=md-nav__link> <span class=md-ellipsis> Reflex </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Examples </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Examples </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../examples/end-to-end/ class=md-nav__link> <span class=md-ellipsis> End-to-End </span> </a> </li> <li class=md-nav__item> <a href=../../examples/end-to-end-scene-transitions/ class=md-nav__link> <span class=md-ellipsis> Scene Transitions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/reference/ class=md-nav__link> <span class=md-ellipsis> API Reference (Practical) </span> </a> </li> <li class=md-nav__item> <a href=../../reference/quick-reference/ class=md-nav__link> <span class=md-ellipsis> Quick Reference </span> </a> </li> <li class=md-nav__item> <a href=../../reference/helpers/ class=md-nav__link> <span class=md-ellipsis> Helpers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/faq/ class=md-nav__link> <span class=md-ellipsis> FAQ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/glossary/ class=md-nav__link> <span class=md-ellipsis> Glossary </span> </a> </li> <li class=md-nav__item> <a href=../../reference/troubleshooting/ class=md-nav__link> <span class=md-ellipsis> Troubleshooting </span> </a> </li> <li class=md-nav__item> <a href=../../reference/compatibility/ class=md-nav__link> <span class=md-ellipsis> Compatibility </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#diagnosticstarget-enum class=md-nav__link> <span class=md-ellipsis> DiagnosticsTarget Enum </span> </a> </li> <li class=md-nav__item> <a href=#configuration-toggles class=md-nav__link> <span class=md-ellipsis> Configuration Toggles </span> </a> <nav class=md-nav aria-label="Configuration Toggles"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#global-defaults class=md-nav__link> <span class=md-ellipsis> Global Defaults </span> </a> </li> <li class=md-nav__item> <a href=#per-bus-and-per-token class=md-nav__link> <span class=md-ellipsis> Per-Bus and Per-Token </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#registrationlog-api class=md-nav__link> <span class=md-ellipsis> RegistrationLog API </span> </a> <nav class=md-nav aria-label="RegistrationLog API"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#properties class=md-nav__link> <span class=md-ellipsis> Properties </span> </a> </li> <li class=md-nav__item> <a href=#methods class=md-nav__link> <span class=md-ellipsis> Methods </span> </a> <nav class=md-nav aria-label=Methods> <ul class=md-nav__list> <li class=md-nav__item> <a href=#logmessagingregistration-registration class=md-nav__link> <span class=md-ellipsis> Log(MessagingRegistration registration) </span> </a> </li> <li class=md-nav__item> <a href=#getregistrationsinstanceid-instanceid class=md-nav__link> <span class=md-ellipsis> GetRegistrations(InstanceId instanceId) </span> </a> </li> <li class=md-nav__item> <a href=#tostring-and-tostringfunc-serializer class=md-nav__link> <span class=md-ellipsis> ToString() and ToString(Func&lt;MessagingRegistration, string&gt; serializer) </span> </a> </li> <li class=md-nav__item> <a href=#clearpredicate-shouldremove--null class=md-nav__link> <span class=md-ellipsis> Clear(Predicate&lt;MessagingRegistration&gt; shouldRemove = null) </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#messagingregistration-struct class=md-nav__link> <span class=md-ellipsis> MessagingRegistration Struct </span> </a> <nav class=md-nav aria-label="MessagingRegistration Struct"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#registrationmethod-values class=md-nav__link> <span class=md-ellipsis> RegistrationMethod Values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#emission-history class=md-nav__link> <span class=md-ellipsis> Emission History </span> </a> </li> <li class=md-nav__item> <a href=#logging-integration class=md-nav__link> <span class=md-ellipsis> Logging Integration </span> </a> </li> <li class=md-nav__item> <a href=#per-environment-configuration class=md-nav__link> <span class=md-ellipsis> Per-Environment Configuration </span> </a> <nav class=md-nav aria-label="Per-Environment Configuration"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#editor-only-diagnostics class=md-nav__link> <span class=md-ellipsis> Editor-Only Diagnostics </span> </a> </li> <li class=md-nav__item> <a href=#runtime-diagnostics-for-qa-builds class=md-nav__link> <span class=md-ellipsis> Runtime Diagnostics for QA Builds </span> </a> </li> <li class=md-nav__item> <a href=#conditional-logging-based-on-build-type class=md-nav__link> <span class=md-ellipsis> Conditional Logging Based on Build Type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#performance-considerations class=md-nav__link> <span class=md-ellipsis> Performance Considerations </span> </a> <nav class=md-nav aria-label="Performance Considerations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#memory-impact class=md-nav__link> <span class=md-ellipsis> Memory Impact </span> </a> </li> <li class=md-nav__item> <a href=#cpu-impact class=md-nav__link> <span class=md-ellipsis> CPU Impact </span> </a> </li> <li class=md-nav__item> <a href=#recommendations class=md-nav__link> <span class=md-ellipsis> Recommendations </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#editor-integration-inspector class=md-nav__link> <span class=md-ellipsis> Editor Integration (Inspector) </span> </a> </li> <li class=md-nav__item> <a href=#tips class=md-nav__link> <span class=md-ellipsis> Tips </span> </a> </li> <li class=md-nav__item> <a href=#related class=md-nav__link> <span class=md-ellipsis> Related </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <nav class=md-path aria-label=Navigation> <ol class=md-path__list> <li class=md-path__item> <a href=../.. class=md-path__link> <span class=md-ellipsis> Home </span> </a> </li> <li class=md-path__item> <a href=../patterns/ class=md-path__link> <span class=md-ellipsis> Guides </span> </a> </li> </ol> </nav> <article class="md-content__inner md-typeset"> <a href=https://github.com/wallstop/DxMessaging/edit/master/docs/guides/diagnostics.md title="Edit this page" class="md-content__button md-icon" rel=edit> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg> </a> <a href=https://github.com/wallstop/DxMessaging/raw/master/docs/guides/diagnostics.md title="View source of this page" class="md-content__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg> </a> <h1 id=diagnostics>Diagnostics<a class=headerlink href=#diagnostics title="Anchor link to this section">&para;</a></h1> <p>DxMessaging emphasizes visibility. You can enable diagnostics globally or per token, inspect recent emissions, page through registrations, and even view contexts (targets/sources) — all from the MessagingComponent inspector.</p> <h2 id=diagnosticstarget-enum>DiagnosticsTarget Enum<a class=headerlink href=#diagnosticstarget-enum title="Anchor link to this section">&para;</a></h2> <p>The <code>DiagnosticsTarget</code> enum is a flags enum that controls when diagnostics are enabled. It allows fine-grained control over which execution environments collect diagnostic data.</p> <table> <thead> <tr> <th>Value</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>Off</code></td> <td>Diagnostics are disabled in all environments.</td> </tr> <tr> <td><code>Editor</code></td> <td>Diagnostics run only while in the Unity Editor.</td> </tr> <tr> <td><code>Runtime</code></td> <td>Diagnostics run only in player/runtime builds (not the Editor).</td> </tr> <tr> <td><code>All</code></td> <td>Diagnostics run in both Editor and runtime environments.</td> </tr> </tbody> </table> <p>Because <code>DiagnosticsTarget</code> is a flags enum, you can combine values:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a>
-</span><span id=__span-0-3><a id=__codelineno-0-3 name=__codelineno-0-3 href=#__codelineno-0-3></a><span class=c1>// Enable diagnostics only in the Unity Editor</span>
-</span><span id=__span-0-4><a id=__codelineno-0-4 name=__codelineno-0-4 href=#__codelineno-0-4></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Editor</span><span class=p>;</span>
-</span><span id=__span-0-5><a id=__codelineno-0-5 name=__codelineno-0-5 href=#__codelineno-0-5></a>
-</span><span id=__span-0-6><a id=__codelineno-0-6 name=__codelineno-0-6 href=#__codelineno-0-6></a><span class=c1>// Enable diagnostics only in runtime builds</span>
-</span><span id=__span-0-7><a id=__codelineno-0-7 name=__codelineno-0-7 href=#__codelineno-0-7></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Runtime</span><span class=p>;</span>
-</span><span id=__span-0-8><a id=__codelineno-0-8 name=__codelineno-0-8 href=#__codelineno-0-8></a>
-</span><span id=__span-0-9><a id=__codelineno-0-9 name=__codelineno-0-9 href=#__codelineno-0-9></a><span class=c1>// Enable diagnostics everywhere</span>
-</span><span id=__span-0-10><a id=__codelineno-0-10 name=__codelineno-0-10 href=#__codelineno-0-10></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>All</span><span class=p>;</span>
-</span><span id=__span-0-11><a id=__codelineno-0-11 name=__codelineno-0-11 href=#__codelineno-0-11></a>
-</span><span id=__span-0-12><a id=__codelineno-0-12 name=__codelineno-0-12 href=#__codelineno-0-12></a><span class=c1>// Disable diagnostics completely</span>
-</span><span id=__span-0-13><a id=__codelineno-0-13 name=__codelineno-0-13 href=#__codelineno-0-13></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Off</span><span class=p>;</span>
-</span></code></pre></div> <h2 id=configuration-toggles>Configuration Toggles<a class=headerlink href=#configuration-toggles title="Anchor link to this section">&para;</a></h2> <p>DxMessaging provides multiple levels of diagnostics control:</p> <h3 id=global-defaults>Global Defaults<a class=headerlink href=#global-defaults title="Anchor link to this section">&para;</a></h3> <ul> <li><code>IMessageBus.GlobalDiagnosticsTargets</code> — Sets the default diagnostics mode for newly created buses and tokens. Uses the <code>DiagnosticsTarget</code> flags enum.</li> <li><code>IMessageBus.GlobalMessageBufferSize</code> — Sets the default ring buffer size for emission history (default: 100).</li> </ul> <h3 id=per-bus-and-per-token>Per-Bus and Per-Token<a class=headerlink href=#per-bus-and-per-token title="Anchor link to this section">&para;</a></h3> <ul> <li><code>IMessageBus.DiagnosticsMode</code> — Read-only property indicating whether diagnostics are active for a specific bus instance.</li> <li><code>MessageRegistrationToken.DiagnosticMode</code> — Controls diagnostics for an individual registration token.</li> </ul> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-1-3><a id=__codelineno-1-3 name=__codelineno-1-3 href=#__codelineno-1-3></a>
-</span><span id=__span-1-4><a id=__codelineno-1-4 name=__codelineno-1-4 href=#__codelineno-1-4></a><span class=c1>// Configure global defaults before creating buses/tokens</span>
-</span><span id=__span-1-5><a id=__codelineno-1-5 name=__codelineno-1-5 href=#__codelineno-1-5></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Editor</span><span class=p>;</span>
-</span><span id=__span-1-6><a id=__codelineno-1-6 name=__codelineno-1-6 href=#__codelineno-1-6></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalMessageBufferSize</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>200</span><span class=p>;</span>
-</span><span id=__span-1-7><a id=__codelineno-1-7 name=__codelineno-1-7 href=#__codelineno-1-7></a>
-</span><span id=__span-1-8><a id=__codelineno-1-8 name=__codelineno-1-8 href=#__codelineno-1-8></a><span class=c1>// Check if diagnostics are enabled for a specific bus</span>
-</span><span id=__span-1-9><a id=__codelineno-1-9 name=__codelineno-1-9 href=#__codelineno-1-9></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>bus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>;</span>
-</span><span id=__span-1-10><a id=__codelineno-1-10 name=__codelineno-1-10 href=#__codelineno-1-10></a><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=n>bus</span><span class=p>.</span><span class=n>DiagnosticsMode</span><span class=p>)</span>
-</span><span id=__span-1-11><a id=__codelineno-1-11 name=__codelineno-1-11 href=#__codelineno-1-11></a><span class=p>{</span>
-</span><span id=__span-1-12><a id=__codelineno-1-12 name=__codelineno-1-12 href=#__codelineno-1-12></a><span class=w>    </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>&quot;Diagnostics are active on this bus.&quot;</span><span class=p>);</span>
-</span><span id=__span-1-13><a id=__codelineno-1-13 name=__codelineno-1-13 href=#__codelineno-1-13></a><span class=p>}</span>
-</span></code></pre></div> <h2 id=registrationlog-api>RegistrationLog API<a class=headerlink href=#registrationlog-api title="Anchor link to this section">&para;</a></h2> <p>The <code>RegistrationLog</code> class tracks all messaging registrations and deregistrations for a message bus. This is invaluable for debugging subscription issues and understanding message flow.</p> <h3 id=properties>Properties<a class=headerlink href=#properties title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Property</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>Enabled</code></td> <td><code>bool</code></td> <td>Get/set whether logging is active. Disabled by default for performance.</td> </tr> <tr> <td><code>Registrations</code></td> <td><code>IReadOnlyList&lt;MessagingRegistration&gt;</code></td> <td>Read-only access to all logged registrations.</td> </tr> </tbody> </table> <h3 id=methods>Methods<a class=headerlink href=#methods title="Anchor link to this section">&para;</a></h3> <h4 id=logmessagingregistration-registration><code>Log(MessagingRegistration registration)</code><a class=headerlink href=#logmessagingregistration-registration title="Anchor link to this section">&para;</a></h4> <p>Records a registration event. Called automatically by the message bus when <code>Enabled</code> is true.</p> <h4 id=getregistrationsinstanceid-instanceid><code>GetRegistrations(InstanceId instanceId)</code><a class=headerlink href=#getregistrationsinstanceid-instanceid title="Anchor link to this section">&para;</a></h4> <p>Returns all registrations for a specific instance. Useful for inspecting what a particular component has registered for.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-2-3><a id=__codelineno-2-3 name=__codelineno-2-3 href=#__codelineno-2-3></a>
-</span><span id=__span-2-4><a id=__codelineno-2-4 name=__codelineno-2-4 href=#__codelineno-2-4></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>bus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>;</span>
-</span><span id=__span-2-5><a id=__codelineno-2-5 name=__codelineno-2-5 href=#__codelineno-2-5></a><span class=n>bus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>Enabled</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=p>;</span>
-</span><span id=__span-2-6><a id=__codelineno-2-6 name=__codelineno-2-6 href=#__codelineno-2-6></a>
-</span><span id=__span-2-7><a id=__codelineno-2-7 name=__codelineno-2-7 href=#__codelineno-2-7></a><span class=c1>// After some registrations occur...</span>
-</span><span id=__span-2-8><a id=__codelineno-2-8 name=__codelineno-2-8 href=#__codelineno-2-8></a><span class=n>InstanceId</span><span class=w> </span><span class=n>myComponent</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>GetComponent</span><span class=o>&lt;</span><span class=n>MonoBehaviour</span><span class=o>&gt;</span><span class=p>();</span>
-</span><span id=__span-2-9><a id=__codelineno-2-9 name=__codelineno-2-9 href=#__codelineno-2-9></a><span class=k>foreach</span><span class=w> </span><span class=p>(</span><span class=n>MessagingRegistration</span><span class=w> </span><span class=n>reg</span><span class=w> </span><span class=k>in</span><span class=w> </span><span class=n>bus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>GetRegistrations</span><span class=p>(</span><span class=n>myComponent</span><span class=p>))</span>
-</span><span id=__span-2-10><a id=__codelineno-2-10 name=__codelineno-2-10 href=#__codelineno-2-10></a><span class=p>{</span>
-</span><span id=__span-2-11><a id=__codelineno-2-11 name=__codelineno-2-11 href=#__codelineno-2-11></a><span class=w>    </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Registered for {reg.type.Name} via {reg.registrationMethod}&quot;</span><span class=p>);</span>
-</span><span id=__span-2-12><a id=__codelineno-2-12 name=__codelineno-2-12 href=#__codelineno-2-12></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=tostring-and-tostringfunc-serializer><code>ToString()</code> and <code>ToString(Func&lt;MessagingRegistration, string&gt; serializer)</code><a class=headerlink href=#tostring-and-tostringfunc-serializer title="Anchor link to this section">&para;</a></h4> <p>Returns a string representation of all logged registrations. You can provide a custom serializer for formatted output.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a>
-</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>bus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>;</span>
-</span><span id=__span-3-5><a id=__codelineno-3-5 name=__codelineno-3-5 href=#__codelineno-3-5></a><span class=n>bus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>Enabled</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=p>;</span>
-</span><span id=__span-3-6><a id=__codelineno-3-6 name=__codelineno-3-6 href=#__codelineno-3-6></a>
-</span><span id=__span-3-7><a id=__codelineno-3-7 name=__codelineno-3-7 href=#__codelineno-3-7></a><span class=c1>// ... after some registrations/deregistrations</span>
-</span><span id=__span-3-8><a id=__codelineno-3-8 name=__codelineno-3-8 href=#__codelineno-3-8></a><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=n>bus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>ToString</span><span class=p>());</span>
-</span><span id=__span-3-9><a id=__codelineno-3-9 name=__codelineno-3-9 href=#__codelineno-3-9></a>
-</span><span id=__span-3-10><a id=__codelineno-3-10 name=__codelineno-3-10 href=#__codelineno-3-10></a><span class=c1>// Custom formatting</span>
-</span><span id=__span-3-11><a id=__codelineno-3-11 name=__codelineno-3-11 href=#__codelineno-3-11></a><span class=kt>string</span><span class=w> </span><span class=n>formatted</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>bus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>ToString</span><span class=p>(</span><span class=n>reg</span><span class=w> </span><span class=o>=&gt;</span>
-</span><span id=__span-3-12><a id=__codelineno-3-12 name=__codelineno-3-12 href=#__codelineno-3-12></a><span class=w>    </span><span class=s>$&quot;[{reg.registrationType}] {reg.type.Name} @ {reg.time:F2}s&quot;</span>
-</span><span id=__span-3-13><a id=__codelineno-3-13 name=__codelineno-3-13 href=#__codelineno-3-13></a><span class=p>);</span>
-</span><span id=__span-3-14><a id=__codelineno-3-14 name=__codelineno-3-14 href=#__codelineno-3-14></a><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=n>formatted</span><span class=p>);</span>
-</span></code></pre></div> <h4 id=clearpredicate-shouldremove--null><code>Clear(Predicate&lt;MessagingRegistration&gt; shouldRemove = null)</code><a class=headerlink href=#clearpredicate-shouldremove--null title="Anchor link to this section">&para;</a></h4> <p>Removes registrations from the log. Pass <code>null</code> to clear all, or provide a predicate to selectively remove entries.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-4-2><a id=__codelineno-4-2 name=__codelineno-4-2 href=#__codelineno-4-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-4-3><a id=__codelineno-4-3 name=__codelineno-4-3 href=#__codelineno-4-3></a>
-</span><span id=__span-4-4><a id=__codelineno-4-4 name=__codelineno-4-4 href=#__codelineno-4-4></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>bus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>;</span>
-</span><span id=__span-4-5><a id=__codelineno-4-5 name=__codelineno-4-5 href=#__codelineno-4-5></a>
-</span><span id=__span-4-6><a id=__codelineno-4-6 name=__codelineno-4-6 href=#__codelineno-4-6></a><span class=c1>// Clear all registrations</span>
-</span><span id=__span-4-7><a id=__codelineno-4-7 name=__codelineno-4-7 href=#__codelineno-4-7></a><span class=kt>int</span><span class=w> </span><span class=n>cleared</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>bus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>Clear</span><span class=p>();</span>
-</span><span id=__span-4-8><a id=__codelineno-4-8 name=__codelineno-4-8 href=#__codelineno-4-8></a>
-</span><span id=__span-4-9><a id=__codelineno-4-9 name=__codelineno-4-9 href=#__codelineno-4-9></a><span class=c1>// Clear only deregistrations</span>
-</span><span id=__span-4-10><a id=__codelineno-4-10 name=__codelineno-4-10 href=#__codelineno-4-10></a><span class=kt>int</span><span class=w> </span><span class=n>deregistrationsCleared</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>bus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>Clear</span><span class=p>(</span>
-</span><span id=__span-4-11><a id=__codelineno-4-11 name=__codelineno-4-11 href=#__codelineno-4-11></a><span class=w>    </span><span class=n>reg</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>reg</span><span class=p>.</span><span class=n>registrationType</span><span class=w> </span><span class=o>==</span><span class=w> </span><span class=n>RegistrationType</span><span class=p>.</span><span class=n>Deregister</span>
-</span><span id=__span-4-12><a id=__codelineno-4-12 name=__codelineno-4-12 href=#__codelineno-4-12></a><span class=p>);</span>
-</span></code></pre></div> <h2 id=messagingregistration-struct>MessagingRegistration Struct<a class=headerlink href=#messagingregistration-struct title="Anchor link to this section">&para;</a></h2> <p>Each logged registration is stored as a <code>MessagingRegistration</code> struct containing:</p> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td><code>InstanceId</code></td> <td>The handler's unique identifier.</td> </tr> <tr> <td><code>type</code></td> <td><code>Type</code></td> <td>The message type being registered for.</td> </tr> <tr> <td><code>registrationType</code></td> <td><code>RegistrationType</code></td> <td>Whether this was a <code>Register</code> or <code>Deregister</code> event.</td> </tr> <tr> <td><code>registrationMethod</code></td> <td><code>RegistrationMethod</code></td> <td>The exact registration category (Targeted, Broadcast, etc.).</td> </tr> <tr> <td><code>time</code></td> <td><code>float</code></td> <td>Unity time when the registration occurred (Unity only).</td> </tr> </tbody> </table> <h3 id=registrationmethod-values>RegistrationMethod Values<a class=headerlink href=#registrationmethod-values title="Anchor link to this section">&para;</a></h3> <p>The <code>RegistrationMethod</code> enum captures how the handler was wired up:</p> <ul> <li><code>Targeted</code> — Bound to a specific recipient</li> <li><code>Untargeted</code> — Global untargeted handler</li> <li><code>Broadcast</code> — Bound to a specific source</li> <li><code>BroadcastWithoutSource</code> — Broadcast handler without explicit source</li> <li><code>TargetedWithoutTargeting</code> — Targeted handler ignoring runtime target</li> <li><code>GlobalAcceptAll</code> — Catch-all handler</li> <li><code>Interceptor</code> — Message interceptor</li> <li><code>UntargetedPostProcessor</code>, <code>TargetedPostProcessor</code>, <code>BroadcastPostProcessor</code> — Post-processors</li> <li><code>TargetedWithoutTargetingPostProcessor</code> — Post-processor for targeted messages ignoring runtime target</li> <li><code>BroadcastWithoutSourcePostProcessor</code> — Post-processor for broadcasts without explicit source</li> </ul> <h2 id=emission-history>Emission History<a class=headerlink href=#emission-history title="Anchor link to this section">&para;</a></h2> <p>When diagnostics are enabled, buses and tokens record message emissions in a ring buffer:</p> <ul> <li>Buffer size is controlled by <code>IMessageBus.GlobalMessageBufferSize</code> (default: 100).</li> <li>Setting buffer size to 0 disables history retention (emissions are silently discarded).</li> <li>Inspect recent emissions per token via built-in diagnostics or build custom tools using post-processors.</li> </ul> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a>
-</span><span id=__span-5-3><a id=__codelineno-5-3 name=__codelineno-5-3 href=#__codelineno-5-3></a><span class=c1>// Increase buffer size for more history</span>
-</span><span id=__span-5-4><a id=__codelineno-5-4 name=__codelineno-5-4 href=#__codelineno-5-4></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalMessageBufferSize</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>500</span><span class=p>;</span>
-</span></code></pre></div> <h2 id=logging-integration>Logging Integration<a class=headerlink href=#logging-integration title="Anchor link to this section">&para;</a></h2> <p>Integrate DxMessaging with your logging framework:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a>
-</span><span id=__span-6-3><a id=__codelineno-6-3 name=__codelineno-6-3 href=#__codelineno-6-3></a><span class=n>MessagingDebug</span><span class=p>.</span><span class=n>enabled</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=p>;</span>
-</span><span id=__span-6-4><a id=__codelineno-6-4 name=__codelineno-6-4 href=#__codelineno-6-4></a><span class=n>MessagingDebug</span><span class=p>.</span><span class=n>LogFunction</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=p>(</span><span class=n>level</span><span class=p>,</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span>
-</span><span id=__span-6-5><a id=__codelineno-6-5 name=__codelineno-6-5 href=#__codelineno-6-5></a><span class=w>    </span><span class=n>UnityEngine</span><span class=p>.</span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;[DxMessaging:{level}] {msg}&quot;</span><span class=p>);</span>
-</span></code></pre></div> <h2 id=per-environment-configuration>Per-Environment Configuration<a class=headerlink href=#per-environment-configuration title="Anchor link to this section">&para;</a></h2> <p>A common pattern is enabling diagnostics only in the Editor for development visibility while keeping runtime builds lean.</p> <h3 id=editor-only-diagnostics>Editor-Only Diagnostics<a class=headerlink href=#editor-only-diagnostics title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-7-2><a id=__codelineno-7-2 name=__codelineno-7-2 href=#__codelineno-7-2></a>
-</span><span id=__span-7-3><a id=__codelineno-7-3 name=__codelineno-7-3 href=#__codelineno-7-3></a><span class=c1>// Enable diagnostics only when running in the Unity Editor</span>
-</span><span id=__span-7-4><a id=__codelineno-7-4 name=__codelineno-7-4 href=#__codelineno-7-4></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Editor</span><span class=p>;</span>
-</span></code></pre></div> <p>This is the recommended default for most projects. You get full visibility during development without any performance cost in production builds.</p> <h3 id=runtime-diagnostics-for-qa-builds>Runtime Diagnostics for QA Builds<a class=headerlink href=#runtime-diagnostics-for-qa-builds title="Anchor link to this section">&para;</a></h3> <p>For QA or debug builds where you need diagnostics in the player:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a>
-</span><span id=__span-8-3><a id=__codelineno-8-3 name=__codelineno-8-3 href=#__codelineno-8-3></a><span class=cp>#if DEVELOPMENT_BUILD || UNITY_EDITOR</span>
-</span><span id=__span-8-4><a id=__codelineno-8-4 name=__codelineno-8-4 href=#__codelineno-8-4></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>All</span><span class=p>;</span>
-</span><span id=__span-8-5><a id=__codelineno-8-5 name=__codelineno-8-5 href=#__codelineno-8-5></a><span class=cp>#else</span>
-</span><span id=__span-8-6><a id=__codelineno-8-6 name=__codelineno-8-6 href=#__codelineno-8-6></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Off</span><span class=p>;</span>
-</span><span id=__span-8-7><a id=__codelineno-8-7 name=__codelineno-8-7 href=#__codelineno-8-7></a><span class=cp>#endif</span>
-</span></code></pre></div> <h3 id=conditional-logging-based-on-build-type>Conditional Logging Based on Build Type<a class=headerlink href=#conditional-logging-based-on-build-type title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-9-1><a id=__codelineno-9-1 name=__codelineno-9-1 href=#__codelineno-9-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-9-2><a id=__codelineno-9-2 name=__codelineno-9-2 href=#__codelineno-9-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-9-3><a id=__codelineno-9-3 name=__codelineno-9-3 href=#__codelineno-9-3></a>
-</span><span id=__span-9-4><a id=__codelineno-9-4 name=__codelineno-9-4 href=#__codelineno-9-4></a><span class=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>DiagnosticsBootstrap</span>
-</span><span id=__span-9-5><a id=__codelineno-9-5 name=__codelineno-9-5 href=#__codelineno-9-5></a><span class=p>{</span>
-</span><span id=__span-9-6><a id=__codelineno-9-6 name=__codelineno-9-6 href=#__codelineno-9-6></a><span class=w>    </span><span class=na>[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]</span>
-</span><span id=__span-9-7><a id=__codelineno-9-7 name=__codelineno-9-7 href=#__codelineno-9-7></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>Initialize</span><span class=p>()</span>
-</span><span id=__span-9-8><a id=__codelineno-9-8 name=__codelineno-9-8 href=#__codelineno-9-8></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-9-9><a id=__codelineno-9-9 name=__codelineno-9-9 href=#__codelineno-9-9></a><span class=cp>#if UNITY_EDITOR</span>
-</span><span id=__span-9-10><a id=__codelineno-9-10 name=__codelineno-9-10 href=#__codelineno-9-10></a><span class=w>        </span><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Editor</span><span class=p>;</span>
-</span><span id=__span-9-11><a id=__codelineno-9-11 name=__codelineno-9-11 href=#__codelineno-9-11></a><span class=w>        </span><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalMessageBufferSize</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>200</span><span class=p>;</span>
-</span><span id=__span-9-12><a id=__codelineno-9-12 name=__codelineno-9-12 href=#__codelineno-9-12></a><span class=w>        </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>.</span><span class=n>Log</span><span class=p>.</span><span class=n>Enabled</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=p>;</span>
-</span><span id=__span-9-13><a id=__codelineno-9-13 name=__codelineno-9-13 href=#__codelineno-9-13></a><span class=cp>#elif DEVELOPMENT_BUILD</span>
-</span><span id=__span-9-14><a id=__codelineno-9-14 name=__codelineno-9-14 href=#__codelineno-9-14></a><span class=w>        </span><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Runtime</span><span class=p>;</span>
-</span><span id=__span-9-15><a id=__codelineno-9-15 name=__codelineno-9-15 href=#__codelineno-9-15></a><span class=w>        </span><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalMessageBufferSize</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>50</span><span class=p>;</span>
-</span><span id=__span-9-16><a id=__codelineno-9-16 name=__codelineno-9-16 href=#__codelineno-9-16></a><span class=cp>#else</span>
-</span><span id=__span-9-17><a id=__codelineno-9-17 name=__codelineno-9-17 href=#__codelineno-9-17></a><span class=w>        </span><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Off</span><span class=p>;</span>
-</span><span id=__span-9-18><a id=__codelineno-9-18 name=__codelineno-9-18 href=#__codelineno-9-18></a><span class=cp>#endif</span>
-</span><span id=__span-9-19><a id=__codelineno-9-19 name=__codelineno-9-19 href=#__codelineno-9-19></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-9-20><a id=__codelineno-9-20 name=__codelineno-9-20 href=#__codelineno-9-20></a><span class=p>}</span>
-</span></code></pre></div> <h2 id=performance-considerations>Performance Considerations<a class=headerlink href=#performance-considerations title="Anchor link to this section">&para;</a></h2> <p>Diagnostics add overhead. Consider these factors when enabling them:</p> <h3 id=memory-impact>Memory Impact<a class=headerlink href=#memory-impact title="Anchor link to this section">&para;</a></h3> <ul> <li>Each <code>MessagingRegistration</code> struct consumes memory for the registration log.</li> <li>The emission ring buffer stores <code>MessageEmissionData</code> records (controlled by <code>GlobalMessageBufferSize</code>).</li> <li>Larger buffer sizes consume more memory but provide more history.</li> </ul> <h3 id=cpu-impact>CPU Impact<a class=headerlink href=#cpu-impact title="Anchor link to this section">&para;</a></h3> <ul> <li>Registration logging adds overhead to every <code>Register</code> and <code>Deregister</code> call.</li> <li>Emission recording adds overhead to every message broadcast.</li> <li>Post-processor chains for diagnostics run after each message dispatch.</li> </ul> <h3 id=recommendations>Recommendations<a class=headerlink href=#recommendations title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Environment</th> <th>Recommended Setting</th> <th>Buffer Size</th> </tr> </thead> <tbody> <tr> <td>Development/Editor</td> <td><code>DiagnosticsTarget.Editor</code></td> <td>100-200</td> </tr> <tr> <td>QA/Debug Builds</td> <td><code>DiagnosticsTarget.All</code></td> <td>50-100</td> </tr> <tr> <td>Release Builds</td> <td><code>DiagnosticsTarget.Off</code></td> <td>N/A</td> </tr> <tr> <td>Automated Tests</td> <td><code>DiagnosticsTarget.All</code> + <code>Log.Enabled</code></td> <td>100</td> </tr> </tbody> </table> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-10-1><a id=__codelineno-10-1 name=__codelineno-10-1 href=#__codelineno-10-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-10-2><a id=__codelineno-10-2 name=__codelineno-10-2 href=#__codelineno-10-2></a>
-</span><span id=__span-10-3><a id=__codelineno-10-3 name=__codelineno-10-3 href=#__codelineno-10-3></a><span class=c1>// Production-safe defaults</span>
-</span><span id=__span-10-4><a id=__codelineno-10-4 name=__codelineno-10-4 href=#__codelineno-10-4></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsTargets</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>DiagnosticsTarget</span><span class=p>.</span><span class=n>Off</span><span class=p>;</span>
-</span><span id=__span-10-5><a id=__codelineno-10-5 name=__codelineno-10-5 href=#__codelineno-10-5></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalMessageBufferSize</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>0</span><span class=p>;</span><span class=w> </span><span class=c1>// No history retention</span>
-</span></code></pre></div> <h2 id=editor-integration-inspector>Editor Integration (Inspector)<a class=headerlink href=#editor-integration-inspector title="Anchor link to this section">&para;</a></h2> <p>Attach <code>MessagingComponent</code> to a GameObject. In the Unity Inspector:</p> <ul> <li><strong>Enable/Disable Global Diagnostics</strong>: Toggles bus-wide recording.</li> <li><strong>Global Buffer</strong>: Paged view of recent emissions (type and context). Matching listeners are highlighted.</li> <li><strong>Local Buffer</strong>: Per-listener ring buffer; enable per-token diagnostics to populate.</li> <li><strong>Registrations</strong>: Paged list of what each listener registered for (type, priority, context).</li> </ul> <h2 id=tips>Tips<a class=headerlink href=#tips title="Anchor link to this section">&para;</a></h2> <ul> <li>Turn on diagnostics while developing; turn off for release builds if you don't need runtime recording.</li> <li>Use <code>RegisterTargetedWithoutTargeting</code> or <code>RegisterBroadcastWithoutSource</code> for custom monitoring dashboards.</li> <li>Set <code>Log.Enabled = true</code> in tests to verify registration behavior.</li> <li>Use <code>Log.Clear()</code> between test cases to isolate registration tracking.</li> </ul> <h2 id=related>Related<a class=headerlink href=#related title="Anchor link to this section">&para;</a></h2> <ul> <li><a href=../../concepts/listening-patterns/ >Listening Patterns</a></li> <li><a href=../../reference/troubleshooting/ >Troubleshooting</a></li> </ul> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 27, 2026 04:59:07 UTC"><span class=timeago datetime=2026-01-27T04:59:07+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 27, 2026 04:59:07 UTC">2026-01-27</span> </span> <span class=md-source-file__fact> <span class=md-icon title=Created> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M14.47 15.08 11 13V7h1.5v5.25l3.08 1.83c-.41.28-.79.62-1.11 1m-1.39 4.84c-.36.05-.71.08-1.08.08-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8c0 .37-.03.72-.08 1.08.69.1 1.33.32 1.92.64.1-.56.16-1.13.16-1.72 0-5.5-4.5-10-10-10S2 6.5 2 12s4.47 10 10 10c.59 0 1.16-.06 1.72-.16-.32-.59-.54-1.23-.64-1.92M18 15v3h-3v2h3v3h2v-3h3v-2h-3v-3z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 27, 2026 04:59:07 UTC"><span class=timeago datetime=2026-01-27T04:59:07+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 27, 2026 04:59:07 UTC">2026-01-27</span> </span> </aside> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Back to top </button> </main> <footer class=md-footer> <nav class="md-footer__inner md-grid" aria-label=Footer> <a href=../testing/ class="md-footer__link md-footer__link--prev" aria-label="Previous: Testing"> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </div> <div class=md-footer__title> <span class=md-footer__direction> Previous </span> <div class=md-ellipsis> Testing </div> </div> </a> <a href=../advanced/ class="md-footer__link md-footer__link--next" aria-label="Next: Advanced Topics"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> Advanced Topics </div> </div> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg> </div> </a> </nav> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> <div class=md-copyright__highlight> Copyright &copy; 2017-2026 Wallstop Studios </div> </div> <div class=md-social> <a href=https://github.com/wallstop target=_blank rel=noopener title="Wallstop Studios on GitHub" class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-progress data-md-component=progress role=progressbar></div> <script id=__config type=application/json>{"annotate": null, "base": "../..", "features": ["announce.dismiss", "content.action.edit", "content.action.view", "content.code.annotate", "content.code.copy", "content.tabs.link", "navigation.expand", "navigation.footer", "navigation.indexes", "navigation.instant", "navigation.instant.prefetch", "navigation.instant.progress", "navigation.path", "navigation.sections", "navigation.tabs", "navigation.tabs.sticky", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script> <script src=../../assets/javascripts/bundle.79ae519e.min.js></script> <script src=../../js/timeago.min.js></script> <script src=../../js/timeago_mkdocs_material.js></script> <script src=https://unpkg.com/mermaid@11/dist/mermaid.min.js></script> <script src=../../javascripts/mermaid-config.js></script> <script src=../../javascripts/csharp-highlight.js></script> </body> </html>

package/site/guides/diagnostics/index.html.meta DELETED Viewed

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: fec0550ae9d50394faf73adf4aeb914e
-TextScriptImporter:
-  externalObjects: {}
-  userData:
-  assetBundleName:
-  assetBundleVariant:

package/site/guides/diagnostics.meta DELETED Viewed

@@ -1,8 +0,0 @@
-fileFormatVersion: 2
-guid: ff36f13a3065fcc45b8542eafc10d6e3
-folderAsset: yes
-DefaultImporter:
-  externalObjects: {}
-  userData:
-  assetBundleName:
-  assetBundleVariant: