This is one stop global knowledge base where you can learn about all the products, solutions and support features.
The Performance Advisor recognizes a query as slow if it takes longer
to execute than the value of
slowOpThresholdMs.
By default, this value is
100
milliseconds. You can change the
threshold with either the
profile
command or the db.setProfilingLevel()
mongosh
method.
Example
The following
profile
command example sets the threshold at 200
milliseconds:
db.runCommand({
profile: 0,
slowOpThresholdMs: 200
})
If you are running MongoDB 3.6 or later, you can customize the
percentage of slow queries in your logs used by the Performance Advisor
by specifying the
sampleRate
parameter.
Example
This sets the slow query threshold to a lower value of 100 milliseconds but also sets the sample rate to 10%.
db.runCommand({
profile: 0,
slowOpThresholdMs: 100,
sampleRate: 0.1
})
Note
By default, the value of
profile
is
0
. MongoDB recommends
leaving this value unchanged since other values can negatively
impact database performance. To learn more, see the
profile command.
On this page
From your Context menu, click the project that has the hosts you want to configure.
Click Deployments .
Click Servers .
On the host where you want to activate Backup, click ellipsis icon .
Click Activate Backup .
From the banner, click Review & Deploy .
If you want to activate Backup, click Confirm & Deploy . Otherwise click Cancel , then Discard Changes to cancel activating Backup.
Note
Only one host can backup a deployment at a time. On the Server tab, the host that is backing up the deployment displays Backup - active . Any other host with Backup activated displays Backup - standby .
From your Context menu, click the project that has the hosts you want to configure.
Click Deployments .
Click Servers .
On the host where you want to activate Monitoring, click ellipsis icon .
Click Activate Monitoring .
From the banner, click Review & Deploy .
If you want to activate Monitoring, click Confirm & Deploy . Otherwise click Cancel , then Discard Changes to cancel activating Monitoring.
Note
Only one host can monitor a deployment at a time. On the Server tab, the host that is monitoring the deployment displays Monitoring - active . Any other host with Monitoring activated displays Monitoring - standby .
Multiple Monitoring Agents
You can activate Monitoring on multiple MongoDB Agents to distribute monitoring assignments and provide failover. Cloud Manager distributes monitoring assignments among up to 100 running MongoDB Agents. Each MongoDB Agent running active Monitoring monitors a different set of MongoDB processes. One MongoDB Agent running active Monitoring per project is the primary Monitor. The primary Monitor reports the cluster’s status to Cloud Manager. As MongoDB Agents have Monitoring enabled or disabled, Cloud Manager redistributes assignments. If the primary Monitor fails, Cloud Manager assigns another MongoDB Agent running active Monitoring to be the primary Monitor.
If you run more than 100 MongoDB Agents with active Monitoring, the additional MongoDB Agents run as standby MongoDB Agents. A standby MongoDB Agent is idle, except to log its status as a standby and periodically ask Cloud Manager if it should begin monitoring.
If you install multiple Monitoring Agents, ensure that
all
the
MongoDB Agents with active Monitoring can reach all the
mongod
processes in the deployment.
To activate Monitoring on multiple MongoDB Agents, repeat the activation process on multiple MongoDB Agents.
Automation is activated when you:
On this page
We recommend that you rotate the automation user’s password periodically. Cloud Manager provides an automated procedure for password rotation with no downtime.
To enable password rotation for the automation user, you must meet the following requirement:
Otherwise, click Cancel and you can make additional changes.
On this page
The Data Explorer provides an aggregation pipeline builder to process your data. Aggregation pipelines transform your documents into aggregated results based on selected pipeline stages.
The MongoDB Atlas aggregation pipeline builder is primarily designed for building pipelines, rather than executing them. The pipeline builder provides an easy way to export your pipeline to execute in a driver.
To interact with data in the Cloud Manager UI:
To create and execute aggregation pipelines in the
Data Explorer
, you must have been granted at least the
Project
Data
Access
Read
Only
role.
To utilize the
$out
stage in your pipeline, you must
have been granted at least the
Project
Data
Access
Read/Write
role.
The main panel and Namespaces on the left side list the collections in the database.
The main panel displays the Find , Indexes , and Aggregation views.
When you first open the Aggregation view, the Data Explorer displays an empty aggregation pipeline.
Select an aggregation stage from the Select dropdown in the bottom-left panel.
The toggle to the right of the dropdown dictates whether the stage is enabled.
Fill in your stage with the appropriate values. If Comment Mode is enabled, the pipeline builder provides syntactic guidelines for your selected stage.
As you modify your stage, the Data Explorer updates the preview documents on the right based on the results of the current stage.
There are two ways to add additional stages to your pipeline:
To delete a pipeline stage, click the trash icon icon on the desired stage.
Use collation to specify language-specific rules for string comparison, such as rules for lettercase and accent marks.
To specify a collation document, click Collation at the top of the pipeline builder.
A collation document has the following fields:
{
locale: <string>,
caseLevel: <boolean>,
caseFirst: <string>,
strength: <int>,
numericOrdering: <boolean>,
alternate: <string>,
maxVariable: <string>,
backwards: <boolean>
}
The
locale
field is mandatory; all other collation fields are
optional. For descriptions of the fields, see
Collation Document.
You can import aggregation pipelines from plain text into the pipeline builder to easily modify and verify your pipelines.
To import a pipeline from plain text:
Click the arrow next to the plus icon at the top of the pipeline builder.
Click New Pipeline from Text .
Your pipeline must match the syntax of the
pipeline
parameter of
the
db.collection.aggregate()
method.
To return your pipeline to the initial blank state, click the plus icon at the top of the pipeline builder.
You can use the aggregation pipeline builder to export your finished pipeline to one of the supported driver languages; Java, Node, C#, and Python 3. Use this feature to format and export pipelines for use in your applications.
To export your aggregation pipeline:
For instructions on creating an aggregation pipeline, see Create an Aggregation Pipeline .
In the Export Pipeline To dropdown, select your desired language.
The
My Pipeline
pane on the left displays your
pipeline in
mongosh
syntax.
The pane on the right displays your pipeline in the selected language.
(Optional) : Check the Include Import Statements option to include the required import statements for the language selected.
Click the Copy button at the top-right of the pipeline to copy the pipeline for the selected language to your clipboard. You can now integrate your pipeline into your application.
To modify the aggregation pipeline builder settings:
You can modify the following settings:
Setting | Description | Default |
---|---|---|
Comment Mode |
When enabled, the Data Explorer adds helper comments to each stage. Note Changing this setting only affects new stages and does not modify stages which have already been added to your pipeline. |
On |
Number of Preview Documents | Number of documents to show in the preview for each stage. | 20 |
Before the introduction of the MongoDB Agent, each function – Automation, Backup, and Monitoring – ran as a separate agent binary in your project.
The MongoDB Agent runs as a single binary that can perform any – or all – of the three functions depending upon what you need.
On this page
Base URL:
https://cloud.mongodb.com/api/public/v1.0
GET /orgs/{ORG-ID}/groups
Path Element | Type | Description |
---|---|---|
ORG-ID | Required. | The unique identifier for the organization whose information you want to retrieve. |
The following query parameters are optional:
Name | Type | Description | Default |
---|---|---|---|
pageNum
|
integer | Page number (1-based). |
1
|
itemsPerPage
|
integer | Number of items to return per page, up to a maximum of 500. |
100
|
pretty
|
boolean | Displays response in a prettyprint format. |
false
|
envelope
|
boolean | Specifies whether or not to wrap the response in an envelope . |
false
|
name
|
string |
Human-readable label of the project to use to filter the returned
list. Performs a case-insensitive search for a project, which is
prefixed by the specified
Example
If you specify a
|
None |
This endpoint doesn’t use HTTP request body parameters.
The response JSON document includes an array of result objects, an array of link objects and a count of the total number of result objects retrieved.
Name | Type | Description |
---|---|---|
results
|
array | Array includes one object for each item detailed in the results Embedded Document section. |
links
|
array | Array includes one or more links to sub-resources and/or related resources. The relations between URL s are explained in the Web Linking Specification . |
totalCount
|
number | Integer count of the total number of items in the result set. It may be greater than the number of objects in the results array if the entire result set is paginated. |
Each result is one project.
Name | Type | Description |
---|---|---|
activeAgentCount | integer | The number of active monitoring, automation, and Backups in the project. |
hostCounts | Document | Describes the host types and number of each host type for the cluster. |
hostCounts.arbiter | integer | The number of arbiter hosts in the cluster. |
hostCounts.config | integer | The number of sharded cluster configuration server hosts in the cluster. |
hostCounts.master | integer | The number of master hosts in the cluster. |
hostCounts.mongos | integer |
The number of
mongos
hosts in the
cluster.
|
hostCounts.primary | integer | The number of primary hosts in the cluster. |
hostCounts.secondary | integer | The number of secondary hosts in the cluster. |
hostCounts.slave | integer | The number of slave hosts in the cluster. |
id | string | The unique identifier for the project. |
links | object array |
One or more links to sub-resources and/or related resources. All
links
arrays in responses include at least one link called
self
. The relationships between
URL
s are explained in the
Web Linking Specification
.
|
name | string | The name of the cluster. |
orgId | string | The unique identifier for the parent organization of the project. |
publicApiEnabled | boolean | The status of API access to the cluster. |
replicaSetCount | integer | The number of replica sets in the cluster. |
shardCount | integer | The number of shards in the cluster. |
curl --user "{username:apiKey}" \
--include \
--header "Content-Type: application/json" \
--digest GET "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/groups"
HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive
HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
{
"links": [{
}],
"results": [{
"activeAgentCount": 0,
"hostCounts": {
"arbiter": 0,
"config": 0,
"master": 0,
"mongos": 0,
"primary": 1,
"secondary": 2,
"slave": 0
},
"id": "{PROJECT-ID}",
"links": [{
}],
"name": "Production Cluster",
"orgId": "{ORG-ID}",
"publicApiEnabled": true,
"replicaSetCount": 1,
"shardCount": 0
},
{
"activeAgentCount": 0,
"hostCounts": {
"arbiter": 0,
"config": 0,
"master": 0,
"mongos": 0,
"primary": 1,
"secondary": 2,
"slave": 0
},
"id": "{PROJECT-ID}",
"lastActiveAgent": "2017-10-26T02:39:59Z",
"links": [{
}],
"name": "Staging Cluster",
"orgId": "{ORG-ID}",
"publicApiEnabled": true,
"replicaSetCount": 1,
"shardCount": 0
}
],
"totalCount": 2
}