replSetGetStatus_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 数据库命令 > 复制命令 > replSetGetStatus

在本页面

定义
句法
例
输出量

定义¶

replSetGetStatus¶

该replSetGetStatus命令从处理该命令的服务器的角度返回副本集的状态。 replSetGetStatus必须针对admin数据库运行。

该mongod实例必须是副本集成员 replSetGetStatus才能成功返回。

此命令提供的数据来自副本集的其他成员发送到服务器的心跳中包含的数据。由于心跳的频率，这些数据可能会过时几秒钟。

语法¶

该命令具有以下语法：

复制

db.adminCommand( { replSetGetStatus: 1 } )

从MongoDB 4.2.1开始

如果您在成员的初始同步（即状态）过程中对成员运行replSetGetStatus或运行mongoshell辅助程序，该命令将返回指标。rs.status()STARTUP2replSetGetStatus.initialSyncStatus

成员完成其初始同步并转换到另一个状态后，该replSetGetStatus.initialSyncStatus 指标将不再可用。
在早期版本（3.4.x-4.2.0）中
要返回初始同步状态信息，请在辅助成员或处于状态的成员上的命令中包括：initialSync: 1STARTUP2
复制
db.adminCommand( { replSetGetStatus: 1, initialSync: 1 } )
所述replSetGetStatus.initialSyncStatus的部件完成其初始同步之后度量仍然可用。也就是说，您可以在辅助成员上运行replSetGetStatus带有命令的命令，以返回其初始同步信息。initialSync: 1

您不能在 shell助手中指定。initialSync: 1mongors.status()

例子¶

主
次要的
包括初始同步指标

以下示例在主副本集replSetGetStatus 的管理数据库上运行命令：

复制

db.adminCommand( { replSetGetStatus : 1 } )

该命令为示例副本集primary返回以下输出：

复制

