Add db.serverStatus()

Author: aherlihy

packages/i18n/src/locales/en_US.js

@@ -966,6 +966,11 @@ const translations = {
               description: 'returns the db serverBuildInfo. uses the buildInfo command',
               example: 'db.serverBuildInfo()',
             },
+            serverStatus: {
+              link: 'https://docs.mongodb.com/manual/reference/method/db.serverStatus',
+              description: 'returns the server stats. uses the serverStatus command',
+              example: 'db.serverStatus(<opts>)',
+            },
             stats: {
               link: 'https://docs.mongodb.com/manual/reference/method/db.stats',
               description: 'returns the db stats. uses the dbStats command',

packages/shell-api/src/database.spec.ts

@@ -1602,6 +1602,44 @@ describe('Database', () => {
       });
     });
 
+    describe('serverStatus', () => {
+      it('calls serviceProvider.runCommand on the database with options', async() => {
+        await database.serverStatus({ repl: 0, metrics: 0, locks: 0 });
+
+        expect(serviceProvider.runCommand).to.have.been.calledWith(
+          ADMIN_DB,
+          {
+            serverStatus: 1, repl: 0, metrics: 0, locks: 0
+          }
+        );
+      });
+      it('calls serviceProvider.runCommand on the database without options', async() => {
+        await database.serverStatus();
+
+        expect(serviceProvider.runCommand).to.have.been.calledWith(
+          ADMIN_DB,
+          {
+            serverStatus: 1
+          }
+        );
+      });
+
+      it('returns whatever serviceProvider.runCommand returns', async() => {
+        const expectedResult = { ok: 1 };
+        serviceProvider.runCommand.resolves(expectedResult);
+        const result = await database.serverStatus();
+        expect(result).to.deep.equal(expectedResult);
+      });
+
+      it('throws if serviceProvider.runCommand rejects', async() => {
+        const expectedError = new Error();
+        serviceProvider.runCommand.rejects(expectedError);
+        const catchedError = await database.serverStatus()
+          .catch(e => e);
+        expect(catchedError).to.equal(expectedError);
+      });
+    });
+
     describe('hostInfo', () => {
       it('calls serviceProvider.runCommand on the database with options', async() => {
         await database.hostInfo();

packages/shell-api/src/database.ts

@@ -688,6 +688,21 @@ export default class Database extends ShellApiClass {
     return result;
   }
 
+  @returnsPromise
+  async serverStatus(opts = {}): Promise<any> {
+    this._emitDatabaseApiCall('serverStatus', { options: opts });
+    const result = await this._mongo._serviceProvider.runCommand(
+      ADMIN_DB,
+      {
+        serverStatus: 1, ...opts
+      }
+    );
+    if (!result || !result.ok) {
+      throw new MongoshRuntimeError(`Error running command serverStatus ${result ? result.errmsg || '' : ''}`);
+    }
+    return result;
+  }
+
   @returnsPromise
   async stats(scale: any): Promise<any> {
     assertArgsDefined(scale);