# Monitor Lightsail distribution performance metrics
After you create a distribution in Amazon Lightsail, you can view its metric graphs on the **Metrics** tab of the distribution’s management page. Monitoring metrics is an important part of maintaining the reliability, availability, and performance of your resources. Monitor and collect metric data from your resources regularly so that you can more readily debug a multi-point failure, if one occurs. For more information about metrics, see [Metrics](amazon-lightsail-resource-health-metrics.md).
When monitoring your resources, you should establish a baseline for normal resource performance in your environment. Then you can configure alarms in the Lightsail console to notify you when your resources are performing outside of specified thresholds. For more information, see [Notifications](amazon-lightsail-notifications.md) and [Alarms](amazon-lightsail-alarms.md).
**Contents**
+ [Distribution metrics](#distribution-metrics)
+ [View distribution metrics in the Lightsail console](#viewing-distribution-metrics-console)
+ [Next steps after viewing your distribution metrics](#next-steps-viewing-distribution-metrics)
## Distribution metrics
The following distribution metrics are available:
+ **Requests** — The total number of viewer requests received by your distribution, for all HTTP methods, and for both HTTP and HTTPS requests.
+ **Bytes uploaded** — The number of bytes uploaded to your origin by your distribution, using POST and PUT requests.
+ **Bytes downloaded** — The number of bytes downloaded by viewers for GET, HEAD, and OPTIONS requests.
+ **Total error rate** — The percentage of all viewer requests for which the response’s HTTP status code was 4xx or 5xx.
+ **HTTP 4xx error rate** — The percentage of all viewer requests for which the response’s HTTP status code was 4xx. In these cases, the client or client viewer may have made an error. For example, a status code of 404 (Not Found) means that the client requested an object that could not be found.
+ **HTTP 5xx error rate** — The percentage of all viewer requests for which the response’s HTTP status code was 5xx. In these cases, the origin server did not satisfy the request. For example, a status code of 503 (Service Unavailable) means that the origin server is currently unavailable.
## View distribution metrics in the Lightsail console
Complete the following procedure to view distribution metrics in the Lightsail console.
1. Sign in to the [Lightsail console](https://lightsail.aws.amazon.com/).
1. In the left navigation pane, choose **Networking**.
1. Choose the name of the distribution for which you want to view metrics.
1. Choose the **Metrics** tab on the distribution management page.
1. Choose the metric that you want to view in the drop-down menu under the **Metrics graphs** heading.
The graph displays a visual representation of the data points for the chosen metric.
1. You can perform the following actions on the metrics graph:
+ Change the view of the graph to show data for 1 hour, 6 hours, 1 day, 1 week, and 2 weeks.
+ Pause your cursor on a data point to view detailed information about that data point.
+ Add an alarm for the chosen metric to be notified when the metric crosses a threshold you specify. For more information, see [Alarms](amazon-lightsail-alarms.md) and [Create instance metric alarms](amazon-lightsail-adding-distribution-health-metric-alarms.md).
## Next steps after viewing your distribution metrics
There are a few additional tasks that you can perform for your distribution metrics:
+ Add an alarm for the chosen metric to be notified when the metric crosses a threshold you specify. For more information, see [Alarms](amazon-lightsail-alarms.md) and [Create distribution metric alarms](amazon-lightsail-adding-distribution-health-metric-alarms.md).
+ When an alarm is triggered, a notification banner is displayed in the Lightsail console. To be notified by email and SMS text message, you must add your email address and mobile phone number as notification contacts in each AWS Region where you want to monitor your resources. For more information, see [Add notification contacts](amazon-lightsail-adding-editing-notification-contacts.md).
+ To stop receiving notifications, you can remove your email and mobile phone from Lightsail. For more information, see [Delete or disable metric alarms](amazon-lightsail-deleting-notification-contacts.md). You can also disable or delete an alarm to stop receiving notifications for a specific alarm. For more information, see [Delete or disable metric alarms](amazon-lightsail-deleting-health-metric-alarms.md).
**Topics**
+ [Distribution metrics](#distribution-metrics)
+ [View distribution metrics in the Lightsail console](#viewing-distribution-metrics-console)
+ [Next steps after viewing your distribution metrics](#next-steps-viewing-distribution-metrics)
+ [Create distribution alarms](amazon-lightsail-adding-distribution-health-metric-alarms.md)
# Monitor Lightsail distribution health with metric alarms
You can create an Amazon Lightsail alarm that watches a single distribution metric. An alarm can be configured to notify you based on the value of the metric relative to a threshold that you specify. Notifications can be a banner displayed in the Lightsail console, an email sent to your email address, and an SMS text message sent to your mobile phone number. For more information about alarms, see [Alarms](amazon-lightsail-alarms.md).
**Contents**
+ [Distribution alarm limits](#distribution-alarm-limits)
+ [Best practices for configuring distribution alarms](#distribution-alarms-best-practices)
+ [Default alarm settings](#default-distribution-alarm-settings)
+ [Use the Lightsail console to create distribution metric alarms](#creating-distribution-alarms)
+ [Test distribution metric alarms](#testing-distribution-alarms)
+ [Next steps after creating distribution alarms](#next-steps-creating-distribution-alarms)
## Distribution alarm limits
The following limits apply to alarms:
+ You can configure two alarms per metric.
+ Alarms are evaluated in 5 minute intervals, and each data point for alarms represents a 5 minute period of aggregated metric data.
+ You can only configure an alarm to notify you when the alarm state changes to `OK` if you configure the alarm to notify you by email and/or SMS text message.
+ You can only test the `OK` alarm notification if you configure the alarm to notify you by email and/or SMS text message.
+ You can only configure an alarm to notify you when the alarm state changes to `INSUFFICIENT_DATA` if you configure the alarm to notify you by email and/or SMS text message, and if you choose the **Do not evaluate the missing data** option for missing data points.
+ You can only test notifications if the alarm is in an OK state.
## Best practices for configuring distribution alarms
Before you configure a metric alarm for your distribution, you should view the historical data of the metric. Identify the metric's low-levels, mid-levels, and high-levels over a period of the last two weeks. In the following requests metric graph example, the low-levels are 0-10 requests, the mid-levels are between 10-50 requests, and the high-levels are between 50-250 requests.
![\[Distribution requests example.\]](http://docs.aws.amazon.com/lightsail/latest/userguide/images/amazon-lightsail-distribution-requests-graph-example.png)
If you configure the alarm threshold to be **greater than or equal to** somewhere in the low-level range (e.g., 5 requests), then you will get more frequent, and potentially unnecessary alarm notifications. If you configure the alarm threshold to be **greater than or equal to** somewhere in the high-level range (e.g., 150 request), then you will get less frequent alarm notifications, but that might be more important to investigate. When you configure an alarm, and enable it, an alarm line representing the threshold appears on the graph as shown in the following example. The alarm line labeled as 1 represents the threshold for Alarm 1, and the alarm line labeled as 2 represents the threshold for Alarm 2.
![\[Distribution metric example, with alarm line.\]](http://docs.aws.amazon.com/lightsail/latest/userguide/images/amazon-lightsail-networkout-transmit-graph-example-alarmed.png)
## Default alarm settings
Default alarm settings are prepopulated when you add a new alarm in the Lightsail console. That is the recommended alarm configuration for the metric you selected. However, you should confirm that the default alarm configuration is appropriate for your resource. For example, the default alarm threshold for the requests metric is **greater than** 45 requests for 3 times within the last 15 minutes. However, that request threshold might be too low for your distribution. You might want to modify the alarm threshold to be **greater than** 150 requests for 3 time within the last 15 minutes.
## Use the Lightsail console to create distribution metric alarms
Complete the following steps to create a distribution metric alarm using the Lightsail console.
1. Sign in to the [Lightsail console](https://lightsail.aws.amazon.com/).
1. In the left navigation pane, choose **Networking**.
1. Choose the name of the distribution for which you want to create alarms.
1. Choose the **Metrics** tab on the distribution management page.
1. Choose the metric for which you want to create an alarm in the drop-down menu under the **Metrics Graphs** heading. For more information, see [Resource metrics](amazon-lightsail-resource-health-metrics.md).
1. Choose **Add alarm** in the **Alarms** section of the page.
1. Choose a comparison operator value in the drop-down menu. Example values are greater than or equal to, greater than, less than, or less than or equal to.
1. Enter a threshold for the alarm.
1. Enter the data points to alarm.
1. Choose the evaluation periods. The period can be specified in 5-minute increments, from 5 minutes up to 24 hours.
1. Choose one of the following notification methods:
+ **Email** — You are notified by email when the alarm state changes to ALARM.
+ **SMS text message** — You are notified by SMS text message when the alarm state changes to ALARM. SMS messaging is not supported in all AWS Regions in which you can create Lightsail resources, and SMS text messages cannot be sent to all countries/regions. For more information, see [SMS text messaging support](amazon-lightsail-adding-editing-notification-contacts.md#sms-support).
**Note**
You are required to add an email address or mobile phone number if you select to be notified by email or SMS but you haven’t yet configured a notification contact in the resource’s AWS Region. For more information, see [Notifications](amazon-lightsail-notifications.md).
1. (Optional) Choose **Send me a notification when the alarm state change to OK** to be notified when the alarm state changes to OK. This option is available only if you choose to be notified by Email or SMS text message.
1. (Optional) Choose **Advanced settings**, and then choose one of the following options:
+ Choose how the alarm should treat missing data The following options are available:
+ **Assume it's not within the threshold (Breaching threshold)** — Missing data points are treated as "bad" and breaching the threshold.
+ **Assume it's within the threshold (Not breaching threshold)** — Missing data points are treated as "good" and within the threshold.
+ **Use the value of the last good datapoint (Ignore and maintain the current alarm state)** — The current alarm state is maintained.
+ **Do not evaluate it (Treat missing data as missing)** — The alarm doesn't consider missing data points when evaluating whether to change state.
+ Choose **Send a notification if there is insufficient data** to be notified when the alarm state changes to INSUFFICIENT\$1DATA. This option is available only if you choose to be notified by Email or SMS text message.
1. Choose **Create** to add the alarm.
To edit the alarm later, choose the ellipsis icon (⋮) next to the alarm you want to edit, and choose **Edit alarm**.
## Test distribution metric alarms
Complete the following steps to test an alarm using the Lightsail console. You might want to test an alarm to confirm that the configured notification options are working, such as to ensure that you receive an email or an SMS text message when the alarm is triggered.
1. Sign in to the [Lightsail console](https://lightsail.aws.amazon.com/).
1. In the left navigation pane, choose **Networking**.
1. Choose the name of the distribution for which you want to test an alarm.
1. Choose the **Metrics** tab on the distribution management page.
1. Choose the metric for which you want to test an alarm in the drop-down menu under the **Metrics Graphs** heading.
1. Scroll down to the **Alarms** section of the page, and choose the ellipsis icon (⋮) next to the alarm you want to test.
1. Choose one of the following options:
+ **Test alarm notification** — Choose this option to test the notifications for when the alarm state changes to `ALARM`.
+ **Test OK notification** — Choose this option to test the notifications for when the alarm state changes to `OK`.
**Note**
If either of these options is unavailable, you might not have configured the notification options for the alarm, or the alarm might currently be in an `ALARM` state. For more information, see [Distribution alarm limits](#distribution-alarm-limits).
The alarm momentarily changes to an `ALARM` or `OK` state depending on the test option you chose, and an email and/or SMS text message is sent depending on what you configured as the notification method for the alarm. A notification banner displays in the Lightsail console only if you chose to test the `ALARM` notification. A notification banner is not displayed if you chose to test the `OK` notification. The alarm will return to its actual state often after a few seconds.
## Next steps after creating distribution alarms
There are a few additional tasks that you can perform for your distribution alarms:
+ To stop receiving notifications, you can remove your email and mobile phone from Lightsail. For more information, see [Delete notification contacts](amazon-lightsail-deleting-notification-contacts.md). You can also disable or delete an alarm to stop receiving notifications for a specific alarm. For more information, see [Delete or disable metric alarms](amazon-lightsail-deleting-health-metric-alarms.md).