{
   "set" : "replset",
   "date" : ISODate("2019-12-04T04:49:18.693Z"),
   "myState" : 1,
   "term" : NumberLong(3),
   "syncingTo" : "",
   "syncSourceHost" : "",
   "syncSourceId" : -1,
   "heartbeatIntervalMillis" : NumberLong(2000),
   "majorityVoteCount" : 2,
   "writeMajorityCount" : 2,
   "optimes" : {
      "lastCommittedOpTime" : {
         "ts" : Timestamp(1575434954, 1),
         "t" : NumberLong(3)
      },
      "lastCommittedWallTime" : ISODate("2019-12-04T04:49:14.378Z"),
      "readConcernMajorityOpTime" : {
         "ts" : Timestamp(1575434954, 1),
         "t" : NumberLong(3)
      },
      "readConcernMajorityWallTime" : ISODate("2019-12-04T04:49:14.378Z"),
      "appliedOpTime" : {
         "ts" : Timestamp(1575434954, 1),
         "t" : NumberLong(3)
      },
      "durableOpTime" : {
         "ts" : Timestamp(1575434954, 1),
         "t" : NumberLong(3)
      },
      "lastAppliedWallTime" : ISODate("2019-12-04T04:49:14.378Z"),
      "lastDurableWallTime" : ISODate("2019-12-04T04:49:14.378Z")
   },
   "lastStableRecoveryTimestamp" : Timestamp(1575434935, 1),
   "lastStableCheckpointTimestamp" : Timestamp(1575434935, 1),
   "electionCandidateMetrics" : {
      "lastElectionReason" : "stepUpRequestSkipDryRun",
      "lastElectionDate" : ISODate("2019-12-04T04:49:04.085Z"),
      "electionTerm" : NumberLong(3),
      "lastCommittedOpTimeAtElection" : {
         "ts" : Timestamp(1575434935, 1),
         "t" : NumberLong(2)
      },
      "lastSeenOpTimeAtElection" : {
         "ts" : Timestamp(1575434935, 1),
         "t" : NumberLong(2)
      },
      "numVotesNeeded" : 2,
      "priorityAtElection" : 1,
      "electionTimeoutMillis" : NumberLong(10000),
      "priorPrimaryMemberId" : 1,
      "numCatchUpOps" : NumberLong(0),
      "newTermStartDate" : ISODate("2019-12-04T04:49:04.366Z"),
      "wMajorityWriteAvailabilityDate" : ISODate("2019-12-04T04:49:04.382Z")
   },
   "electionParticipantMetrics" : {
      "votedForCandidate" : true,
      "electionTerm" : NumberLong(2),
      "lastVoteDate" : ISODate("2019-12-04T04:16:54.398Z"),
      "electionCandidateMemberId" : 1,
      "voteReason" : "",
      "lastAppliedOpTimeAtElection" : {
         "ts" : Timestamp(1575433013, 1),
         "t" : NumberLong(1)
      },
      "maxAppliedOpTimeInSet" : {
         "ts" : Timestamp(1575433013, 1),
         "t" : NumberLong(1)
      },
      "priorityAtElection" : 1
   },
   "members" : [
      {
         "_id" : 0,
         "name" : "m1.example.net:27017",
         "ip" : "198.51.100.1",
         "health" : 1,
         "state" : 1,
         "stateStr" : "PRIMARY",
         "uptime" : 2019,
         "optime" : {
            "ts" : Timestamp(1575434954, 1),
            "t" : NumberLong(3)
         },
         "optimeDate" : ISODate("2019-12-04T04:49:14Z"),
         "syncingTo" : "",
         "syncSourceHost" : "",
         "syncSourceId" : -1,
         "infoMessage" : "",
         "electionTime" : Timestamp(1575434944, 1),
         "electionDate" : ISODate("2019-12-04T04:49:04Z"),
         "configVersion" : 1,
         "self" : true,
         "lastHeartbeatMessage" : ""
      },
      {
         "_id" : 1,
         "name" : "m2.example.net:27017",
         "ip" : "198.51.100.2",
         "health" : 1,
         "state" : 2,
         "stateStr" : "SECONDARY",
         "uptime" : 2016,
         "optime" : {
            "ts" : Timestamp(1575434954, 1),
            "t" : NumberLong(3)
         },
         "optimeDurable" : {
            "ts" : Timestamp(1575434954, 1),
            "t" : NumberLong(3)
         },
         "optimeDate" : ISODate("2019-12-04T04:49:14Z"),
         "optimeDurableDate" : ISODate("2019-12-04T04:49:14Z"),
         "lastHeartbeat" : ISODate("2019-12-04T04:49:18.138Z"),
         "lastHeartbeatRecv" : ISODate("2019-12-04T04:49:18.460Z"),
         "pingMs" : NumberLong(0),
         "lastHeartbeatMessage" : "",
         "syncingTo" : "m1.example.net:27017",
         "syncSourceHost" : "m1.example.net:27017",
         "syncSourceId" : 0,
         "infoMessage" : "",
         "configVersion" : 1
      },
      {
         "_id" : 2,
         "name" : "m3.example.net:27017",
         "ip" : "198.51.100.3",
         "health" : 1,
         "state" : 2,
         "stateStr" : "SECONDARY",
         "uptime" : 2016,
         "optime" : {
            "ts" : Timestamp(1575434954, 1),
            "t" : NumberLong(3)
         },
         "optimeDurable" : {
            "ts" : Timestamp(1575434954, 1),
            "t" : NumberLong(3)
         },
         "optimeDate" : ISODate("2019-12-04T04:49:14Z"),
         "optimeDurableDate" : ISODate("2019-12-04T04:49:14Z"),
         "lastHeartbeat" : ISODate("2019-12-04T04:49:18.138Z"),
         "lastHeartbeatRecv" : ISODate("2019-12-04T04:49:17.739Z"),
         "pingMs" : NumberLong(0),
         "lastHeartbeatMessage" : "",
         "syncingTo" : "m1.example.net:27017",
         "syncSourceHost" : "m1.example.net:27017",
         "syncSourceId" : 0,
         "infoMessage" : "",
         "configVersion" : 1
      }
   ],
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : Timestamp(1575434954, 1),
      "signature" : {
         "hash" : BinData(0,"Dz4WAzT3KpB5XHXwy3MgcjL3M8Q="),
         "keyId" : NumberLong("6766433010175705091")
      }
   },
   "operationTime" : Timestamp(1575434954, 1)
}

