Bulk Import Tool | Use and Fields

The Bulk Import system is designed to provide a simple template that allows for efficient creation of many checks in a single action. We recommend that users download the Bulk Upload Excel Template, which provides a sample of the data format that is accepted by Uptime.com.


bulk-import1.png

The Bulk Import system can accept up to 200 checks simultaneously. For values higher than 200, please upload a separate Excel sheet following the Bulk Upload format.

All Bulk Upload Checks are available via download as XLS files for review and editing.

Bulk Import Fields Defined

Each field tells Uptime.com something specific about the check you’re creating. Here are some detailed explanations to help users find the required parameters for their specific check. You can see an example of some values within this sheet below:

sample-excel-sheet.png

Type

The Check Type. The Excel sheet provided includes a dropdown list with each Check Type available through Uptime.com.

Name

An optional parameter. Name is used to identify your check with a custom name that you designate.

Interval

Designate the frequency in which the check is run. Checks run at a one-minute Interval are not available to free accounts.

Contacts

Contacts refers to the name(s) of the contacts to alert if a check fails. You can specify multiple contacts separated by commas, eg: Default, Emergency, or IT Admin. Default will issue alerts to the email address used to create your Uptime.com account.

Locations

A list of locations to run the checks from, separated by commas. For example, US-East, UK. You may leave this blank to run the check from all locations. See the Probe Servers page for a full list of locations.

Address

For HTTP/HTTPS checks, Address refers to the full URL of the page to check. For specific pages, please designate the full URL and not merely the domain. For all other checks, Address is the domain name or IP address of the server to check.

Port

Designate which Port on the server Uptime.com should monitor. You may leave this blank if you use the standard ports (eg. port 80 for HTTP).

Username

For HTTP/HTTPS checks, this optional Username is for Basic Authentication. For SMTP checks, the optional username parameter is used to login to the server.

Password

This is the accompanying Password to be used with username above.

DNS_Server

For DNS checks only, this cell represents the domain name or IP address of the DNS Server to query.

DNS_Record_Type

For DNS checks only, this cell represents the DNS Record Type to query and verify. (Uptime.com can check for: ANY, A, AAAA, CNAME, MX, NS, PTR, SOA or TXT). Please refer to our DNS Check Basics article for additional information.

Send_String

For HTTP/HTTPS checks, this cell should include an optional URL-encoded string to POST to the provided URL. For TCP/UDP checks, the data to send to the server after connecting.

Expect_String

If provided, the check ensures that the response from the server includes the text in this cell. Not used for ICMP or SSH checks.

Expect_String_Type

For HTTP/HTTPS checks, this cell describes the kind of string to expect. Will alwyas be one of the following: STRING - plain text string, REGEX - regular expression, INVERSE_REGEX - check fails if regular expression is matched.

Encryption

Encryption applies to SMTP, POP, and IMAP checks only. This cell specifies whether to use SSL/TLS encryption when connecting to the mail server. Select the correct value from the drop-down list.

Threshold

The alert Threshold refers to the response time or page load time when applied to HTTP, Transaction, API and RUM checks. For WHOIS/SSL certificate checks, this cell specifies how many days before domain/certificate expiry to raise an alert.

Protocol

This cell sends the Protocol-specific message(s) to switch to TLS for communication SSL checks. Protocol is a keyword for the intended protocol. Currently, the only supported keywords are "http" (default for HTTPS connections), "smtp", "pop3", "imap", "ftp", "xmpp", "irc", and "ldap".

Headers

Headers specify what headers to send with each request for HTTP checks. Headers must be written in the following format: Name: Value, with one entry per line.

Script

Script is used for Transaction checks, specifying the JSON script that defines the entire transaction. This is an advanced feature, and we suggest you use the transaction editor on the checks page instead. Please also refer to our Transaction Checks Basics support article for more information.

Sensitivity

Sensitivity defines the number of locations that must be down before an alert is sent. This value defaults to 2, which is the minimum we recommend to avoid false positives.

Use_IP_Version

Specifies whether to use IPv4, IPv6 or any available address of the target host. Possible values are: IPV4 or IPV6. Leave this cell blank to use any available IP version.

Notes

Free text available for any check. Use this space to include any information for your reference, such as error recovery instructions your team should follow.