Skip to main content
← Documentation

Asset Monitoring

Asset Monitoring

Asset Monitoring lets you track the health of URLs and endpoints that matter to your customers. AgentDesk periodically checks each asset and can automatically create tickets when something goes down.

Adding an asset

  1. Go to Admin > Portals and open the portal.
  2. Navigate to the Assets tab.
  3. Click Add Asset and fill in the details:
SettingDescriptionConstraints
NameA label for the asset (for example, "Production API" or "Marketing Site")Required
URLThe endpoint to monitorMust be a valid URL
DescriptionOptional notes about what this asset is--
ActiveWhether monitoring is enabledOn / Off
Check intervalHow often to check the asset, in seconds5 to 3,600 seconds
TimeoutHow long to wait for a response before marking the check as failed1,000 to 60,000 milliseconds
Expected statusThe HTTP status code that indicates the asset is healthy (for example, 200)Any valid HTTP status code

Asset statuses

Each asset has a current status based on recent check results:

StatusMeaning
UpThe asset responded with the expected status code within the timeout
DownThe asset did not respond or returned an unexpected status code
DegradedThe asset responded correctly but took longer than 5 seconds

Failure thresholds

To avoid false alarms from transient issues, you can set an alert after fails threshold. This controls how many consecutive failed checks must occur before an incident is opened and notifications are sent.

For example, setting this to 3 means the asset must fail three checks in a row before it is considered down.

Automatic ticket creation

Enable the auto-create ticket option on an asset to have AgentDesk automatically create a support ticket when the asset goes down. This ensures your team is alerted immediately and can begin investigating without manual intervention.

The ticket includes details about the failure, such as the HTTP status code received and any error message.

Incidents

When an asset goes down (after exceeding the failure threshold), an incident is created.

Incident statuses

StatusMeaning
OpenThe asset is currently experiencing an issue
AcknowledgedA team member has seen the incident and is investigating
ResolvedThe asset has recovered and the incident is closed

Incidents track the started at and resolved at timestamps so you can measure downtime duration.

Status logs

Every health check produces a log entry with the following information:

FieldDescription
Response timeHow long the asset took to respond, in milliseconds
HTTP statusThe HTTP status code returned by the asset
Error messageIf the check failed, a description of what went wrong

Status logs provide a historical record of asset health. Use them to identify patterns, such as recurring degraded performance at certain times of day.

Manual checks

You can trigger a check at any time by clicking the Check Now button on an asset. This runs an immediate health check outside the regular interval.

API reference

MethodEndpointDescription
GET/portals/:id/assetsList all assets for a portal
POST/portals/:id/assetsCreate a new asset
GET/portals/:id/assets/:assetIdRetrieve a specific asset
PUT/portals/:id/assets/:assetIdUpdate an asset
DELETE/portals/:id/assets/:assetIdDelete an asset
POST/portals/:id/assets/:assetId/checkTrigger a manual health check
GET/portals/:id/assets/:assetId/logsRetrieve status logs
GET/portals/:id/assets/:assetId/incidentsRetrieve incidents