REST API Developer's Guide

Get Instance-level Thresholds

You can use LogicMonitor's REST API to view instance level thresholds for a particular datasource.

Note: As with all of our API calls, authentication is required.

 

HTTP Method: GET

URI: /device/devices/{deviceId}/devicedatasources/{deviceDatasourceId}/instances/{instanceId}/alertsettings

Where:

  • {deviceId} is the id of the device you'd like to see thresholds for.  You can get group Ids from a GET request to the devices resource.
  • {deviceDatasourceId} is the id of the device datasource you'd like to see thresholds for.  You can get this Id by making a GET request to the device datasources resource
  • {instanceId} is the id of the instance you'd like to see thresholds for.  You can get this id by making a GET request to the instances resource

Request Parameters: You can include a fields parameter in your request to control what data is included in the response and how it is formatted:

Property

Syntax

Description

Example URI

fields fields={list of properties separated by commas} Filters the response to only include the following fields for each object /device/devices/9/devicedatasources/24/instances/10009/alertsettings?fields=dataPointName,alertExpr,disableAlerting

 

Example

The following Python script will return the thresholds for datapoints associated with device 56, device datasource 3320, instance 1469:

#!/bin/env python

import requests
import json
import hashlib
import base64
import time
import hmac

#Account Info
AccessId ='48v2wRzfK94y53sq5EuF'
AccessKey ='H_D9i(f5~B^U36^K6i42=^nS~e75gy382Bf6{)P+'
Company = 'api'

#Request Info
httpVerb ='GET'
resourcePath = '/device/devices/56/devicedatasources/3320/instances/1469/alertsettings'
queryParams =''
data = ''

#Construct URL 
url = 'https://'+ Company +'.logicmonitor.com/santaba/rest' + resourcePath +queryParams

#Get current time in milliseconds
epoch = str(int(time.time() * 1000))

#Concatenate Request details
requestVars = httpVerb + epoch + data + resourcePath

#Construct signature
signature = base64.b64encode(hmac.new(AccessKey,msg=requestVars,digestmod=hashlib.sha256).hexdigest())

#Construct headers
auth = 'LMv1 ' + AccessId + ':' + signature + ':' + epoch
headers = {'Content-Type':'application/json','Authorization':auth}

#Make request
response = requests.get(url, data=data, headers=headers)

#Print status and body of response
print 'Response Status:',response.status_code
print 'Response Body:',response.content