Configuring Status.io

Status.io is a status page platform for your app, web service, or developer API. The integration allows you to push alerts and response time metrics to Status.io, and we have worked together to make it seamless. To get started, you will first need to set up a Status.io account at https://status.io/.

Integration Functionality

• When an alert is created within Uptime.com, the downtime is tracked as a Service Disruption in Status.io.
• When the alert is cleared in Uptime.com, the status will display Operational.
• Response time metrics are sent to Status.io and can be displayed in graphs on your status page.
• Metrics will appear in 15-minute intervals.

Integration Setup

A series of steps are required to complete the Integration with Status.io, and you will need to switch between Status.io and Uptime.com at various stages. Follow these steps to complete your Integration setup.

Obtain API Credentials

Login to your Status.io dashboard and click API in the left-hand menu. Click the Developer API tab, then click the Display API Credentials button. Copy the Status Page ID, API ID and API Key, then return to Uptime.com.

In order to activate the integration of Status.io within your Uptime account, navigate to  Notifications > Integrations, then click New Profile. Select Status.io as the Provider Type when adding a new push notifications profile.

Paste the Status Page ID, API ID, and API Key into the corresponding fields. Name your integration, then proceed to the next phase.

Component/Container IDs

Return to Status.io.

To have a component & container automatically update when a check fails, you will need to provide the Component ID and Container ID. Click Infrastructure from the left menu, then select Modify next to your component. Scroll down to Automatic Status Updates, then click API. Copy both the component and container IDs into the form above.

Return to your Uptime.com Integration for Status.io, and paste the Component ID and Container ID in the corresponding fields. At this point, you are ready to Save your integration and configure the Contact for it.

Obtain Metric IDs

To have a metric update with a check's response time, select Metrics from the left menu and add or modify a metric. Under Data Source select Custom, then copy the Metric ID into the form above.

Once you've configured your Status.io integration, you will need to assign it to a contact and make sure that contact is notified when a Check fails.

Assign Integration to Contacts

To add your integration to an existing contact, click on or type the name of the contact into the Assign to Contacts field within the integration setup screen. 

You can designate a new contact from within the integration setup. Enter the name of your new contact into the Assign to Contacts field, and select it as depicted below:

Uptime.com will create a new contact and assign the integration to it. You can find this contact when you click Notifications > Contact.

Assign Integration Contact to a Check

If you have created a new or dedicated contact for your integration, you will need to add it to specific checks. If you have assigned the integration to a contact that is already assigned to one (or more) checks, you may skip this step.

Return to your Check’s Edit screen and assign this contact to the Contacts field to be notified of a downtime event. Metrics will appear in 15-minute intervals. On initial setup, metric data may take up to 30 minutes to initially appear.

Data for one or five-minute interval checks is shown in averages of 15 minutes, with more precise metrics and the option to download metrics available from Uptime.com. This data also includes response time per location.

Please note: Response time data is stored based on account usage. Uptime.com stores hourly data for a maximum of 90 days, and daily check data for a period of up to 24 months.

Test Your Integration

Test your integration with one of the following two options:

1. Force the Check assigned to your Integration to fail by altering it (HTTPS checks can use a misspelling of the domain, for example)
2. Click Notifications > Contacts, then click Actions > Test to send a test to the Contact