Using the Monitoring Solution API

The Dotcom-Monitor REST API allows developers to programmatically manage monitoring devices, tasks, alerts, and retrieve performance data using standard HTTP(S) methods (GET, POST, PUT, DELETE). This enables custom integrations, automated workflows, and custom reporting outside the web interface.

You can also use the XML feed for subscribing to monitoring data and presenting it in your own format. See Using the XML Reporting Service (XRS) Tool for details.

The Dotcom-Monitor API users can create their own custom scripts or applications to interact with the settings and view the monitored data in their own customized environment. Our system uses REST API that enables interaction with the Dotcom-Monitor web site programmatically using the most popular methods for working with data via HTTP(S) requests (GET, POST, PUT, DELETE). Almost all Dotcom-Monitor objects can be accessed via REST API and almost every aspect of Dotcom-Monitor service functionality can be managed. Using API calls the developers can create and remove devices and tasks, postpone and start them, create and manage alert groups, templates, filters and schedulers, obtain device status information plus many other options.

In general, the Dotcom-Monitor API can be used for the following tasks:

• Third-party integration with the Dotcom-Monitor Monitoring solution.
• Data download and upload.
• Data modification.

The most common actions executed via the REST API:

• Accessing lists of monitoring platforms, devices, targets, schedulers, locations, alert groups, filters, alert templates.
• Accessing detailed info on platforms, devices and targets.
• Editing devices, targets, schedulers, alert groups and templates, filters.
• Creating a new dotcom-Monitor object ( devices, targets, schedulers, etc.).
• Managing audit objects.

The Dotcom-Monitor API is broken out into 10 resource types:

• Platform: All monitoring tasks fall onto one of five different platforms.
• Devices: A monitored device is an organized “set” of monitoring tasks that contains either a single monitoring task, a sequence of monitoring tasks, a monitoring script that includes tasks, or a combination of all three.
• Tasks: A task is any single monitoring activity, such as monitoring a target (URL, Mail Server, FTP Server, etc.).
• Frequency: Defines how often monitoring sessions will be executed.
• Scheduler: A scheduler details when a task will or will not be run.
• Location: A monitoring location available within the Dotcom-Monitor worldwide monitoring network.
• Alert Group: Setting up a group places recipients of a report and/or alert into a group. Each recipient in the group can have a unique alert template.
• Alert Template: Template defines alert format.
• Filter: A filter is a set of rules, which determine how monitoring responses are processed and displayed.
• Audit: Provides historical information on any account modification.

The table below shows which request type and action are supported by each resource type. See the Monitoring Methods section for detailed descriptions.