CA App Synthetic Monitor API 24.7.7/24.7.7 : rule_log

Retrieve probe(s) from one account. Filter by specifying rule, folder, tags, date range, and/or name.

price: 1 api credit

parameter	type	default / required*	notes
nkey	token	*	Session key or token. Automatically assigned (only if optional) or obtained via acct_login/acct_token call.
acct	string		Account e-mail. If left empty, then the request is on behalf of the account that is logged in (nkey).
name	string (80)		Name of monitor (rule).
folder	string		Name of folder of a monitor (empty string is top level folder).
tags	string		Tag names, comma separated list.
tags_req	enum (any, all)	any
errorsonly	boolean	n
format	enum (xml, csv, xls, tab, stream, json)	xml	Output format for this call.
reverse	boolean	n	Reverse order in output of this call.
full	boolean	n	Return full log entry.
legacy_output	boolean	y	Output field in deprecated format.
start_date	date		Starting date, format YYYY-MM-DD.
end_date	date		End date, format YYYY-MM-DD.
cursor	unsigned int		Return results relative to last cursor returned.
uuid	string
num	unsigned int	50	Number of results to return.
source	unsigned int		Filter results by source location. Only applicable when 'name' is also specified..
callback	string		Callback function for JSONP style calls. When this parameter is given, the result will be JSON instead of XML.
view	enum (xml, json)	xml	Specifies the desirable representation of the output (XML or JSON). HTTP Accept header can be used and has precedence.

Result:

<result>
  <probes>
    <probe>
      <name> string (80) </name>
      <rid> unsigned int </rid>
      <deleted> boolean </deleted>
      <start> datetime </start>
      <end> datetime </end>
      <repeat> unsigned int </repeat>
      <result> unsigned int </result>
      <type> unsigned int </type>
      <descr> string </descr>
      <ttime> unsigned int </ttime>
      <rtime> unsigned int </rtime>
      <ctime> unsigned int </ctime>
      <ptime> unsigned int </ptime>
      <dtime> unsigned int </dtime>
      <dsize> unsigned int </dsize>
      <loc> string </loc>
      <source> unsigned int </source>
      <alerts> unsigned int </alerts>
      <id> unsigned int </id>
      <uuid> string </uuid>
      <output> string </output>
      <ipaddr> string </ipaddr>
    </probe>
    ...
  </probes>
  <cursor> unsigned int </cursor>
</result>

(presence of output fields depends on input parameters)

Error codes:

code	description
0	okay
1000	authentication error
1001	call syntax error
1002	undefined name or id
1003	account limit exceeded
1004	database error
1005	duplicate entry
1006	upgrade account
1007	not yours (anymore)
1008	session expired
1009	insufficient credits
1010	messaging error
1011	undefined result
1012	cannot perform that operation
1013	illegal parameter value
1014	TOS restriction
1015	unconfirmed address
1016	contact helpdesk first
9999	unsupported feature
1017	value not allowed

<<back to index