Description

Extract information about one or more Counters defined in the database.

Parameters (* denotes an optional parameter)

Ids*

An optional parameter used to specify that only counters applied to the specified objects should be returned. It is defined as a comma-separated list of object ids. If not present, only global counters, i.e.,  those that do not belong to a specific object, are returned.

Counter*

This optional string parameter contains the name of the counter to return. If not present, information on all counters defined in the database are returned.

NOTE: Use the command: http://demo.teradp.com/Tark4/do.ashx?Cmd=objslist&type=counter to retrieve the list of counters defined in the database.

Interval*

An optional parameter that specifies to return only counters with that defined interval.  Valid intervals are: DayVal, HourVal, MonthVal, TotalVal, WeekVal, YearVal. The default is TotalVal.

From*

Optional specification of starting date/time that is relevant ONLY when an interval has been specified. Uses a properly constructed date-time condition, e.g., cmd=counters&from=2009-12-04T12:04:00Z for GMT time, or cmd=counters&interval=&from=2009-12-04T01:04:00 to search by local system time.

To*

Optional specification of ending date/time that is relevant ONLY when an interval has been specified. Uses a properly constructed date-time condition, e.g., cmd=counters&to=2009-12-04T12:04:00Z for GMT time, or cmd=LoginData&to=2009-12-04T01:04:00 to search by local system time.

X*

This optional string parameter contains the name of an XSL transformation to be applied to the XML. The XSL transformation must be loaded in the database. Note that it is just inserted as an XML instruction and applied by the browser.

Example

Example 1: Return information on all counters in the database:

http://demo.teradp.com/Tark4/do.ashx?Cmd=counters

<?xml version="1.0" encoding="utf-8" ?>

<Counters

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns="http://www.teradp.com/schemas/GN4/1/Counter.xsd">

 <Object Id="0">

   <Counter Id="28597" Desc="EventNumber" N="70" />

   <Counter Id="28596" Desc="TaskNumber" N="3" />

</Object>

 

Example 2: Return all instances for which the counter 'GlobalImpresions' apply:

http://demo.teradp.com/Tark4/do.ashx?Cmd=counters&counter=GlobalImpressions

<?xml version="1.0" encoding="utf-8" ?>

<Counters

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns="http://www.teradp.com/schemas/GN4/1/Counter.xsd">

 <Object Id="28597">

   <Counter Id="46" Desc="globalimpressions" N="1" />

   <Counter Id="28554" Desc="globalimpressions" N="3" />

</Object>

</Counters>

 

Example 3: Return all counters that apply to object with id=27655:

http://demo.teradp.com/Tark4/do.ashx?Cmd=counters&ids=27655

<?xml version="1.0" encoding="utf-8" ?>

<Counters

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns="http://www.teradp.com/schemas/GN4/1/Counter.xsd">

 <Object Id="27655">

   <Counter Id="46" Desc="globalimpressions" N="1" />

</Object>

</Counters>

See also

IncCounters