Listing Failing Checks: list_failing_checks

Service name: list_failing_checks

URL

https://SERVER/api/?apikey=yourAPItoken&service=list_failing_checks
&required_parameters=required_parameters
[&optional_parameters=optional_parameters]

Description

List all failing checks across all clients.

Parameters
Post Variable Description Type Required Options Default
describe Optional. Returns a description of the service. boolean no true 0
clientid Optional. Lists all failing checks for the specified Client. integer no 0 0

Using the clientid variable reduces the volume of data handled by the API call and minimizes the potential for timeout issues.

Where your account contains a large number of customers, we suggest using the per-Client clientid variable to avoid the possible timeout of the list_failing_checks API call.

Example Service Call - list_failing_checks

https://SERVER/api/?apikey=yourAPItoken&service=list_failing_checks

Example Response
<?xml version="1.0" ?> 
<result created="2009-09-24T12:28:44+01:00" host="SERVER" status="OK">
  <items>
   <client>
     <clientid>1234</clientid>
     <name>My Client</name>
     <site>
      <siteid>123</siteid>
      <name>My Site</name>
      <workstations>
        <workstation>
         <id>12</id>
         <name>My Workstation</name>
          [if device is offline]
         <offline>
           <description>offline - maintenance mode</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </offline>
         <failed_checks>
           <check>
             <checkid>23</checkid>
 <check_type>1012</check_type>

             <dsc_247>1</dsc_247>
             <description>Windows Service Check - Fax</description>
             <date>2010-01-28</date>
             <time>14:47:34</date>
             <formatted_output>Status: STOPPED</formatted_output>
<checkstatus>testerror</checkstatus>
           </check>
           ... more check nodes
         </failed_checks>
        </workstation>
        .... more nodes
      </workstations>
      <servers>
        <server>
         <id>12</id>
         <name>My Workstation</name>
          [if device is offline]
         <offline>
           <description>offline - maintenance mode</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </offline>
         [if device is overdue]
         <overdue>
           <description>Overdue</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </overdue>
         [if device is unreachable]
         <unreachable>
           <description>Site Unreachable</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </unreachable>
         <failed_checks>
           <check>
             <checkid>23</checkid>
<check_type>1012</check_type>
             <dsc_247>1</dsc_247>
             <description>Backup Check - Veritas Backup Exec v10.0</description>
             <date>2010-01-28</date>
             <time>14:47:34</date>
             <startdate>2009-11-19</startdate>
             <starttime>22:17:32</starttime>
             <formatted_output>Backup status can not be determined</formatted_output>
<checkstatus>testerror</checkstatus>
           </check>
           ... more check nodes
         </failed_checks>
        </server>
         ... more server node if any
      </servers>
     </site>
     ..... more site nodes
   </client>
    ..... more client nodes
  </items>
</result>
					
Example Service Call - list_failing_checks&clientid

https://SERVER/api/?apikey=yourAPItoken&service=list_failing_checks&clientid=[CLIENTID]

Example Response
<?xml version="1.0" ?> 
<result created="2009-09-24T12:28:44+01:00" host="SERVER" status="OK">
  <items>
   <client>
     <clientid>1234</clientid>
     <name>My Client</name>
     <site>
      <siteid>123</siteid>
      <name>My Site</name>
      <workstations>
        <workstation>
         <id>12</id>
         <name>My Workstation</name>
          [if device is offline]
         <offline>
           <description>offline - maintenance mode</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </offline>
         <failed_checks>
           <check>
             <checkid>23</checkid>
 <check_type>1012</check_type>

             <dsc_247>1</dsc_247>
             <description>Windows Service Check - Fax</description>
             <date>2010-01-28</date>
             <time>14:47:34</date>
             <formatted_output>Status: STOPPED</formatted_output>
<checkstatus>testerror</checkstatus>
           </check>
           ... more check nodes
         </failed_checks>
        </workstation>
        .... more nodes
      </workstations>
      <servers>
        <server>
         <id>12</id>
         <name>My Workstation</name>
          [if device is offline]
         <offline>
           <description>offline - maintenance mode</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </offline>
         [if device is overdue]
         <overdue>
           <description>Overdue</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </overdue>
         [if device is unreachable]
         <unreachable>
           <description>Site Unreachable</description>
           <startdate>2010-01-28</startdate>
           <starttime>14:47:34</starttime>
         </unreachable>
         <failed_checks>
           <check>
             <checkid>23</checkid>
<check_type>1012</check_type>
             <dsc_247>1</dsc_247>
             <description>Backup Check - Veritas Backup Exec v10.0</description>
             <date>2010-01-28</date>
             <time>14:47:34</date>
             <startdate>2009-11-19</startdate>
             <starttime>22:17:32</starttime>
             <formatted_output>Backup status can not be determined</formatted_output>
<checkstatus>testerror</checkstatus>
           </check>
           ... more check nodes
         </failed_checks>
        </server>
         ... more server node if any
      </servers>
     </site>
     ..... more site nodes
   </client>
  </items>
</result>
					
