Listing Servers

Use this API Call to query our Data Extraction API to extract data gathered by N-sight RMM.This section shows the service name and parameters needed in the API Call query, and provides examples of some queries and system responses. For more information, see Data Extraction API.

Service name: list_servers

URL

https://SERVER/api/?apikey=yourAPIkey&service=list_servers

&required_parameters=required_parameters

[&optional_parameters=optional_parameters]

Description

Lists all server monitoring devices for site (including top level asset information if available).

Parameters

Post Variable

Description

Type

Required

Options

Default

describe

Optional. Returns a description of the service.

boolean

no

true

0

siteid

The siteid must be a valid id.

integer

yes

0

0

Example Service Call =list_sites

https://SERVER/api/?apikey=yourAPIkey&service=list_servers&siteid=SITEID

Example Response

<?xml version="1.0" ?> 
 <result created="2015-07-20T14:02:22+01:00" host="SERVER" status="OK">
  <items>
   <server>
    <guid>94c8a376c690d94b73e66af3651866f4</guid> 
    <name>TANJA-DESKTOP</name> 
    <description>testing</description> 
    <install_date>2009-09-01</install_date> 
    <last_boot_time>1252483346</last_boot_time> 
    <dsc_active>1</dsc_active> 
    <atz_dst_date>0000-03-05:00T01:00:00</atz_dst_date> 
    <utc_apt>2015-07-20 16:11:48</utc_apt> 
    <utc_offset>-3600</utc_offset> 
    <user>SERVER\tanja </user> 
    <domain>test.local</domain> 
    <manufacturer>Dell Inc.</manufacturer> 
    <model>Vostro 220 Series</model> 
    <ip>192.168.200.42</ip> 
<external_ip>101.101.101.101</external_ip>
    <mac1>00:21:9B:16:ED:72</mac1> 
    <mac2 /> 
    <mac3 /> 
    <os>Microsoft® Windows <xxx>? Business</os> 
    <serverid>49324</serverid> 
    <agent_version>8_0_1</agent_version> 
 <agent_mode>0</agent_mode>
    <online>0</online> 
    <active_247>1</active_247> 
    <check_interval_247>5</check_interval_247> 
    <status_247>1</status_247> 
    <local_date_247>2009-09-09</local_date_247> 
    <local_time_247>17:11:48</local_time_247> 
    <utc_time_247>2009-09-09 16:11:50</utc_time_247> 
    <dsc_hour>6</dsc_hour> 
    <dsc_status>5</dsc_status> 
    <dsc_local_date>2009-09-09</dsc_local_date> 
    <dsc_local_time>09:09:36</dsc_local_time> 
    <dsc_utc_time>2009-09-09 08:09:37</dsc_utc_time> 
    <miss_factor_247>1.50</miss_factor_247> 
    <email_overdue_alert>1</email_overdue_alert> 
    <sms_overdue_alert>0</sms_overdue_alert> 
    <missed_247>0</missed_247> 
    <remote_connection_type>0</remote_connection_type> 
    <remote_address /> 
    <remote_port>0</remote_port> 
    <remote_username /> 
    <remote_domain /> 
    <tz_bias>0</tz_bias> 
    <tz_dst_bias>-60</tz_dst_bias> 
    <tz_std_bias>0</tz_std_bias> 
    <tz_mode>2</tz_mode> 
    <tz_dst_date>0000-03-05:00T01:00:00</tz_dst_date>
    <tz_std_date>0000-10-05:00T02:00:00</tz_std_date> 
    <assetid>59740</assetid> 
    <wins_name>TANJA-DESKTOP</wins_name> 
    <role>1</role> 
    <chassis_type>3</chassis_type> 
    <device_serial>DSLL74J</device_serial> 
    <processor_count>1</processor_count> 
    <total_memory>4294967296</total_memory> 
    <os_type>18</os_type> 
    <service_pack>1</service_pack> 
    <os_serial_number>12345-OEM-5678910-00012</os_serial_number> 
    <os_product_key>123A4-56BCD-EFGHI-7J8KL-MRNO9</os_product_key> 
    <last_scan_time>2015-07-19 10:52:00</last_scan_time> 
     <custom field name> custom value </custom fieldname>
   </server>
   ..... more <server> nodes ...
  </items>
</result>
					

Fields Description

Field

Type

Can Be Empty

Description

serverid

integer

no

Unique identifier of the monitored server.

guid

string

yes

The guid the monitored server uses to authenticate.

name

string

no

The name given to the monitored server.

description

string

yes

The description of the monitored server.

agent_version

string

yes

The version of the Advanced Monitoring Agent installed on monitored server.

install_date

date

no

The date the Advanced Monitoring Agent was installed on the monitored server.

last_boot_time

