Fix Atlas Search Issues¶
On this page
Atlas Search triggers Atlas Search alerts when the amount of CPU and memory used
by Atlas Search processes reaches a specified threshold. If the search
process (mongot
) runs out of memory, indexing and
queries fail. You can configure Atlas Search alert conditions in the project
alert settings modal. You can also view Atlas Search
metrics with cluster monitoring.
Alert Conditions¶
You can configure the following alert conditions in the project-level alert settings page to trigger alerts.
Search Memory: Resident
occurs
if the total bytes of resident memory occupied by the Atlas Search process is
above or below the threshold.
Search Memory: Shared
occurs if
the total bytes of shared memory occupied by the Atlas Search process is above
or below the threshold.
Search Memory: Virtual
occurs if
the total bytes of virtual memory occupied by the Atlas Search process is
above or below the threshold.
Search Process: CPU (Kernel) %
occurs if the percentage of time
the CPU spent servicing operating system calls for the Atlas Search process is
above the threshold.
Search Process: CPU (User) %
occurs if the percentage of time the CPU spent servicing the Atlas Search
process is above the threshold.
Search Process: Disk space used
occurs if the total bytes of disk
space used by the Atlas Search process is above the threshold.
Search Process: Ran out of memory
occurs if the search process
(mongot
) runs out of memory. If the search process runs out of
memory, indexing and queries fail.
The Search Process: Ran out of memory
alert runs
automatically by default. You can configure the alert setting to disable this notification.
Common Triggers¶
Atlas Search alerts often occur when you try to build a large or complex search index. These indexes remain in the Initial Sync phase until you resolve the memory issue.
Fix the Immediate Problem¶
If the search process (mongot
) runs out of memory, you can
upgrade your cluster to fix the
immediate problem. You can select a cluster tier with more memory,
storage, and IOPS.
Implement a Long-Term Solution¶
To prevent Atlas Search alerts in the future, carefully review the Performance Considerations for Atlas Search. Work to optimize your indexes.
Monitor Your Progress¶
View the available Atlas Search charts to monitor Atlas Search metrics.
Monitor Atlas Search metrics to evaluate and optimize your Atlas Search indexes.
To learn more, see View Cluster Metrics