[DOCS-10757] Document MongoDB error codes Created: 05/Sep/17  Updated: 06/Dec/23  Resolved: 15/Nov/23

Status: Closed
Project: Documentation
Component/s: Server
Affects Version/s: 4.0 Core Server
Fix Version/s: Server_Docs_20231120

Type: Task Priority: Critical - P2
Reporter: Kevin Burke Assignee: Caleb Thompson
Resolution: Done Votes: 12
Labels: query, security, server-docs-bug-bash, snp
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
is depended on by GODRIVER-2116 Add MongoDB Error Codes as Constants Investigating
Related
related to CDRIVER-4126 Link to server-side error codes is ou... Backlog
Participants:
Days since reply: 12 weeks ago

 Description   

Using the github.com/go-mgo/mgo driver and the latest stable version of MongoDB, I observe the following error:

&QueryError

{ Code: 17406, Message: "getMore executor error: CappedPositionLost: CollectionScan died due to failure to restore tailable cursor position. Last seen record id: RecordId(200138)", Assertion: false, }

I cannot find information about error code 17406 anywhere. More broadly, I cannot find information about MongoDB error codes. This page contains a list of codes: https://github.com/mongodb/mongo/blob/master/src/mongo/base/error_codes.err. However, the highest error code in the file is 13000.

This page contains exit codes: https://docs.mongodb.com/manual/reference/exit-codes/ However, the highest code provided is code 100.

Searching Google for 'mongodb error codes' yields the following Google Groups thread: https://groups.google.com/forum/#!topic/mongodb-user/cKV3rJVRfqEhttps://groups.google.com/forum/#!topic/mongodb-user/cKV3rJVRfqE. One of the links (https://github.com/mongodb/mongo/blob/master/docs/errors.md) returns a page not found.

A list of PostgreSQL error codes is the top result when searching for "Postgres error codes" and can be found here: https://www.postgresql.org/docs/9.6/static/errcodes-appendix.html

A list of MySQL error codes is the top result when searching for "MySQL error codes" and can be found here: https://dev.mysql.com/doc/refman/5.5/en/error-messages-server.html

I am curious if a similar list exists for MongoDB. I attempted to ask a question about this on StackOverflow, however it will probably be closed by the time you read this.

https://stackoverflow.com/q/46064684/329700



 Comments   
Comment by Caleb Thompson [ 15/Nov/23 ]

Merged into v7.0. https://github.com/10gen/docs-mongodb-internal/pull/3820 to merge into master.

Comment by Nic Cottrell [ 14/Nov/23 ]

Reviewed and approved via Github. Thanks all!

Comment by Caleb Thompson [ 10/Nov/23 ]

Asking nicholas.cottrell@mongodb.com for tech review on this.

Comment by Caleb Thompson [ 12/Jul/23 ]

https://github.com/10gen/docs-mongodb-internal/pull/3820

Comment by Sarah Olson [ 24/Mar/23 ]

I'm putting this into Ready for Work, for the following reasons:

  • There are three customer cases associated with this ticket.
  • There is significant interest based on watchers.
  • We have resources available in Nic's comment above.
Comment by Nic Cottrell [ 21/Jan/21 ]

There's a bunch of base error codes available at https://github.com/mongodb/mongo/blob/34228dcee8b2961fb3f5d84e726210d6faf2ef4f/src/mongo/base/error_codes.yml 

And WiredTiger errors: https://github.com/mongodb/mongo/blob/19579e36f0d5a3905fb8b0101f43a776b3ac1944/src/third_party/wiredtiger/src/docs/error-handling.dox 

Comment by Christian Kütbach [ 01/Sep/20 ]

Are there any plans to create a documenation for developers, which errors could occour?

Comment by Andrew Zammit [ 24/Dec/18 ]

I agree this should be documented in the open. Hang on, wait... it was!

SERVER-16197 removed the generated error.md file which was available prior to v2.8.0: https://github.com/mongodb/mongo/blob/35079a95ebc591dee47ecca5e0f22eb7a7381fd0/docs/errors.md

In here, you can see error code 17406 corresponds to "getMore runner error" during plan execution. This error code is present in server versions less than or equal to v3.6.3; it was removed in v3.6.4.

Aside: Thanks to MongoDB for keeping JIRA and the source code open! Gold star for you! 

Generated at Thu Feb 08 08:01:18 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.