以下示例在辅助副本集replSetGetStatus 的管理数据库上运行命令。

复制

db.adminCommand( { replSetGetStatus : 1 } )

该命令为示例副本集secondary返回以下输出：

复制

{
   "set" : "replset",
   "date" : ISODate("2019-12-04T04:57:46.651Z"),
   "myState" : 2,
   "term" : NumberLong(3),
   "syncingTo" : "m3.example.net:27017",
   "syncSourceHost" : "m3.example.net:27017",
   "syncSourceId" : 2,
   "heartbeatIntervalMillis" : NumberLong(2000),
   "majorityVoteCount" : 2,
   "writeMajorityCount" : 2,
   "optimes" : {
      "lastCommittedOpTime" : {
         "ts" : Timestamp(1575435464, 1),
         "t" : NumberLong(3)
      },
      "lastCommittedWallTime" : ISODate("2019-12-04T04:57:44.571Z"),
      "readConcernMajorityOpTime" : {
         "ts" : Timestamp(1575435464, 1),
         "t" : NumberLong(3)
      },
      "readConcernMajorityWallTime" : ISODate("2019-12-04T04:57:44.571Z"),
      "appliedOpTime" : {
         "ts" : Timestamp(1575435464, 1),
         "t" : NumberLong(3)
      },
      "durableOpTime" : {
         "ts" : Timestamp(1575435464, 1),
         "t" : NumberLong(3)
      },
      "lastAppliedWallTime" : ISODate("2019-12-04T04:57:44.571Z"),
      "lastDurableWallTime" : ISODate("2019-12-04T04:57:44.571Z")
   },
   "lastStableRecoveryTimestamp" : Timestamp(1575435414, 1),
   "lastStableCheckpointTimestamp" : Timestamp(1575435414, 1),
   "electionParticipantMetrics" : {
      "votedForCandidate" : true,
      "electionTerm" : NumberLong(3),
      "lastVoteDate" : ISODate("2019-12-04T04:49:04.109Z"),
      "electionCandidateMemberId" : 0,
      "voteReason" : "",
      "lastAppliedOpTimeAtElection" : {
         "ts" : Timestamp(1575434935, 1),
         "t" : NumberLong(2)
      },
      "maxAppliedOpTimeInSet" : {
         "ts" : Timestamp(1575434935, 1),
         "t" : NumberLong(2)
      },
      "priorityAtElection" : 1,
      "newTermStartDate" : ISODate("2019-12-04T04:49:04.366Z"),
      "newTermAppliedDate" : ISODate("2019-12-04T04:49:06.225Z")
   },
   "members" : [
      {
         "_id" : 0,
         "name" : "m1.example.net:27017",
         "ip" : "198.51.100.1",
         "health" : 1,
         "state" : 1,
         "stateStr" : "PRIMARY",
         "uptime" : 2523,
         "optime" : {
            "ts" : Timestamp(1575435464, 1),
            "t" : NumberLong(3)
         },
         "optimeDurable" : {
            "ts" : Timestamp(1575435464, 1),
            "t" : NumberLong(3)
         },
         "optimeDate" : ISODate("2019-12-04T04:57:44Z"),
         "optimeDurableDate" : ISODate("2019-12-04T04:57:44Z"),
         "lastHeartbeat" : ISODate("2019-12-04T04:57:45.261Z"),
         "lastHeartbeatRecv" : ISODate("2019-12-04T04:57:44.897Z"),
         "pingMs" : NumberLong(0),
         "lastHeartbeatMessage" : "",
         "syncingTo" : "",
         "syncSourceHost" : "",
         "syncSourceId" : -1,
         "infoMessage" : "",
         "electionTime" : Timestamp(1575434944, 1),
         "electionDate" : ISODate("2019-12-04T04:49:04Z"),
         "configVersion" : 1
      },
      {
         "_id" : 1,
         "name" : "m2.example.net:27017",
         "ip" : "198.51.100.2",
         "health" : 1,
         "state" : 2,
         "stateStr" : "SECONDARY",
         "uptime" : 2526,
         "optime" : {
            "ts" : Timestamp(1575435464, 1),
            "t" : NumberLong(3)
         },
         "optimeDate" : ISODate("2019-12-04T04:57:44Z"),
         "syncingTo" : "m3.example.net:27017",
         "syncSourceHost" : "m3.example.net:27017",
         "syncSourceId" : 2,
         "infoMessage" : "",
         "configVersion" : 1,
         "self" : true,
         "lastHeartbeatMessage" : ""
      },
      {
         "_id" : 2,
         "name" : "m3.example.net:27017",
         "ip" : "198.51.100.3",
         "health" : 1,
         "state" : 2,
         "stateStr" : "SECONDARY",
         "uptime" : 2523,
         "optime" : {
            "ts" : Timestamp(1575435464, 1),
            "t" : NumberLong(3)
         },
         "optimeDurable" : {
            "ts" : Timestamp(1575435464, 1),
            "t" : NumberLong(3)
         },
         "optimeDate" : ISODate("2019-12-04T04:57:44Z"),
         "optimeDurableDate" : ISODate("2019-12-04T04:57:44Z"),
         "lastHeartbeat" : ISODate("2019-12-04T04:57:45.261Z"),
         "lastHeartbeatRecv" : ISODate("2019-12-04T04:57:46.556Z"),
         "pingMs" : NumberLong(0),
         "lastHeartbeatMessage" : "",
         "syncingTo" : "m1.example.net:27017",
         "syncSourceHost" : "m1.example.net:27017",
         "syncSourceId" : 0,
         "infoMessage" : "",
         "configVersion" : 1
      }
   ],
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : Timestamp(1575435464, 1),
      "signature" : {
         "hash" : BinData(0,"dPsDL+hY+sY6jSvrmrriJdQOeaA="),
         "keyId" : NumberLong("6766433010175705091")
      }
   },
   "operationTime" : Timestamp(1575435464, 1)
}

