<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:02:29 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-11282] Add sharding metadata refresh metrics section to serverStatus (SERVER-28670)</title>
                <link>https://jira.mongodb.org/browse/DOCS-11282</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;h1&gt;&lt;a name=&quot;DocumentationRequestSummary%3A&quot;&gt;&lt;/a&gt;Documentation Request Summary: &lt;/h1&gt;

&lt;p&gt;This change introduce a new &lt;tt&gt;shardingStatistics&lt;/tt&gt; server status section, with the following contents:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;Catalog cache statistics (under a &lt;tt&gt;catalogCache&lt;/tt&gt; subsection) - described &lt;a href=&quot;https://github.com/mongodb/mongo/blob/bc433b50e0205dfd0a8bfb6906393d841fd8193a/src/mongo/s/catalog_cache.h#L197&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;here&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;General shard statistics - described &lt;a href=&quot;https://github.com/mongodb/mongo/blob/bc433b50e0205dfd0a8bfb6906393d841fd8193a/src/mongo/db/s/sharding_statistics.h&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;here&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;&lt;a name=&quot;Scopeofchanges%3A&quot;&gt;&lt;/a&gt;Scope of changes: &lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;Impacttootherdocsoutsideofthisproduct%3A&quot;&gt;&lt;/a&gt;Impact to other docs outside of this product: &lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;MVP%3A&quot;&gt;&lt;/a&gt;MVP: &lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;Resources%3A&quot;&gt;&lt;/a&gt;Resources: &lt;/h2&gt;



&lt;h2&gt;&lt;a name=&quot;Scopeofchanges%3A&quot;&gt;&lt;/a&gt;Scope of changes: &lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;Impacttootherdocsoutsideofthisproduct%3A&quot;&gt;&lt;/a&gt;Impact to other docs outside of this product: &lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;MVP%3A&quot;&gt;&lt;/a&gt;MVP: &lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;Resources%3A&quot;&gt;&lt;/a&gt;Resources: &lt;/h2&gt;

&lt;h3&gt;&lt;a name=&quot;EngineeringTicketDescription%3A&quot;&gt;&lt;/a&gt;Engineering Ticket Description:&lt;/h3&gt;

&lt;p&gt;Sharding metadata refreshes have occasionally been demonstrated to cause throughput stalls. Currently, there is no visibility into when these are happening other than looking at the server log and trying to match them with FTDC data.&lt;/p&gt;

