IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Administrator's Guide > Agent-based services > Agent Service Interface > Agent Service Interface - Service Interface Request

IBM Tivoli Monitoring, Version 6.3 Fix Pack 2

Agent Service Interface request - Agent monitoring statistics

Use the agent monitoring statistics command to request information about the monitoring agent activity.


Request input


Agent Service Interface <AGENTSTAT> request.

Tag Description
<AGENTSTAT> Specify Agent statistic request.
<SITUATION> Define situation selection properties.
<NAME> Specify the situation name or *ALL for all known situations. Default: *ALL
<DAYS> Optional. Specify the period to display, such as 1 for today's data. Up to 7 days history data can be retrieved.
<DETAILS> Optional. Yes – output hourly detail data
No- output state information only

Default: No

Sample request 1: Retrieve today's situation state statistics

    <AGENTSTAT>
  <SITUATION>
    <NAME>*ALL</NAME>
  </SITUATION>
</AGENTSTAT>

Sample request 2: Retrieve today's NT_Service_Error situation statistics

    <AGENTSTAT>
  <SITUATION>
    <NAME>NT_Service_Error</NAME>
    <DAYS>1</DAYS>
    <DETAILS>Y</DETAILS>
</SITUATION>
</AGENTSTAT>


Report output


Agent Service Interface <AGENTSTAT> request output.

Output tag Description
<TYPE> Situation type – Sample or Pure-Event.
<INTERVAL> Situation sample interval; or 0 – Pure-Event.
<ROWSIZE> Sample data row size.
<FIRSTSTARTTIME> The situation's initial start time.
<LASTSTARTTIME> The situation's most recent start time.
<LAST STOPTIME> The situation's last stop time.
<FIRSTEVENTTIME> The time that the situation first opened an event.
<LASTTRUETIME> The last time the situation evaluated to True.
<LASTFALSETIME> The last time the situation evaluated to False.
<TIMESRECYCLED> Number of times the situation restarted.
<TIMESAUTONOMOUS> Number of times the situation entered autonomous mode.
<DAY> Begin daily metrics.
<DATE> Date description.
<TRUESAMPLES> True sample row count.
<FALSESAMPLES> False sample row count.
<TRUERATIO> Percent of true samples.
<FALSERATIO> Percent of false samples.
<HOURROWS> Hourly sample row count.
<HOURTRUE> Hourly true sample row count.
<HOURFALSE> Hourly false sample row count.
<STATUS> Return status code bracketed by begin and end tag.

Sample output from sample request 2: The agent returns today's NT_Service_Error situation statistics

    <SITSTATS>
 <SITUATION>
  <NAME>NT_Service_Error</NAME> 
  <TYPE>Event</TYPE> 
  <INTERVAL>0</INTERVAL> 
  <ROWSIZE>3124</ROWSIZE> 
  <FIRSTSTARTTIME>Thu Mar 12 23:09:36 2009</FIRSTSTARTTIME> 
  <LASTSTARTTIME>NA</LASTSTARTTIME> 
  <LASTSTOPTIME>NA</LASTSTOPTIME> 
  <FIRSTEVENTTIME>NA</FIRSTEVENTTIME> 
  <LASTTRUETIME>NA</LASTTRUETIME> 
  <LASTFALSETIME>Fri Mar 13 22:53:31 2009</LASTFALSETIME> 
  <TIMESRECYCLED>0</TIMESRECYCLED> 
  <TIMESAUTONOMOUS>0</TIMESAUTONOMOUS> 
  <DAY>
    <DATE>Fri Mar 13 00:00:00 2009</DATE> 
    <TRUESAMPLES>0</TRUESAMPLES> 
    <FALSESAMPLES>80</FALSESAMPLES> 
    <TRUERATIO>0.00%</TRUERATIO> 
    <FALSERATIO>100.00%</FALSERATIO> 
    <HOURROWS>0 0 0 0 0 0 0 12 2 2 4 6 0 4 4 6 0 2 5 4 0 15 14 0
     </HOURROWS>
    <HOURTRUE>0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
     </HOURTRUE>
    <HOURFALSE>0 0 0 0 0 0 0 12 2 2 4 6 0 4 4 6 0 2 5 4 0 15 14 0
     </HOURFALSE>
  </DAY>
 </SITUATION>
</SITSTATS>


Parent topic:

Agent Service Interface - Service Interface Request

+

Search Tips   |   Advanced Search