Reports are accessible at all times from either your Dashboard, or from each check. An Uptime Report is a measure of downtime and associated incidents for a given period of time, for an individual check.
- Elements of an Uptime.com Report
- NTP Reporting
- Downloading Reports
- Scheduling SLA Reports
- Final Thoughts
The Uptime Report has four major areas to be aware of:
We’ll look at each area in detail below.
By default, the Uptime Report screen displays incident and performance data for the past 24 hours. Users can click the Date field to fill in specific dates, or use one of the presets on the right-hand side.
Uptime Reports provide detailed downtime and alert data and allow you to review past historic data for a period of time you’ve selected. Use this report to compare outages for a given period of time, track improvements, or to view uptime for the month or year.
Response time metrics are calculated based on your check configuration:
- HTTP Check without a String to Expect: time to receive 200 OK
- API Check: Time to run through all steps within the API check. Steps may include resolving status, making a request or receiving a response.
Response time is heavily dependent on location. For example, a probe server in Australia will typically see a higher response time connecting to a server based in New York than a probe based in the US.
There are two performance graphs within Uptime Reports. The first visualizes response time as a line graph, which measures average response across all locations (you may also filter by location).
The second is the Alert Log, a color-coded bar to visualize up and down time. If your bar is grayed out, or not filled in, Uptime.com does not have data for this period.
Important data retention limits to keep aware of include:
- Metric data is retained in 15-minute intervals after 30 days
- Hourly data is retained for a maximum of 90 days depending on your account plan
- Daily aggregated data is retained for a maximum of two years depending on your account plan
In addition to the color coded Alert Log, outages are also represented by a light red overlay over the response time graph for the period the check was reported down.
The light red overlay will correlate the time and date of the alert, as shown in the alert log. Once the check returns to an UP state, the overlay will still be visible for the downtime period when changing the time frame of the view.
Uptime.com uses three color-coded graph types, found on the Dashboard and Checks screen, to indicate the severity of performance issues. Graphs are based on the calculated Target SLA%, and SLA Response Time Values that have been configured for each check.
- Blue: the check is below any thresholds that indicate a performance issue
- Orange: the check performance is above the Blue threshold, which may indicate degraded performance.
- Red: Response time is considered high for this check type, and performance is above the Orange threshold. We recommend investigating red color coded graphs for performance issues.
A check, check card, or response time graph changes its color coding when the average of these graphs meet the following thresholds:
Target SLA %
> Above the Target SLA % (Blue)
> Halfway to Target SLA % (Orange)
> Below the Target SLA % (Red)
Example: If the Target SLA% is 90%, the graph will be Blue 100%-95%, Orange 94.99%-90%, and Red at or below 89.99%.
Target Response Time SLA (secs)
> Below 70% of Target Response Time SLA (Blue)
> 70% - 100% of Target Response Time SLA (Orange)
> Above 100% of Target Response Time SLA (Red)
Example: If the Target Response Time SLA is 10 seconds, graph will be blue 0-7s, Orange 7.01-10s, and Red above 10s.
The Alert Log on the Uptime Report contains information about the previous changes in status to the probe servers associated with your check. Use this space to determine when the probe status shifted from OK to CRITICAL, the reason for downtime and the duration of the downtime with some technical details to help summarize the issue.
Your account type determines how long alert data is retained. Please see the History Retention entry from your Account Usage page to see the specified time for your account type.
Please Note: deleted check alert data will be non-recoverable after 30 days.
The sidebar on the right-hand side contains a summary of everything you will see in the Uptime Report. It’s not as detailed, but it provides an at-a-glance summary of what your reporting shows, as well as a link to your real-time analysis for the check.
You can install the Uptime.com Widget on your website, or download a PDF or XLS file of your report for the period you’ve specified. Please note the XLS has two sheets, one for metrics and the other summarizing current status viewable from the right-hand panel in the Reports UI.
NTP Reporting is slightly different from other reporting, in that the graph does not measure performance it measures offset with the network time protocol server. Note in this NTP check example that response time is well below the NTP fail threshold of 1,000 milliseconds:
Information on RUM Reporting can be found here. The RUM report will provide you with real-time data regarding the average page load from sites where a Real User Monitoring check was created.
Information on Status Pages can be found here. Status Pages provide the ability to display your uptime checks in a private status page or on a public URL. Users can also create SLA Reports, which allow organizations to report on specific checks or systems for the purposes of SLA accountability.
For Group Check reporting, see our article on Group Checks.
To download any check's report, click Monitoring > Checks, locate the check you wish to download a report of, then click the "three dots" button, then Report. Click the blue Download button, and select between either XLS or PDF. Remember: set the date range accordingly (the default report screen displays activity for the previous 24 hours).
Please note: Check Reports are for individual checks, whereas SLA Reports are for multiple checks grouped together.
To schedule a SLA Report, click Reports > Scheduled Reports. Scheduled reports deliver a PDF or XLS document to either Uptime.com users or email address(es) you select. You may wish to add Uptime.com users specifically for the purpose of receiving this report, but it is also possible to send reports to external email addresses.
Please note: A scheduled report can be sent to a maximum of 100 recipients (which includes both external email addresses and Uptime.com users within your account).
A weekly report is scheduled for all users for all checks by default. Reports can be scheduled or re-scheduled for delivery at the following recurrences:
- Daily on the day and time you select.
- Weekly, delivered at the date and time you select.
- Monthly, delivered on the first day of the month at the time you select.
- Quarterly, delivered on the first day of each quarter at the time you select.
- Yearly on the first of each year, delivered at the time you select.
Uptime.com makes communicating monitoring results, metrics, and data easy with Reports. Schedule reports to be sent to key stakeholders at defined intervals, or download any given check's data in your preferred format whenever needed.
If you need any assistance, please reach out to firstname.lastname@example.org for help!