Help : Queries : Interface Counters
The form is accessed from the Query>Other>Interface Counters menu. Interface statistics queries are made using the URL /its/query/Interface. The following arguments are recognized:
Note: If the interface is omitted then all interfaces will be included. If the agent is omitted then all agents will be included.
agent
The IP address or domain name of the switch or router.
interface
The interface index (ifIndex) of the interface.
hour
The hours in the day to include. Hours are specified by the start of the hour (i.e. 0 = midnight to 1am and 23 = 11pm to midnight).
Hours can be included in lists, or in ranges.
| hour=9-16 | Work hours (9am to 5pm). |
| hour=17-8 | Non-work hours (5pm to 9am) |
| hour=12,13 | Lunch (Noon and 1pm hours) |
Hours are interpreted in conjunction with the selected time zone (see TZ).
day
The days of the week to include in the result. The values are:
| 1 | Sunday |
| 2 | Monday |
| 3 | Tuesday |
| 4 | Wednesday |
| 5 | Thursday |
| 6 | Friday |
| 7 | Saturday |
Days can be listed or included in ranges
| date=2-6 | Include only workdays (Mon-Fri). |
| date=7-1 | Include only weekend days (Sat-Sun). |
| date=3,5 | Include only Tuesdays and Thursdays. |
Days are interpreted in conjunction with the selected time zone (see TZ).
date
Dates and times are specified in the following formats:
| yyyymmdd | Includes all the hours in the specified date. |
| yyyymmddhh | Includes a specific hour. |
| today | All hours from midnight to current hour. |
| yesterday | All hours yesterday. |
| thisWeek | All hours from Midnight Sunday to current hour. |
| lastWeek | All hours last week. |
| thisMonth | All hours from start of month to current hour. |
| lastMonth | All hours last month. |
| lastHour | Last hour. |
| last24Hours | Last 24 hours. |
| last7Days | Last 7 days to current hour. |
| last30Days | Last 30 days to current hour. |
Times and dates are interpreted in conjunction with the selected time zone (see TZ).
Dates can be combined in a list or specified as ranges, for example:
date=19990901,19990905-1999091212
would include all the hours on 1-Sep-1999 and all the hours between midnight 5-Sep-1999 and noon 12-Sep-1999.
If the argument is omitted, then the hours since midnight today will be used.
TZ
The time zone used to interpret dates, times, days of week and hours. It is also the time zone used when returning date and time information in results.
Currently recognized time zones are:
| ID | Name | Offset from GMT |
|---|---|---|
| server | Time zone of the Traffic Server | |
| AET | Australia Eastern Time | 10 |
| AGT | Argentina Standard Time | -3 |
| ART | (Arabic) Egypt Standard Time | 2 |
| AST | Alaska Standard Time | -9 |
| BET | Brazil Eastern Time | -3 |
| BST | Bangladesh Standard Time | 6 |
| CAT | Central African Time | -1 |
| CST | Central Standard Time | -6 |
| CTT | China Standard Time | 8 |
| EAT | Eastern African Time | 3 |
| ECT | European Central Time | 1 |
| EET | Eastern European Time | 1 |
| EST | Eastern Standard Time | -5 |
| GMT | Greenwich Mean Time | 0 |
| HST | Hawaii Standard Time | -10 |
| IET | Indiana Eastern Standard Time | -5 |
| JST | Japan Standard Time | 9 |
| MIT | Midway Islands Time | -11 |
| MST | Mountain Standard Time | -7 |
| NET | Near East Time | 4 |
| NST | New Zealand Standard Time | 12 |
| PLT | Pakistan Lahore Time | 5 |
| PNT | Phoenix Standard Time | -7 |
| PST | Pacific Standard Time | -8 |
| SST | Solomon Standard Time | 11 |
| VST | Vietnam Standard Time | 7 |
Note: If the time zone is unspecified, it defaults to server.
groupPeriod
Create a time series using the specified grouping period. Recognized periods include:
- hour
- day
- week
- month
Leave blank or omit argument in order to aggregate over entire interval.
Intervals are interpreted in conjunction with the selected time zone (see TZ).
resultField
Results returned as a table containing whichever columns were requested using resultField:
| Category | Field | Description |
|---|---|---|
| Key Field | time | The time at the start of the interval. |
| seconds | The time at the start of the interval in seconds since 1 Jan 1970 GMT. | |
| agent | The IP address of the agent. | |
| interface | The ifIndex of the interface. | |
| Value Field | frames | Average frames/s. |
| framesTotal | Total frames. | |
| framesVariance | Variance of frames/s. | |
| framesSDEV | Standard deviation of frames/s. | |
| framesMin | Minimum frames/s. | |
| framesMax | Maximum frames/s. | |
| framesLower | Lower bound (95% confidence) of frames/s. | |
| framesUpper | Upper bound (95% confidence) of frames/s. | |
| bytes | Average bytes/s. | |
| bytesTotal | Total bytes. | |
| bytesVariance | Variance of bytes/s. | |
| bytesSDEV | Standard deviation of bytes/s. | |
| bytesMin | Minimum bytes/s. | |
| bytesMax | Maximum bytes/s. | |
| bytesLower | Lower bound (95% confidence) of bytes/s. | |
| bytesUpper | Upper bound (95%) confidence) of bytes/s. | |
| utilization | Average utilization. | |
| utilizationVariance | Variance of utilization. | |
| utilizationSDEV | Standard deviation of utilization. | |
| utilizationMin | Minimum utilization. | |
| utilizationMax | Maximum utilization. | |
| utilizationLower | Lower bound (95% confidence) of utilization. | |
| utilizationUpper | Upper bound (95%) confidence) of utilization. | |
| broadcasts | Average broadcasts/s. | |
| broadcastsTotal | Total broadcasts. | |
| broadcastsVariance | Variance of broadcasts/s. | |
| broadcastsSDEV | Standard deviation of broadcasts/s. | |
| broadcastsMin | Minimum broadcasts/s. | |
| broadcastsMax | Maximum broadcasts/s. | |
| broadcastsLower | Lower bound (95% confidence) of broadcasts/s. | |
| broadcastsUpper | Upper bound (95%) confidence) of broadcasts/s. | |
| multicasts | Average multicasts/s. | |
| multicastsTotal | Total multicasts. | |
| multicastsVariance | Variance of multicasts/s. | |
| multicastsSDEV | Standard deviation of multicasts/s. | |
| multicastsMin | Minimum multicasts/s. | |
| multicastsMax | Maximum multicasts/s. | |
| multicastsLower | Lower bound (95% confidence) of multicasts/s. | |
| multicastsUpper | Upper bound (95%) confidence) of multicasts/s. | |
| errors | Average errors/s. | |
| errorsTotal | Total errors. | |
| errorsVariance | Variance of errors/s. | |
| errorsSDEV | Standard deviation of errors/s. | |
| errorsMin | Minimum errors/s. | |
| errorsMax | Maximum errors/s. | |
| errorsLower | Lower bound (95% confidence) of errors/s. | |
| errorsUpper | Upper bound (95%) confidence) of errors/s. |
Note: The basic unit of measurement is a minute and statistics such as standard deviation represent the variability in the minute data over the aggregation interval.
Note: In the case of full duplex links counters can be extracted for each direction. For example, utilizationInMax gives the maximum utilization in the input direction and utilizationOutMax gives the maximum utilization in the output direction.
resultFormat
The following result formats are recognized:
- csv Returns a plain text table of results with each field separated by a comma.
- html Returns a formatted html table of results.
- debug Returns an html table containing the argument list, as well as a separate result table. Also provides a means of viewing error messages relating to improperly constructed queries.