integer

yes

Timestamp of the last boot time of the monitored server.

online

integer (1 or 0)

no

Is server online or offline?

0

offline / maintenance mode

1

online

active_247

integer (1 or 0)

no

Are 24x7 checks running on server?

0

No

1

Yes

check_interval_247

integer

no

Interval for 24x7 checks (minutes)

status_247

integer

no

Status of 24x7 checks:

0

No checks run

1

Some checks failed

5

All checks passed

local_date_247

date

no

Date (on server) of last 24x7 Checks upload.

local_time_247

time

no

Time (on server) of last 24x7 Checks upload.

utc_time_247

datetime

yes

UTC date and time of last 24x7 Checks upload.

dsc_active

integer

no

Are Daily Safety Checks running on server?

0

No

1

Yes

agent_mode

integer

no

Agent Mode:

0

Server

dsc_hour

integer

no

Hour of day Daily Safety Checks are running.

dsc_status

integer

no

Status of DSC checks:

0

No checks run

1

Some checks failed

5

All checks passed

dsc_local_date

date

no

Date (on server) of last Daily Safety Checks upload.

dsc_local_time

time

no

Time (on server) of last Daily Safety Checks upload.

dsc_utc_time

datetime

yes

UTC date and time of last Daily Safety Checks upload.

miss_factor_247

float

no

Number of 24x7 check intervals without data before marking server as overdue.

email_overdue_alert

integer

no

Send email alert if server goes overdue?

0

No

1

Yes

sms_overdue_alert

integer

no

Send SMS alert if server goes overdue?

0

No

1

Yes

missed_247

integer

no

Has the server been marked as overdue?

0

No

1

Yes

remote_connection_type

integer

no

The type of remote desktop connection saved for server:

0

RDP

1

VNC

2

VNC Java Viewer

3

NetSupport Manager (IE only)

4

Remote Desktop Gateway (IE only)

remote_address

string

yes

The hostname or IP address for remote desktop connection saved for server.

remote_port

integer

yes

The port used to connect to server saved in remote desktop connection saved for server.

remote_username

string

yes

The username used to authenticate saved in remote desktop connection saved for server.

remote_domain

string

yes

The domain used to authenticate saved in remote desktop connection for server.

tz_bias

integer

yes

The offset in minutes from UTC time

tz_dst_bias

integer

yes

The daylight saving time offset in minutes

tz_std_bias

integer

yes

The standard time offset in minutes

tz_mode

integer

yes

The current time zone mode:

0

unknown

1

standard time

2

daylight saving time

atz_dst_date

string

yes

The date when daylight saving time begins

tz_dst_date

string

yes

The date when daylight saving time begins

tz_std_date

string

yes

The date when standard time begins

utc_apt

datetime

yes

The Agent perceived UTC time

utc_offset

integer

yes

The effective UTC offset in seconds

assetid

integer

yes

The servers unique physical asset identifier

wins_name

string

yes

The WINS name of the physical asset.

user

string

yes

The user logged onto the physical asset during scan.

domain

string

yes

The domain the physical asset is a member of.

role

string

yes

The role being performed by physical asset:

0, 1

Windows Workstation

2, 3, 4, 5

Windows Server

101

UNIX/Linux

102

Mac

103

Printer

104

Router

105

NAS

106

Other Network Device

other

Unknown

chassis_type

integer

yes

Chassis type (physical workstations only):

8, 9, 10, 11, 14

laptop

other

desktop

manufacturer

string

yes

The manufacturer of the physical asset.

model

string

yes

The model of the physical asset.

device_serial

string

yes

The serial number of the physical asset.

ip

string

yes

The IP address of the physical asset.

external_ip

string

yes

The external IP address of the last agent upload.

mac1

string

yes

The MAC address of the first NIC in the physical asset.

mac2

string

yes

The MAC address of the second NIC in the physical asset.

mac3

string

yes

The MAC address of the third NIC in the physical asset.

processor_count

integer

yes

The number of processors in the physical asset.

total_memory

integer

yes

The total memory (bytes) in the physical asset.

os_type

integer

no

Type of operating system installed.

os

string

yes

The operating system installed on the physical asset. Returns device.osversion if no as_device record.

service_pack

float

yes

The service pack installed on the physical asset.

os_serial_number

string

yes

The operating system serial number.

os_product_key

string

yes

The operating system product key.

last_scan_time

datetime

yes

The date and time of last asset scan.

custom field name

string

yes

The information entered in the Custom Field

Example Associated Service Calls
Parameter Call URL Format
SiteID list_sites https://SERVER/api/?apikey=yourAPIkey&service=list_sites&clientid=CLIENTID
ClientID list_clients https://SERVER/api/?apikey=yourAPIkey&service=list_clients