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-import-add-new.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.

Table of Contents

Bulk Import Fields Defined

Return

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:

bulk-upload-spreadsheet.png

Type

Return

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

Name

Return

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

Interval

Return

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

Contacts

Return

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

Return

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. NOTE: To avoid false positives, use a minimum of three locations and set Sensitivity to 2 or more.

Address

Return

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

Return

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

Return

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.

Version

Return

For HTTP/HTTPS checks this field determines the checker version used. Input value 1 for V1.0 Legacy and value 2 for V2.0 Curl which supports SSL/TLS certificate verification.

Password

Return

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

DNS_Server

Return

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

DNS_Record_Type

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

Sensitivity defines the number of Locations that must be down before an alert is sent. This value defaults to 2 because we recommend a minimum of three locations, with a Sensitivity of two failures in order to avoid false positives.

Use_IP_Version

Return

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.

Uptime_SLA

Return

Defines the minimum availability percentage the check needs to meet, Values rounded up to 2 decimal places.

Response_Time_SLA

Return

Determines the minimum average SLA Response Time (in seconds). Value can be entered up to 3 decimal places.

Notes

Return

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.

Was this article helpful?
1 out of 5 found this helpful

Comments

0 comments

Article is closed for comments.

Have more questions?
Submit a request
Share it, if you like it.