<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:24:04 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>[DRIVERS-1814] Document errorLabels option for failCommand fail point</title>
                <link>https://jira.mongodb.org/browse/DRIVERS-1814</link>
                <project id="10980" key="DRIVERS">Drivers</project>
                    <description>&lt;p&gt;According to &lt;a href=&quot;https://github.com/mongodb/mongo/wiki/The-%22failCommand%22-fail-point&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo/wiki/The-%22failCommand%22-fail-point&lt;/a&gt;, the &lt;tt&gt;errorLabels&lt;/tt&gt; option was introduced in 4.3.1 by &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-43941&quot; title=&quot;Add &amp;quot;errorLabels&amp;quot; field to failCommand fail point&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-43941&quot;&gt;&lt;del&gt;SERVER-43941&lt;/del&gt;&lt;/a&gt; and never backported. The option currently used in one UTF test in &lt;a href=&quot;https://github.com/mongodb/specifications/blob/72249aad5068f9a4d24930e723e90d92bb82b6cb/source/unified-test-format/tests/valid-pass/poc-retryable-writes.yml#L134&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;poc-retryable-writes.yml&lt;/a&gt; but the runOnRequirements permit that test to run on 4.0+ servers. The fact that the test passes suggests that &lt;tt&gt;configureFailPoint&lt;/tt&gt; does not strictly validate &lt;tt&gt;data&lt;/tt&gt; options like arguments for other server commands and may be ignoring unsupported values.&lt;/p&gt;

&lt;p&gt;In any event, we should document the option in the UTF spec. The test can likely remain as-is, since &lt;tt&gt;errorLabels&lt;/tt&gt; may only be necessary to ensure the label is added for 4.4+ servers where drivers won&apos;t add the label on their own based on an error code.&lt;/p&gt;

&lt;p&gt;This came up in &lt;a href=&quot;https://github.com/mongodb/specifications/pull/1024#discussion_r655623379&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;mongodb/specifications#1024&lt;/a&gt; for DRIVERS-1483.&lt;/p&gt;</description>
                <environment></environment>
        <key id="1791749">DRIVERS-1814</key>
            <summary>Document errorLabels option for failCommand fail point</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</priority>
                        <status id="10038" iconUrl="https://jira.mongodb.org/images/icons/subtask.gif" description="">Backlog</status>
                    <statusCategory id="2" key="new" colorName="default"/>
                                    <resolution id="-1">Unresolved</resolution>
                                        <assignee username="-1">Unassigned</assignee>
                                    <reporter username="jmikola@mongodb.com">Jeremy Mikola</reporter>
                        <labels>
                    </labels>
                <created>Mon, 21 Jun 2021 18:51:11 +0000</created>
                <updated>Thu, 31 Mar 2022 13:47:57 +0000</updated>
                                                                <component>Unified Test Runner</component>
                                        <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="3889577" author="jmikola@gmail.com" created="Mon, 21 Jun 2021 18:56:56 +0000"  >&lt;p&gt;Note: while working on this issue, we should also update the docs for &lt;tt&gt;appName&lt;/tt&gt; to note that it was backported to 4.2.9 (&lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-47195&quot; title=&quot;Allow failCommand failpoint to trigger only on a specific MongoClient&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-47195&quot;&gt;&lt;del&gt;SERVER-47195&lt;/del&gt;&lt;/a&gt;). The UTF spec currently refers to 4.4.0-rc2. Likewise for the &lt;tt&gt;blockConnection&lt;/tt&gt; and &lt;tt&gt;blockTimeMS&lt;/tt&gt; options (&lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-41070&quot; title=&quot;Add blockConnection mode to failCommand&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-41070&quot;&gt;&lt;del&gt;SERVER-41070&lt;/del&gt;&lt;/a&gt;).&lt;/p&gt;</comment>
                            <comment id="3889566" author="jmikola@gmail.com" created="Mon, 21 Jun 2021 18:53:05 +0000"  >&lt;blockquote&gt;&lt;p&gt;The fact that the test passes suggests that configureFailPoint does not strictly validate data options like arguments for other server commands and may be ignoring unsupported values.&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=lingzhi.deng&quot; class=&quot;user-hover&quot; rel=&quot;lingzhi.deng&quot;&gt;lingzhi.deng&lt;/a&gt;: Since you worked on &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-43941&quot; title=&quot;Add &amp;quot;errorLabels&amp;quot; field to failCommand fail point&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-43941&quot;&gt;&lt;del&gt;SERVER-43941&lt;/del&gt;&lt;/a&gt;, can you confirm that the server does indeed ignore unrecognized options in the &lt;tt&gt;data&lt;/tt&gt; field for the &lt;tt&gt;failCommand&lt;/tt&gt; fail point (and possibly others)?&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="966691">SERVER-43941</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                            <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                    <customfield id="customfield_10951" key="com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons">
                        <customfieldname>Driver Changes</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10940"><![CDATA[Not Needed]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hz85iv:</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>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        </customfields>
    </item>
</channel>
</rss>