Navigation
This version of the documentation is archived and no longer supported. To learn how to upgrade your version of MongoDB Ops Manager, refer to the upgrade documentation.
You were redirected from a different version of the documentation. Click here to go back.

Get Host by Hostname and Port

Get a single MongoDB process by its hostname and port combination. You can specify either the primary hostname or an alias.

Base URL: {opsManagerHost}:{port}

Resource

GET /api/public/v1.0/groups/{GROUP-ID}/hosts/byName/{HOSTNAME}:{PORT}

Request Path Parameters

Parameter Required/Optional Description
GROUP-ID Required ID of the group that owns this MongoDB process.
HOSTNAME Required The primary hostname Ops Manager should use to connect to this MongoDB instance.
PORT Required Port on which the MongoDB process listens.

Request Query Parameters

This endpoint does not use HTTP request query parameters.

Request Body Parameters

This endpoint does not use HTTP request body parameters.

Response Elements

Name Type Description
aliases array of strings A list of alternate hostname:port combinations that Ops Manager discovered for the MongoDB process.
alertsEnabled boolean true if this MongoDB process has alerts enabled.
authMechanismName string

The authentication mechanism used to connect to this MongoDB process. This displays only one of the following values:

  • MONGODB_CR (deprecated)
  • SCRAM_SHA_1
  • GSSAPI
  • PLAIN
  • MONGODB_X509
  • NONE
clusterId string The ID of the cluster to which the MongoDB process belongs.
created date Date Ops Manager created or first discovered this MongoDB process.
deactivated boolean false if the host is running; true if the host is deactivated.
displayName string The MongoDB process’s display name in Ops Manager. If the MongoDB process does not have a display name set, Ops Manager displays the hostname.
groupId string ID of the group that owns this alert configuration.
hasStartupWarnings boolean true if this MongoDB process had startup warnings.
hidden boolean true if host is displayed in the Ops Manager UI. Hosts set to true are omitted from API responses.
hostEnabled boolean true if the MongoDB process currently enabled.
hostname string The primary hostname as Ops Manager can best determine.
id string Unique identifier.
ipAddress string IP address associated with the hostname of this MongoDB process. Additional accessible IP addresses may be displayed in the aliases array.
journalingEnabled boolean true if journaling is enabled for this MongoDB process.
lastDataSizeBytes number The uncompressed size of the host’s databases on disk in bytes excluding indexes. lastDataSizeBytes does not include the data in the local database.
lastIndexSizeBytes number The uncompressed size of the host’s database indexes on disk in bytes. This number does not include the size of the index for the local database.
lastPing date The point in time when the last ping for this MongoDB process was received in ISO 8601 date and time format in UTC.
lastRestart date The point in time when this process last restarted in ISO 8601 date and time format in UTC. If the MongoDB process has never been restarted, the lastRestart field is omitted.
links array This array includes one or more links to sub-resources and/or related resources. The relations between URLs are explained in the Web Linking Specification. At minimum, a links array contains one link called self.
logsEnabled boolean true if Ops Manager is collecting logs for this MongoDB process.
lowUlimit boolean true if this MongoDB process’s host has a low ulimit setting.
muninEnabled boolean

true if Munin is used to collect hardware statistics for this MongoDB process.

Note

Use of Munin for hardware monitoring is deprecated. For more information on Munin and Ops Manager, see Configure Hardware Monitoring with munin-node.

muninPort number

Port number Munin uses to collect hardware statistics for this MongoDB process.

Note

Use of Munin for hardware monitoring is deprecated. For more information on Munin and Ops Manager, see Configure Hardware Monitoring with munin-node.

port number Port on which the MongoDB process listens.
profilerEnabled boolean true if Ops Manager collects profile information from this MongoDB process.
replicaSetName string Name of the replica set this process belongs to. Only present if this process is part of a replica set.
replicaStateName string Current state of this MongoDB process within a replica set. Only present if this process is part of a replica set. See Replica Set Member States for possible values.
shardName string Name of the shard this process belongs to. Only present if the process is part of a sharded cluster.
sslEnabled boolean true if SSL/TLS and is enabled for this MongoDB process.
typeName string

Type for this MongoDB process. Possible values are:

  • STANDALONE
  • REPLICA_PRIMARY
  • REPLICA_SECONDARY
  • REPLICA_ARBITER
  • RECOVERING
  • MASTER
  • SLAVE
  • SHARD_MONGOS
  • SHARD_CONFIG
  • SHARD_STANDALONE
  • SHARD_PRIMARY
  • SHARD_SECONDARY
  • NO_DATA

The type for new hosts added to Ops Manager will be NO_DATA until the Monitoring Agent receives its first ping.

uptimeMsec number Number of milliseconds since this process last restarted.
version string Version of MongoDB running for this process.

Example Request

curl --user "{USERNAME}:{APIKEY}" --digest \
 --header "Accept: application/json" \
 --header "Content-Type: application/json" \
 --include \
 --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{GROUP-ID}/hosts/byName/server1.example.com:27017?pretty=true"

Example Response

Response Header

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {DATE-IN-UNIX-FORMAT}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{NONCE}", algorithm=MD5, op="auth", stale=false
Content-Length: {REQUEST-LENGTH}
Connection: keep-alive
HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {DATE-IN-UNIX-FORMAT}
Connection: keep-alive
Content-Length: {REQUEST-LENGTH}

Response Body

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "alertsEnabled" : true,
  "aliases": [ "server1.example.com:27017", "10.1.0.10:27017" ],
  "authMechanismName" : "SCRAM-SHA-1",
  "clusterId" : "{CLUSTER-ID}",
  "created" : "2014-04-22T19:56:50Z",
  "deactivated" : false,
  "displayName": "Example",
  "groupId" : "{GROUP-ID}",
  "hasStartupWarnings" : false,
  "hidden" : false,
  "hostEnabled" : true,
  "hostname" : "server1.example.com",
  "id" : "{HOST-ID}",
  "ipAddress": "10.1.0.10",
  "journalingEnabled" : false,
  "lastDataSizeBytes" : 633208918,
  "lastIndexSizeBytes" : 101420524,
  "lastPing" : "2016-08-18T11:23:41Z",
  "links" : [  ],
  "logsEnabled" : false,
  "lowUlimit" : false,
  "muninEnabled" : false,
  "port" : 27017,
  "profilerEnabled" : false,
  "replicaSetName": "rs1",
  "replicaStateName" : "PRIMARY",
  "sslEnabled" : true,
  "typeName": "REPLICA_PRIMARY",
  "uptimeMsec": 1827300394,
  "username" : "mongodb",
  "version" : "3.2.0"
}