<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 09:02:52 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>[JAVA-4752] Easier debugging with standardized logging: logging specification</title>
                <link>https://jira.mongodb.org/browse/JAVA-4752</link>
                <project id="10006" key="JAVA">Java Driver</project>
                    <description>&lt;p&gt;This ticket was split from &lt;tt&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/DRIVERS-1677&quot; title=&quot;Easier debugging with standardized logging: logging specification&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DRIVERS-1677&quot;&gt;DRIVERS-1677&lt;/a&gt;&lt;/tt&gt;, please see that ticket for a detailed description. &lt;/p&gt;</description>
                <environment></environment>
        <key id="2154378">JAVA-4752</key>
            <summary>Easier debugging with standardized logging: logging specification</summary>
                <type id="2" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14711&amp;avatarType=issuetype">New Feature</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="jeff.yemin@mongodb.com">Jeffrey Yemin</assignee>
                                    <reporter username="dbeng-pm-bot">PM Bot</reporter>
                        <labels>
                    </labels>
                <created>Fri, 7 Oct 2022 15:07:02 +0000</created>
                <updated>Sat, 28 Oct 2023 11:20:34 +0000</updated>
                            <resolved>Thu, 26 Jan 2023 23:15:37 +0000</resolved>
                                                    <fixVersion>4.9.0</fixVersion>
                                    <component>Logging</component>
                                        <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="5144706" author="xgen-internal-githook" created="Thu, 26 Jan 2023 23:15:00 +0000"  >&lt;p&gt;Author: &lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Add structured logging support for command logging&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;Align command logging messages to specification&lt;/li&gt;
	&lt;li&gt;Add command logging unified tests&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-4752&quot; title=&quot;Easier debugging with standardized logging: logging specification&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-4752&quot;&gt;&lt;del&gt;JAVA-4752&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-4753&quot; title=&quot;Add log messages to Command monitoring spec&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-4753&quot;&gt;&lt;del&gt;JAVA-4753&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/2fcd9435df60f131d22ba8b8e9d4d4bb7703fe1e&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/2fcd9435df60f131d22ba8b8e9d4d4bb7703fe1e&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="5144704" author="xgen-internal-githook" created="Thu, 26 Jan 2023 23:14:56 +0000"  >&lt;p&gt;Author: &lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Add isMonitoringConnection boolean to InternalStreamConnection&lt;/p&gt;

&lt;p&gt;This will let us ignore messages (for purposes of log message/event generation)&lt;br/&gt;
for monitoring connections&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-4752&quot; title=&quot;Easier debugging with standardized logging: logging specification&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-4752&quot;&gt;&lt;del&gt;JAVA-4752&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-4753&quot; title=&quot;Add log messages to Command monitoring spec&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-4753&quot;&gt;&lt;del&gt;JAVA-4753&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/fcaf87c0f7399468207fce7d5105eb403a93a0ad&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/fcaf87c0f7399468207fce7d5105eb403a93a0ad&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>Duplicate</name>
                                                                <inwardlinks description="is duplicated by">
                                        <issuelink>
            <issuekey id="2233313">JAVA-4840</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="2208541">JAVA-4829</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10620">
                    <name>Issue split</name>
                                                                <inwardlinks description="split from">
                                        <issuelink>
            <issuekey id="1327204">DRIVERS-1677</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="1979389">JAVA-4486</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons">
                        <customfieldname>Backwards Compatibility</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10038"><![CDATA[Fully Compatible]]></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_10257" key="com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons">
                        <customfieldname>Documentation Changes</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="11861"><![CDATA[Not Needed]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                        <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>JAVA-4485</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_21553" key="com.atlassian.jira.plugin.system.customfieldtypes:labels">
                        <customfieldname>Quarter</customfieldname>
                        <customfieldvalues>
                                        <label>FY23Q4</label>
            <label>FY24Q1</label>
    
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hr3mmh:0400000946ij900k</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_21457" key="com.atlassian.jira.plugin.system.customfieldtypes:textarea">
                        <customfieldname>Upstream Changes Summary</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/DRIVERS-1677&quot; title=&quot;Easier debugging with standardized logging: logging specification&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DRIVERS-1677&quot;&gt;DRIVERS-1677&lt;/a&gt;:&lt;br/&gt;
I suggest that drivers do their implementation of this ticket in tandem with their implementation of &lt;a href=&quot;https://jira.mongodb.org/browse/DRIVERS-1673&quot; title=&quot;Add log messages to Command monitoring spec&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DRIVERS-1673&quot;&gt;DRIVERS-1673&lt;/a&gt; which adds command log messages. This way the driver will have actual log messages to emit and test and can confirm that their logging implementation and test code works as expected.&lt;/p&gt;

&lt;p&gt;The logging spec can be found &lt;a href=&quot;https://github.com/mongodb/specifications/blob/master/source/logging/logging.rst&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;here&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;The unified test format changes can be found &lt;a href=&quot;https://github.com/mongodb/specifications/blob/master/source/logging/logging.rst&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;here&lt;/a&gt;. To summarize:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;Client entities may now have a new &lt;tt&gt;observeLogMessages&lt;/tt&gt; property specifying logging configuration for the client&lt;/li&gt;
	&lt;li&gt;Tests may now have a new &lt;tt&gt;expectLogMessages&lt;/tt&gt; property specifying expected log messages to be produced during the test&lt;/li&gt;
	&lt;li&gt;Two new special matching operators &lt;tt&gt;$$matchAsRoot&lt;/tt&gt; and &lt;tt&gt;$$matchAsDocument&lt;/tt&gt; have been added to enable logging assertions.&lt;br/&gt;
&#160;&lt;/li&gt;
&lt;/ul&gt;
</customfieldvalue>

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