RPC API Developer's Guide

RPC API: Get Collector

Note that LogicMonitor does have an available REST API equivalent for this API call.

Collectors are used to gather data from your devices and send it to LogicMonitor. They are installed and run on a device within your infrastructure. The LogicMonitor API allows you to manage collectors programmatically.  With the geAgent and getAgents RPC API calls you can view details for your existing collectors.

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

 

getAgent

Retrieve details for one collector:

URL:
https://accountName.logicmonitor.com/santaba/rpc/getAgent?c=accountName&u=user&p=password&id=collectorId

 

Where collectorId is the Id of the collector you'd like to see details for.

 

getAgents

Retrieve details for all collectors:

URL:
https://accountName.logicmonitor.com/santaba/rpc/getAgents?c=accountName&u=user&p=password

 

All outputs will be in the format: { [status], [data], [errmsg] }, where status is the status of the response, errmsg is the error message associated with the response, and the data object includes the following:

Value

Description

nextRecipient The next recipient to be notified if the collector is in alert
clearSent Whether or not a clear notification was sent for the last alert, if there has been an alert
lastSentNotification The time (in epoch format) that the last noticiation was sent for this collector
netScanVersion The version of netscan configured for the collector
suppressAlertClear Whether or not notifications indicating that a collector alert has cleared should be suppressed
build The collector version
lastSentNotificationOnLocal The local date and time that the last notification was sent for this collector
id The collector id
resendIval How frequently alert notifications should be re-sent for this collector (until they are acknowledged)
watchdogUpdatedOn The last date and time the LogicMonitor Watchdog Service was updated
escalatingChainId The id of the escalation chain that alert notifications will be sent to for this colelctor
description The collector description
ackComment The comment submitted with the alert acknowledgement for this collector
updatedOn The time (in epoch format) that the collector was last updated
updatedOnLocal The local date and time that the collector was last updated
agentConf The configuration file for the collector
platform The platform the collector is compatible with (Linux or Windows)
ackedBy The user who acknowledged the alert for this collector, if there is one
isDown Whether or not the collector is down
escalatingChain The escalation chain configured for this collector
status The registration status of the collector. Status can be 0 | 1 | 2| 3:

0 : Unregistered collector
1 : Registered collector
2 : Stopped collector
3 : Suspended collector

ackedOn Whether or not a collector alert was acknowledged
confVersion The collector configuration file version
uptime The collector uptime
hostname The hostname for the device the collector is installed on
createdOnLocal The date and time the collector was added to your account
credential The collector credential, used for communicating with LogicMonitor
createdOn The time (in epoch format) the collector was added to your account
numOfHosts The number of hosts monitored by this collector
backupAgentId The Id of the backup (failover) collector, if one is configured
acked Whether or not there is a collector alert that is acknowlodged

 

Example

Request:
curl "https://apiAccount.logicmonitor.com/santaba/rpc/getAgent?c=apiAccount&u=apiUser&p=example&id=127"

 

Response:
{
  "status": 200,
  "data": {
    "nextRecipient": 0,
    "clearSent": true,
    "lastSentNotificationOn": 0,
    "netscanVersion": "0",
    "suppressAlertClear": "false",
    "build": "19000",
    "lastSentNotificationOnLocal": "",
    "id": 127,
    "resendIval": 15,
    "watchdogUpdatedOn": "2015-11-17 11:25:21 PST",
    "escalatingChainId": 0,
    "description": "eculler01.us-east-1.logicmonitor.net",
    "ackComment": "",
    "credential2": "",
    "updatedOn": 1447788350,
    "updatedOnLocal": "2015-11-17 11:25:50 PST",
    "agentConf": "                        #  Installer version, Shall not be modified\r\ninst......................",
    "platform": "linux",
    "ackedBy": "",
    "isDown": false,
    "escalatingChain": {
      "id": 0,
      "description": "",
      "ccdestination": "",
      "name": "No, I don't want to get collector down alerts",
      "destination": ""
    },
    "status": 1,
    "ackedOn": "",
    "confVersion": "1447694055",
    "uptime": 5865,
    "hostname": "eculler01.us-east-1.logicmonitor.net",
    "createdOnLocal": "2015-09-21 17:41:06 PDT",
    "credential": "N=4qV!)9",
    "createdOn": 1442882466,
    "backupAgentId": 0,
    "acked": false
  },
  "errmsg": "OK"
}