&lt;p&gt;In order to improve diagnosability we should introduce metadata refresh metrics to serverStatus so they can also be recorded in FTDC. All the proposed metrics should be under a section called &lt;tt&gt;shardingStatistics&lt;/tt&gt; and will behave like this:&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;&lt;b&gt;shardingStatistics&lt;/b&gt;
	&lt;ul&gt;
		&lt;li&gt;countStaleConfigErrors - Counts how many times threads hit stale config exception (which is what triggers metadata refreshes&lt;/li&gt;
		&lt;li&gt;countDonorMoveChunkStarted - Cumulative, always-increasing counter of how many chunks did this node start donating (whether they succeeded or not)&lt;/li&gt;
		&lt;li&gt;totalDonorMoveChunkTimeMillis - Cumulative, always-increasing counter of how much time the entire move chunk operation took (excluding range deletion)&lt;/li&gt;
		&lt;li&gt;totalDonorChunkCloneTimeMillis - Cumulative, always-increasing counter of how much time the clone phase took on the donor node, before it was appropriate to enter the critical section&lt;/li&gt;
		&lt;li&gt;totalCriticalSectionCommitTimeMillis - Cumulative, always-increasing counter of how much time the critical section&apos;s commit phase took (this is the period of time when all operations on the collection are blocked, not just the reads (from 3.6 onward))&lt;/li&gt;
		&lt;li&gt;totalCriticalSectionTimeMillis - Cumulative, always-increasing counter of how much time the entire critical section took. It includes the time the recipient took to fetch the latest modifications from the donor and persist them plus the critical section commit time. The value of &lt;tt&gt;totalCriticalSectionTimeMillis - totalCriticalSectionCommitTimeMillis&lt;/tt&gt; gives the duration of the catch-up phase of the critical section (where the last mods are transferred from the donor to the recipient).&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;


&lt;ul&gt;
	&lt;li&gt;&lt;b&gt;shardingStatistics.catalogCache&lt;/b&gt;
	&lt;ul&gt;
		&lt;li&gt;numDatabaseEntries - Tracks how many database entries in total are in currently the catalog cache&lt;/li&gt;
		&lt;li&gt;numCollectionEntries - Tracks how many collection entries (in total across all databases) are currently in the catalog cache&lt;/li&gt;
		&lt;li&gt;countStaleConfigErrors - Counts how many times threads hit stale config exception (which is what triggers metadata refreshes)&lt;/li&gt;
		&lt;li&gt;totalRefreshWaitTimeMicros - Cumulative, always-increasing counter of how much time threads waiting for refresh combined&lt;/li&gt;
		&lt;li&gt;numActiveIncrementalRefreshes - Tracks how many incremental refreshes are waiting to complete currently&lt;/li&gt;
		&lt;li&gt;countIncrementalRefreshesStarted - Cumulative, always-increasing counter of how many incremental refreshes have been kicked off&lt;/li&gt;
		&lt;li&gt;numActiveFullRefreshes - Tracks how many full refreshes are waiting to complete currently&lt;/li&gt;
		&lt;li&gt;countFullRefreshesStarted - Cumulative, always-increasing counter of how many full refreshes have been kicked off&lt;/li&gt;
		&lt;li&gt;countFailedRefreshes - Cumulative, always-increasing counter of how many full or incremental refreshes failed for whatever reason&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;


</description>
                <environment>&lt;a href=&quot;https://docs.mongodb.com/manual/reference/command/serverStatus/&quot;&gt;https://docs.mongodb.com/manual/reference/command/serverStatus/&lt;/a&gt;</environment>
        <key id="492319">DOCS-11282</key>
            <summary>Add sharding metadata refresh metrics section to serverStatus (SERVER-28670)</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="13201">Fixed</resolution>
                                        <assignee username="kay.kim@mongodb.com">Kay Kim</assignee>
                                    <reporter username="kay.kim@mongodb.com">Kay Kim</reporter>
                        <labels>
                            <label>add</label>
                    </labels>
                <created>Mon, 5 Feb 2018 03:41:11 +0000</created>
                <updated>Sun, 29 Oct 2023 13:58:25 +0000</updated>
                            <resolved>Wed, 6 Jun 2018 13:43:47 +0000</resolved>
                                                    <fixVersion>3.7.2</fixVersion>
                    <fixVersion>3.6.4</fixVersion>
                    <fixVersion>3.4.15</fixVersion>
                                    <component>manual</component>
                    <component>Server</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="1912309" author="xgen-internal-githook" created="Wed, 6 Jun 2018 13:47:56 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-11282&quot; title=&quot;Add sharding metadata refresh metrics section to serverStatus (SERVER-28670)&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-11282&quot;&gt;&lt;del&gt;DOCS-11282&lt;/del&gt;&lt;/a&gt;: shardingStatus&lt;br/&gt;
Branch: v3.4&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/c67c259793e5f8adaa2fc38f29bdf22cf1e0325e&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/c67c259793e5f8adaa2fc38f29bdf22cf1e0325e&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1912307" author="xgen-internal-githook" created="Wed, 6 Jun 2018 13:47:00 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-11282&quot; title=&quot;Add sharding metadata refresh metrics section to serverStatus (SERVER-28670)&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-11282&quot;&gt;&lt;del&gt;DOCS-11282&lt;/del&gt;&lt;/a&gt;: shardingStatus&lt;br/&gt;
Branch: v3.6&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/6b511cb548a709048df098654ca67d7e169e6e62&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/6b511cb548a709048df098654ca67d7e169e6e62&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1912298" author="xgen-internal-githook" created="Wed, 6 Jun 2018 13:42:37 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-11282&quot; title=&quot;Add sharding metadata refresh metrics section to serverStatus (SERVER-28670)&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-11282&quot;&gt;&lt;del&gt;DOCS-11282&lt;/del&gt;&lt;/a&gt;: shardingStatus&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/97ad9dc92733a87297ab887b08adb259a6e0e470&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/97ad9dc92733a87297ab887b08adb259a6e0e470&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10320">
                    <name>Documented</name>
                                            <outwardlinks description="documents">
                                        <issuelink>
            <issuekey id="371934">SERVER-28670</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Wed, 6 Jun 2018 13:42:37 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        5 years, 36 weeks ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCS-11003</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>luke.bonanomi@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            5 years, 36 weeks ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>xgen-internal-githook</customfieldvalue>
            <customfieldvalue>kay.kim@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|htpkyf:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hth3nz:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                    <customfield id="customfield_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="1324">KANBAN BUCKET</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                        <customfield id="customfield_10555" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.4</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|htp733:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>