在早期版本（3.4.x-4.2.0）中

您可以包括可选参数以在输出中包含。（如果您不想返回初始同步状态，则可以省略）：initialSync: 1replSetGetStatus.initialSyncStatus

复制

db.adminCommand( { replSetGetStatus : 1, initialSync: 1} )

从MongoDB 4.2.1开始，

如果您replSetGetStatus在成员的初始同步期间运行它，则该命令将返回 replSetGetStatus.initialSyncStatus指标。

复制

db.adminCommand( { replSetGetStatus : 1} )

成员完成其初始同步并转换到另一个状态后，该replSetGetStatus.initialSyncStatus 指标将不再可用。

在早期版本（3.4.x-4.2.0）中

您可以包括可选参数以在输出中包含。（如果您不想返回初始同步状态，则可以省略）：initialSync: 1replSetGetStatus.initialSyncStatus

复制

db.adminCommand( { replSetGetStatus : 1, initialSync: 1} )

对于3.4.x-4.2.0副本集， replSetGetStatus.initialSyncStatus指标在成员完成其初始同步后仍然可用。也就是说，您可以在辅助成员上运行replSetGetStatus 带有命令的命令，以返回其初始同步信息。initialSync: 1

以下示例在其初始同步期间在4.2.1副本集成员replSetGetStatus 的admin数据库上运行命令：

复制