You can register Amazon Relational Database Service (RDS) resources to collect system health and performance metrics.
Prerequisites for monitoring
The following prerequisites are necessary for monitoring RDS resources:
- ArcGIS Monitor Agent must be installed on a machine that has access to the AWS Service API endpoint and must be registered with ArcGIS Monitor Server.
- Authentication requires an AWS Identity and Access Management (IAM) user with an access key pair and the following permissions:
- AmazonEC2ReadOnlyAccess
- AmazonRDSReadOnlyAccess
- CloudWatchReadOnlyAccess
- Each RDS resource to be monitored must be tagged in AWS with the following key-value pair:
- Key—arcgis:monitoring
- Value—true
Note:
The key and value are case sensitive.
Caution:
Amazon charges a fee for certain CloudWatch features. Refer to CloudWatch Pricing for more information.
Register AWS for monitoring
You must be assigned the Administrator or Manager role to register components.
To register AWS, complete the following steps:
- Access ArcGIS Monitor if necessary.
The Home page appears.
- Click Monitoring.
The Monitoring page appears. Registered components are listed alphabetically by component name.
- Click Register component.
The Register component wizard appears.
Note:
If you don't have sufficient privileges, Register component is not available.
- Choose the Monitor Agent machine where the component is installed.
The Component type page appears.
- Under Cloud, choose Amazon Web Services and click Next.
The Component details page appears.
- Provide a name for the component in the Component name text box.
- Optionally, provide a description for the component in the Description text box.
- Optionally, click Apply Labels
and choose the labels that you want to apply to the component. Tip:
Provide the name of a label in the Enter label name text box to search for a specific label. If the label doesn't exist, click Create new label to add the label and apply it to the component.
- Click Next.
The Connection page appears.
- Provide the following IAM authentication information in the Connection section:
- Click Register component.
The component is added to the list of monitored components on the Monitoring page.
Once AWS RDS resources have been registered for monitoring, you can configure alert rules and add them to collections.
Note:
Individual databases hosted in RDS must be registered separately as database components; their metrics can't be acquired through CloudWatch.
Observers
The following table describes the observers that are responsible for collecting attribute and metric data:
| Observer name | Description |
|---|---|
Inventory | The Inventory observer scans for changes and manages attribute data across the AWS account. The default interval for this observer is 5 minutes; however, you can configure it to run at longer intervals since changes to AWS are typically infrequent. |
Metrics | The Metrics observer collects metric data for monitored resources across the AWS account. The default interval for this observer is 5 minutes to align with the CloudWatch basic monitoring interval. You can configure it to run at shorter intervals if your organization subscribes to CloudWatch detailed monitoring. |
Collected attributes
The following table lists the attributes that are collected for RDS resources:
| Attribute name | Description | Data type |
|---|---|---|
Class | The resource's instance type. | String |
CPU cores logical | The CPU's total number of logical cores. | Integer |
CPU cores physical | The CPU's total number of physical cores. | Integer |
CPU name | The CPU name and model information. | String |
CPU speed | The speed of the CPU. | Float |
Location | The AWS availability zone. | String |
Memory total | The resource's total amount of memory (RAM). | Float |
Network speed | The speed of the network. The network speed is displayed as 1000 Mbps. | Integer |
System state | The status of the resource (available, running, or stopped). | String |
Storage total | The size of the volume | Float |
Version | The version of the underlying database. | String |
Collected metrics
The subsections below describe the metrics that are collected for AWS and tagged RDS resources.
AWS metrics
The following table lists the metrics that are collected for AWS:
| Metric name | Description | Data type | Unit |
|---|---|---|---|
Connectivity | The agent's ability to successfully connect to the component. | Float | Percent |
CPU utilized | The average proportion of CPU resources in use across all monitored AWS components. Values approaching 100 percent may indicate that more resources are needed to handle workload. | Float | Percent |
Memory Available | The cumulative total amount of physical memory across all monitored AWS components. | Float | Gigabytes |
Memory Used | The cumulative amount of memory in use across all monitored AWS components. | Float | Gigabytes |
Memory Utilized | The average proportion of memory in use across all monitored AWS components. Values approaching 100 percent may indicate that more resources are needed to handle the workload. | Float | Percent |
Network Incoming | The cumulative rate of network data received across all monitored AWS components. | Float | Megabits/second |
Network Incoming Utilized | The average proportion of incoming network bandwidth in use across all monitored AWS components. | Float | Percent |
Network Outgoing | The cumulative rate of network data sent across all monitored AWS components. | Float | Megabits/second |
Network Outgoing Utilized | The average proportion of outgoing network bandwidth in use across all monitored AWS components. | Float | Percent |
Storage Capacity Available | The cumulative amount of available storage space across all monitored AWS components. | Float | Gigabytes |
Storage Capacity Used | The cumulative amount of storage space in use across all monitored AWS components. | Float | Gigabytes |
Storage Capacity Utilized | The average proportion of storage capacity in use across all monitored AWS components. | Float | Percent |
Storage Read Rate | The cumulative speed at which data is read from the disk across all monitored AWS components. | Float | Gigabytes/second |
Storage Write Rate | The cumulative speed at which data is written to the disk across all monitored AWS components. | Float | Gigabytes/second |
RDS metrics
The following table lists the metrics that are collected for RDS resources:
| Metric name | Description | Data type | Unit |
|---|---|---|---|
CPU utilized | The proportion of CPU resources in use. Values approaching 100 percent may indicate that more resources are needed to handle workload. | Float | Percent |
Memory Available | The total amount of physical memory. | Float | Gigabytes |
Memory Used | The amount of memory in use. | Float | Gigabytes |
Memory Utilized | The proportion of memory in use. Values approaching 100 percent may indicate that more resources are needed to handle the workload. | Float | Percent |
Network Incoming | The rate of network data received. | Float | Megabits/second |
Network Incoming Utilized | The proportion of incoming network bandwidth in use. | Float | Percent |
Network Outgoing | The rate of network data sent. | Float | Megabits/second |
Network Outgoing Utilized | The proportion of outgoing network bandwidth in use. | Float | Percent |
Storage Capacity Available | The amount of available storage space. | Float | Gigabytes |
Storage Capacity Used | The amount of storage space in use. | Float | Gigabytes |
Storage Capacity Utilized | The proportion of storage capacity in use. | Float | Percent |
Storage Read Rate | The speed at which data is read from the disk. | Float | Gigabytes/second |
Storage Write Rate | The speed at which data is written to the disk. | Float | Gigabytes/second |
Default alert rules
The subsections below describe the default alert rules that are configured for the AWS site and its underlying services.
AWS alert rules
The following table lists the default alert rules that are configured for AWS:
| Metric name | Aggregation | Operator | Info threshold | Warning threshold | Critical threshold | Samples |
|---|---|---|---|---|---|---|
Connectivity | Average | Is less than | — | — | 100 | 2 |
CPU Utilized | Average | Is greater than | — | 75 | 90 | 3 |
Memory Utilized | Average | Is greater than | — | 75 | 90 | 3 |
Storage Capacity Utilized | Average | Is greater than | — | 75 | 90 | 3 |
Note:
The default alert rules in the table above are the rules that are configured for components when Monitor is first deployed. If your Monitor administrator has configured default alert rules for the Monitor deployment, the values for the rules above may vary.
RDS alert rules
The following table lists the default alert rules that are configured for RDS resources:
| Metric name | Aggregation | Operator | Info threshold | Warning threshold | Critical threshold | Samples |
|---|---|---|---|---|---|---|
CPU Utilized | Average | Is greater than | — | 75 | 90 | 3 |
Memory Utilized | Average | Is greater than | — | 75 | 90 | 3 |
Storage Capacity Utilized | Average | Is greater than | — | 75 | 90 | 3 |
Note:
The default alert rules in the table above are the rules that are configured for components when Monitor is first deployed. If your Monitor administrator has configured default alert rules for the Monitor deployment, the values for the rules above may vary.