Bulk Importing Certificate Monitors
When managing many services, manually adding monitors one-by-one can be time-consuming. The Import Monitors feature lets you upload a CSV file with up to 1,000 certificate monitors and create them all at once.
Getting Started
Navigate to Certificate Monitoring ➡️ Manage ➡️ Monitors and click the Import Monitors button. This opens the import page where you can upload your CSV file.
Drag-and-drop the CSV file onto the upload area, or click on it to open a file selection dialog. The system parses the file and displays a preview table of the monitors to be imported.
CSV File Format
The CSV file requires three columns in this order:
| Column | Description |
|---|---|
| Name | A friendly display name for the monitor (max 100 characters) |
| Hostname | The DNS hostname or IP address to monitor (max 512 characters) |
| Protocol | The connection protocol to use (see Supported Protocols) |
| Tags (optional) | Semicolon-separated list of tags |
If the Name column is left empty for a row, the hostname is used as the display name. If the Protocol column is left empty or contains an unrecognized value, it defaults to https.
Hostname Format
The hostname column must contain only a DNS hostname or IP address, with an optional :port suffix to override the protocol's default port. No other content is permitted.
| Format | Example | Notes |
|---|---|---|
| DNS hostname | mail.example.com | Standard hostname |
| DNS hostname with port | mail.example.com:2500 | Custom port |
| IPv4 address | 192.168.1.100 | |
| IPv4 address with port | 192.168.1.100:5432 | Custom port |
| IPv6 address | [2001:db8::1] | Must use square brackets |
| IPv6 address with port | [2001:db8::1]:8443 | Must use square brackets |
The following are not valid and will be rejected:
| Invalid | Reason |
|---|---|
https://mail.example.com | Protocol prefix not allowed |
mail.example.com:25 (starttls) | Annotations after the port not allowed |
smtp://mail.example.com:587 | Protocol prefix not allowed |
Example Without Header
Web Server, example.com, https
Mail Server, mail.example.com, smtps
Example With Header and Tags
Name, Hostname, Protocol, Tags
Web Server, example.com, https, web; production
Mail Server, mail.example.com:2500, smtp, mail-servers; production; dc-1
LDAP Directory, ldap.internal.com, ldaps, directory; internal
Database Primary, db1.example.com, postgresql, database; critical
IPv6 Web Server, [2001:db8::1]:8443, https, web; ipv6
Header Detection
The import process automatically detects a header row if present. The following column names are recognized (case-insensitive):
- Name or Description — maps to the monitor display name
- Hostname or Host — maps to the hostname
- Protocol — maps to the protocol
- Tags — maps to the tags
When a header is detected, column order does not matter — columns are matched by name. If no header is detected, the system assumes the column order: Name, Hostname, Protocol, Tags.
Supported Protocols
The following protocol values are supported in the CSV file (case-insensitive):
| Category | Protocols |
|---|---|
| Web | https |
smtps, smtp, imaps, imap, pops, pop, lmtp | |
| File Transfer | ftps, ftp |
| Directory | ldaps, ldap |
| Database | mysql, postgresql |
| Voice/SIP | sips |
Previewing and Importing
After uploading the CSV file, a preview table is displayed with columns for Protocol, Name, Hostname, and Tags. Each row has a checkbox allowing you to include or exclude it from the import.
Duplicate Detection
If a monitor with the same hostname and protocol combination already exists on your account, the row is marked as Duplicate with a strike-through style. Duplicate monitors are automatically excluded from the import and cannot be selected.
Completing the Import
Review the preview table and uncheck any monitors you do not want to import. When ready, click the Import Monitors button at the top of the page. The button is disabled until at least one valid (non-duplicate) monitor is selected.
All imported monitors are assigned your account's default monitoring profile and default contact group. You can modify these settings individually or in bulk after the import is complete.
Limits
- Maximum 1,000 monitors per CSV file
- Only CSV files are supported — Excel (
.xlsx) and other spreadsheet formats are not accepted - Rows with an empty hostname are skipped
Start with a small test batch of 5-10 monitors to verify your CSV format is correct. After importing, review the monitors list and adjust profiles, contact groups, or tags as needed. Use the Export All Monitors feature to back up your existing configurations before large imports.