<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:50:17 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-5426] Reduce ambiguity between per-DB and instance-wide profiling</title>
                <link>https://jira.mongodb.org/browse/DOCS-5426</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;I understand now that&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;The mongod process ensures instance-wide profiling by using the &lt;em&gt;&amp;#45;&amp;#45;profile&lt;/em&gt; command line argument or &lt;em&gt;operationProfiling.mode&lt;/em&gt; config file setting and&lt;/li&gt;
	&lt;li&gt;The &lt;em&gt;db.setProfilingLevel()&lt;/em&gt; command only affects a single database&lt;/li&gt;
&lt;/ol&gt;


&lt;p&gt;but when I read &lt;a href=&quot;http://docs.mongodb.org/manual/reference/configuration-options/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.mongodb.org/manual/reference/configuration-options/&lt;/a&gt; earlier I skipped to certain sections and the behaviour was ambiguous for a while&lt;/p&gt;

&lt;p&gt;At the top of the page you might read this:&lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;You can enable profiling on a per-database or per-instance basis. &lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;but then if you take the link to subsection &quot;Enable Database Profiling and Set the Profiling Level&quot; you will see the db-specific version only. At this stage if you don&apos;t know that the instance-wide profiling can only enabled with a startup option it&apos;s hard to figure out whether the &lt;em&gt;db.setProfiling()&lt;/em&gt; command is talking about database-level or instance-level. I know it says &quot;Database profiling&quot; but the distinction between a single db namespace and a whole database server is routinely ignored in database manuals.&lt;/p&gt;

&lt;p&gt;In short, after arriving on page and both reading the summary at the top and then jumping to the section that looks relevant it was confusing whether the command was for one db or instance-wide.&lt;/p&gt;

&lt;p&gt;One idea I suggestion I have is to change:&lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;You can enable profiling on a per-database or per-instance basis.&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;to&lt;/p&gt;

&lt;p&gt;&quot;You can enable or disable profiling on per-database basis by using the db.setProfilingLevel command, or you can force it to be on for all databases in a mongod instance by using a startup option.&quot;&lt;/p&gt;</description>
                <environment></environment>
        <key id="203784">DOCS-5426</key>
            <summary>Reduce ambiguity between per-DB and instance-wide profiling</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</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="9">Done</resolution>
                                        <assignee username="kay.kim@mongodb.com">Kay Kim</assignee>
                                    <reporter username="akira.kurogane">Akira Kurogane</reporter>
                        <labels>
                    </labels>
                <created>Wed, 13 May 2015 05:51:54 +0000</created>
                <updated>Mon, 30 Oct 2023 22:29:18 +0000</updated>
                            <resolved>Thu, 18 Jan 2018 02:51:48 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="1777405" author="akira.kurogane" created="Thu, 18 Jan 2018 02:51:40 +0000"  >&lt;p&gt;I see the content has moved around since I created this ticket. I will close as &apos;Fixed&apos;.&lt;/p&gt;</comment>
                            <comment id="913725" author="akira.kurogane" created="Thu, 14 May 2015 05:07:20 +0000"  >&lt;p&gt;And a third request:&lt;/p&gt;

&lt;p&gt;The documentation is clear about whether setting slowms is instance-wide or database-specific.&lt;/p&gt;

&lt;blockquote&gt;
&lt;h3&gt;&lt;a name=&quot;SpecifytheThresholdforSlowOperations&quot;&gt;&lt;/a&gt;Specify the Threshold for Slow Operations&lt;/h3&gt;

&lt;p&gt;The threshold for slow operations applies to the entire mongod instance. When you change the threshold, you change it for all databases on the instance.&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;But just so it&apos;s easier to find it could &quot;slowms&quot; be worked into that paragraph? E.g.&lt;/p&gt;

&lt;p&gt;&quot;When you change the &amp;lt;tt class=&apos;literal&apos;&amp;gt;slowms&amp;lt;/tt&amp;gt; threshold value, you change ....&quot;&lt;/p&gt;

&lt;p&gt;That way it wont be missed by people grep&apos;ing their way through the page. Also Google is more likely to show that as the link preview content when you do a search for &quot;mongodb slowms per-database&quot; or something like that.&lt;/p&gt;</comment>
                            <comment id="912473" author="akira.kurogane" created="Wed, 13 May 2015 05:59:39 +0000"  >&lt;p&gt;Also one extra note:&lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;For example, to enable profiling for all database operations, consider the following operation in the mongo shell:&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;May I suggest changing it to: &quot;For example, to enable profiling for all operations in a database, consider ...&quot;. Once again this would just be to avoid misleading readers into thinking &lt;em&gt;db.setProfilingLevel()&lt;/em&gt; is for all dbs.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                                                <inwardlinks description="is related to">
                                                        </inwardlinks>
                                    </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_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        6 years, 4 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_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>emet.ozar@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            6 years, 4 weeks ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>akira.kurogane</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|hrqca7:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hsnflr:</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_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|hryo9b:</customfieldvalue>

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