Fields Description
Field Type Can Be Empty Description
client/clientid integer no Unique identifier of client
client/name string no Name of the client
client/site/siteid integer no Unique identifier of site
client/site/name string no Name of site
client/site/workstations/workstation/id integer no Unique identifier of workstation
client/site/workstations/workstation/name string no Name of workstation
client/site/workstations/workstation/check/checkid integer no Unique identifier of a check
client/site/workstations/workstation/check/check_type integer no The type of check (see below section check_type)
client/site/workstations/workstation/check/dsc_247 integer no Is the check a Daily Safety Check, 24x7 Check, Scheduled Task or special case?
IndicatorCheck
1 24x7 check
2 Daily Safety Check
3 Scheduled Task
4 Managed Antivirus Check
6 Backup & Recovery Selected Size Check
client/site/workstations/workstation/check/description string no Check description
client/site/workstations/workstation/check/date date no Date of the last fail
client/site/workstations/workstation/check/time time no Time of the last fail
client/site/workstations/workstation/check/formatted_output string no Description of the problem
client/site/workstations/workstation/check/checkstatus string no Current Status of the Check
StateDashboard Equivalent
testok green tick
testerror red tick
testalertdelayed yellow tick
testcleared orange tick
test_inactive clear circle
testok_inactive clear tick
testerror_inactive clear cross
client/site/workstations/workstation/offline/description string no Description of offline status
client/site/workstations/workstation/offline/startdate date no Date since it is offline
client/site/workstations/workstation/offline/starttime time no Time since it is offline
client/site/servers/server/id integer no Unique identifier of server
client/site/servers/server/name string no Name of server
client/site/servers/server/offline/description string no Description of offline status
client/site/servers/server/offline/startdate date no Date since it is offline
client/site/servers/server/offline/starttime time no Time since it is offline
client/site/servers/server/overdue/description string no Description of overdue status
client/site/servers/server/overdue/startdate date no Date since it is overdue
client/site/servers/server/overdue/starttime time no Time since it is overdue
client/site/servers/server/unreachable/description string no Description of unreachable status
client/site/servers/server/unreachable/startdate date no Date since it is unreachable
client/site/servers/server/unreachable/starttime time no Time since it is unreachable
client/site/servers/server/check/checkid integer no Unique identifier of a check
client/site/servers/server/check/check_type integer no The type of check (see below section check_type)
client/site/servers/server/check/dsc_247 integer no Is the check a Daily Safety Check, 24x7 Check, Scheduled Task or special case?
Indicator Check
1 24x7 check
2 Daily Safety Check
3 Scheduled Task
4 Managed Antivirus Check
6 Backup & Recovery Selected Size Check
client/site/servers/server/check/description string no Check description
client/site/servers/server/check/date date no Date of the last fail
client/site/servers/server/check/time time no Time of the last fail
client/site/servers/server/check/startdate date no Date when check started failing
client/site/servers/server/check/starttime time no Time when check started failing
client/site/servers/server/check/formatted_output string no Description of the problem
client/site/servers/server/check/checkstatus string no Current Status of the Check
State Dashboard Equivalent
testok green tick
testerror red tick
testalertdelayed yellow tick
testcleared orange tick
test_inactive clear circle
testok_inactive clear tick
testerror_inactive clear cross
check_type integer no The type of check:
Windows
1001 Antivirus Update Check
1002 Backup Check    
1003 Drive Space Change Check  
1004 Disk Space Check
1005 Exchange Store Size  
1006 Failed Login Check*    
1007 Performance Monitoring Check
1008 Physical Disk Health Check
1009 Physical Memory Health Check - Deprecated
1010 PING Check    
1011 TCP Service Check  
1012 Web Page Check  
1013 Windows Service Check  
1014 Critical Events Check
1015 SNMP Check
1018 Bandwidth Monitoring
1019 File Size Check
1020 Event Log Check
1021 WSUS Check
1022 Auto-Start Service Check
1023 Script or Automated Task
1024 Script Check
1025 Patch Status Check (Vulnerability Check)
1026 Managed Antivirus Check (VIPRE)
1030 Backup & Recovery Selected Size Check
1033 Web Protection Bandwidth Check
1034 Managed Antivirus Check (Bitdefender)
Linux
2001 Antivirus Update Check
2002 Backup Check
2003 File System Space Change Check
2004 File System Space Check
2005 MTA Queue Length
2006 Failed Login Check *
2007 Performance Monitoring Check
2008 Physical Disk Health
2009 Physical Memory Health Check
2010 PING Check
2011 TCP Service Check
2012 Web Page Check
2013 Daemon Check
2015 SNMP Check
2018 Bandwidth Monitoring Check
2024 Script Check
2027 Process Check
2028 Log File Check
2029 MySQL Check
2031 Package Manager Check
Mac
3003 File System Space Change Check
3004 File System Space Check
3006 Failed Login Check *
3008 Physical Disk Health Check
3013 OS X Daemon Check
3014 Apple system Log Check
3021 OS X Update Check
3024 Script Check
3027 Process Check
3028 Log File Check
3034Managed Antivirus Check (Bitdefender)
3035Managed Antivirus Update Check (Bitdefender)
Example Associated Service Calls
Parameter Call URL Format
ClientID list_clients https://SERVER/api/?apikey=yourAPItoken&service=list_clients

* The Failed Login Check was previously known as the Hacker Check with this renamed in Dashboard v5.44.5 to more accurately reflect the Check's function.