MediaSwift MIB Guide R2

MediaSwift
MIB Guide
P/N D351009 R2
Important Notice
Important Notice
Allot Communications Ltd. ("Allot") is not a party to the purchase agreement under which NetEnforcer was purchased,
and will not be liable for any damages of any kind whatsoever caused to the end users using this manual, regardless of
the form of action, whether in contract, tort (including negligence), strict liability or otherwise.
SPECIFICATIONS AND INFORMATION CONTAINED IN THIS MANUAL ARE FURNISHED FOR
INFORMATIONAL USE ONLY, AND ARE SUBJECT TO CHANGE AT ANY TIME WITHOUT NOTICE, AND
SHOULD NOT BE CONSTRUED AS A COMMITMENT BY ALLOT OR ANY OF ITS SUBSIDIARIES. ALLOT
ASSUMES NO RESPONSIBILITY OR LIABILITY FOR ANY ERRORS OR INACCURACIES THAT MAY
APPEAR IN THIS MANUAL, INCLUDING THE PRODUCTS AND SOFTWARE DESCRIBED IN IT.
Please read the End User License Agreement and Warranty Certificate provided with this product before using the
product. Please note that using the products indicates that you accept the terms of the End User License Agreement and
Warranty Certificate.
WITHOUT DEROGATING IN ANY WAY FROM THE AFORESAID, ALLOT WILL NOT BE LIABLE FOR ANY
SPECIAL, EXEMPLARY, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND,
REGARDLESS OF THE FORM OF ACTION WHETHER IN CONTRACT, TORT (INCLUDING NEGLIGENCE),
STRICT LIABILITY OR OTHERWISE, INCLUDING, BUT NOT LIMITED TO, LOSS OF REVENUE OR
ANTICIPATED PROFITS, OR LOST BUSINESS, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
Copyright
Copyright © 1997-2010 Allot Communications. All rights reserved. No part of this document may be reproduced,
photocopied, stored on a retrieval system, transmitted, or translated into any other language without a written permission
and specific authorization from Allot Communications Ltd.
Trademarks
Products and corporate names appearing in this manual may or may not be registered trademarks or copyrights of their
respective companies, and are used only for identification or explanation and to the owners' benefit, without intent to
infringe.
Allot and the Allot Communications logo are registered trademarks of Allot Communications Ltd.
NOTE: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part
15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the
equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio
communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case
the user will be required to correct the interference at his own expense.
Changes or modifications not expressly approved by Allot Communication Ltd. could void the user's authority to operate
the equipment.
NPP User Guide iii

Important Notice
Version History
Doc Version Product Date
v2b1 MS3.0 21.11.10
iv MediaSwift MIB Guide

Table of Contents
Important Notice .................................................................................................................... iii
Table of Contents ..................................................................................................................... v
CHAPTER 1: OVERVIEW ................................................................................. 1-1
CHAPTER 2: CACHE HIT RATIO STATISTICS ............................................... 2-1

Cache Requests ..................................................................................................................... 2-1
Protocol State...................................................................................................................... 2-1
Cache Requests in Bytes ...................................................................................................... 2-2
Cache Requests Hits ............................................................................................................. 2-3
Protocol State...................................................................................................................... 2-4
Cache Requests Hits in Bytes .............................................................................................. 2-4
Requests Hit Ratio................................................................................................................ 2-5
Protocol State...................................................................................................................... 2-6
Bytes Hit Ratio...................................................................................................................... 2-7
CHAPTER 3: NETWORK TRAFFIC STATISTICS ........................................... 3-1

Incoming Traffic Bytes ........................................................................................................ 3-1
Incoming Traffic Bytes eDonkey Direction ....................................................................... 3-2
Incoming Traffic Bytes BitTorrent Direction ..................................................................... 3-2
Incoming Traffic Bytes Kazaa Direction ............................................................................ 3-3
Incoming Traffic Bytes Gnutella Direction ........................................................................ 3-3
Incoming Traffic Bytes Ares Direction .............................................................................. 3-3
Incoming Traffic Bytes HTTP Direction ............................................................................ 3-4
Incoming Traffic Bytes Non P2P Direction ....................................................................... 3-4
Incoming Traffic Bytes Other Direction............................................................................. 3-5
Incoming Traffic Packet ................................................................................................ 3-5
Incoming Traffic Packets eDonkey Direction .................................................................... 3-7
Incoming Traffic Packets Bittorrent Direction ................................................................... 3-7
Incoming Traffic Packets Kazaa Direction......................................................................... 3-8
Incoming Traffic Packets Gnutella Direction ..................................................................... 3-8
Incoming Traffic Packets Ares Direction ........................................................................... 3-9
Incoming Traffic Packets HTTP Direction......................................................................... 3-9
Incoming Traffic Packets Non P2P Direction .................................................................. 3-10
Incoming Traffic Packets Other Direction ....................................................................... 3-10
Outgoing Traffic Bytes....................................................................................................... 3-11
Outgoing Traffic Bytes eDonkey Direction ..................................................................... 3-12
Outgoing Traffic Bytes Bittorrent Direction .................................................................... 3-12
Outgoing Traffic Bytes Kazaa Direction .......................................................................... 3-13
Outgoing Traffic Bytes Gnutella Direction ...................................................................... 3-13
Outgoing Traffic Bytes Ares Direction ............................................................................ 3-13
Outgoing Traffic Bytes HTTP Direction .......................................................................... 3-14
Outgoing Traffic Bytes Non P2P Direction...................................................................... 3-14
Outgoing Traffic Bytes Other Direction ........................................................................... 3-15
Outgoing Traffic Packets ................................................................................................... 3-15
Outgoing Traffic Packets eDonkey Direction .................................................................. 3-16
MediaSwift MIB Guide v

Outgoing Traffic Packets Bittorrent Direction ................................................................. 3-17
Outgoing Traffic Packets Kazaa Direction ....................................................................... 3-17
Outgoing Traffic Packets Gnutella Direction ................................................................... 3-18
Outgoing Traffic Packets Ares Direction ......................................................................... 3-18
Outgoing Traffic Packets HTTP Direction ....................................................................... 3-19
Outgoing Traffic Packets Non P2P Direction .................................................................. 3-19
Outgoing Traffic Packets Other Direction ........................................................................ 3-20
CHAPTER 4: NETWORK CONNECTIONS STATISTICS ................................ 4-1

TCP Concurrent Connections ............................................................................................. 4-1
TCP Concurrent Connections eDonkey Direction.............................................................. 4-2
TCP Concurrent Connections Bittorrent Direction ............................................................ 4-3
TCP Concurrent Connections Kazaa Direction .................................................................. 4-3
TCP Concurrent Connections Gnutella Direction .............................................................. 4-4
TCP Concurrent Connections Ares Direction .................................................................... 4-4
TCP Concurrent Connections HTTP Direction .................................................................. 4-5
TCP Concurrent Connections Non P2P Direction.............................................................. 4-5
TCP Concurrent Connections Other Direction ................................................................... 4-6
TCP Concurrent Connections eDonkey Cache Out Link ................................................... 4-6
TCP Concurrent Connections BitTorrent Cache Out Link ................................................. 4-7
TCP Concurrent Connections Kazaa Cache Out Link........................................................ 4-7
TCP Concurrent Connections Gnutella Cache Out Link .................................................... 4-8
Tcp Concurrent Connections Ares Cache Out Link ........................................................... 4-9
TCP Concurrent Connections HTTP Cache Out Link........................................................ 4-9
CHAPTER 5: CACHED CONTENT STATISTICS ............................................. 5-1
CHAPTER 6: CONTENT DATABASE BY ACTION STATISTICS ................... 6-1
CHAPTER 7: MANAGEMENT .......................................................................... 7-1

Command Table ................................................................................................................... 7-2
Cache Engine Status Table .................................................................................................. 7-2
CHAPTER 8: TRAPS ........................................................................................ 8-1
CHAPTER 9: HARDWARE ............................................................................... 9-1

Volumes ................................................................................................................................. 9-1
Cache Engines....................................................................................................................... 9-2
Memory Statistics ............................................................................................................... 9-3
System Statistics ................................................................................................................. 9-6
Network Interfaces ............................................................................................................. 9-10
vi MediaSwift MIB Guide

MediaSwift MIB Guide vii
Chapter 1: Overview
This guide outlines and explains the SNMP fields that are available in the MediaSwift MIB.
In the following sections, “incoming” refers to traffic flowing into the MediaSwift, and “outgoing”
refers to traffic flowing out of the MediaSwift.
Incoming traffic might be originating either from the world or from subscribers. Outgoing traffic
might be destined either for the world or for subscribers. Outgoing traffic includes both incoming
traffic that is being forwarded as well as data that is being served from the cache.
All bandwidth statistics are specified in bits per second (bps). All packet statistics are specified in
packets per second (pps).
NOTE All statistics begin at 0 from when the system comes on line (in other words,
counting from system uptime).
MediaSwift MIB Guide 1-1

Chapter 2: Cache Hit Ratio Statistics
statistics  cacheHitRatio
Cache Requests
statistics  cacheHitRatio  cacheRequests
All elements are Read-only.
ELEMENT DESCRIPTION
cacheRequestsEdonkey The total number of processed eDonkey cache requests.
cacheRequestsBittorrent The total number of processed BitTorrent requests.
cacheRequestsKazaa The total number of processed Kazaa requests.
cacheRequestsGnutella The total number of processed Gnutella requests.
cacheRequestsAres The total number of processed Ares requests.
cacheRequestsHttp The total number of processed HTTP requests.
cacheRequestsThunder The total number of processed Thunder requests.
cacheRequestsThunderUdp The total number of processed Thunder UDP requests.
cacheRequestsInspect The total number of processed requests at a decision point

(hit or miss).
Protocol State
statistics  cacheHitRatio  cacheRequests  protocol  state
ELEMENT DESCRIPTION
cacheRequestsEdonkeyInspect The total number of processed decisions (served from

cache or not) to undertake for eDonkey protocol
requests.

ELEMENT DESCRIPTION
cacheRequestsBittorrentInspect The total number of processed decisions (served from

cache or not) to undertake for BitTorrent protocol
requests.
cacheRequestsKazaaInspect The total number of processed decisions (served from

cache or not) to undertake for Kazaa protocol requests.
cacheRequestsGnutellaInspect The total number of processed decisions (served from

cache or not) to undertake for Gnutella protocol
requests.
cacheRequestsAresInspect The total number of processed decisions (served from

cache or not) to undertake for Ares protocol requests.
cacheRequestsHttpInspect The total number of processed decisions (served from

cache or not) to undertake for HTTP protocol requests.
Cache Requests in Bytes

statistics  cacheHitRatio  cacheRequestsInBytes
ELEMENT DESCRIPTION
cacheBytesRequestedEdonkey The total number of bytes in processed eDonkey

protocol requests.
cacheBytesRequestedBittorrent The total number of bytes in processed BitTorrent

protocol requests.
cacheBytesRequestedKazaa The total number of bytes in processed Kazaa protocol

requests.
cacheBytesRequestedGnutella The total number of bytes in processed Gnutella

protocol requests.
cacheBytesRequestedAres The total number of bytes in processed Ares protocol

requests.
cacheBytesRequestedHttp The total number of bytes in processed HTTP protocol

requests.
cacheBytesRequestedThunder The total number of bytes in processed Thunder

protocol requests.
2-2 MediaSwift MIB Guide

ELEMENT DESCRIPTION
cacheBytesRequestedUdpThunder The total number of bytes in processed Thunder UDP

protocol requests.
Cache Requests Hits

statistics  cacheHitRatio  cacheRequestsHits
ELEMENT DESCRIPTION
cacheRequestsHitsEdonkey The total number of requests for eDonkey protocol served

from the cache.
cacheRequestsHitsBittorrent The total number of requests for BitTorrent protocol

served from the cache.
cacheRequestsHitsKazaa The total number of requests for Kazaa protocol served

from the cache.
cacheRequestsHitsGnutella The total number of requests for Gnutella protocol served

from the cache.
cacheRequestsHitsAres The total number of requests for Ares protocol served

from the cache.
cacheRequestsHitsHttp The total number of requests for HTTP protocol served

from the cache.
cacheRequestsHitsThunder The total number of requests for Thunder protocol served

from the cache.
cacheRequestsHitsThunderUdp The total number of requests for Thunder UDP protocol

served from the cache.
cacheRequestsHitsInspect The total number of requests served from the cache out of
the total number of requests (all protocols).

Protocol State
statistics  cacheHitRatio  cacheRequestsHits
cacheRequestsHitsProtocolState
ELEMENT DESCRIPTION
cacheRequestsHitsEdonkeyInspect The total number of hits for eDonkey protocol requests.
cacheRequestsHitsBittorrentInspect The total number of hits for BitTorrent protocol

requests.
cacheRequestsHitsKazaaInspect The total number of hits for Kazaa protocol requests.
cacheRequestsHitsGnutellaInspect The total number of hits for Gnutella protocol requests.
cacheRequestsHitsAresInspect The total number of hits for Ares protocol requests.
cacheRequestsHitsHttpInspect The total number of hits for HTTP protocol requests.
Cache Requests Hits in Bytes

statistics  cacheHitRatio  cacheRequestsHitsInBytes
ELEMENT DESCRIPTION
cacheBytesHitsEdonkey The total number of bytes in eDonkey packets served

from the cache.
cacheBytesHitsBittorrent The total number of bytes in BitTorrent packets served

from the cache.
cacheBytesHitsKazaa The total number of bytes in Kazaa packets served from

the cache.
cacheBytesHitsGnutella The total number of bytes in Gnutella packets served from

the cache.
cacheBytesHitsAres The total number of bytes in Ares packets served from the
cache.
cacheBytesHitsHttp The total number of bytes in HTTP packets served from

the cache.

ELEMENT DESCRIPTION
bytesRequestedThunderHitRatio The total number of bytes in Thunder packets served from

the cache.
bytesRequestedThunderUdpHitRatio The total number of bytes in Thunder UDP packets served

from the cache.
Requests Hit Ratio

statistics  cacheHitRatio  requestsHitRatio
ELEMENT DESCRIPTION
cacheRequestsEdonkeyHitRatio The ratio of the total number of eDonkey requests served

from the cache over the total number of eDonkey requests.
cacheRequestsBittorrentHitRatio The ratio of the total number of BitTorrent requests served

from the cache over the total of incoming or BitTorrent
requests.
cacheRequestsKazaaHitRatio The ratio of the total number of Kazaa requests served

from the cache over the total number of Kazaa requests.
cacheRequestsGnutellaHitRatio The ratio of the total number of Gnutella requests served

from the cache over the total number of Gnutella requests.
cacheRequestsAresHitRatio The ratio of the total number of Ares requests served from
the cache over the total number of Ares requests.
cacheRequestsHttpHitRatio The ratio of the total number of Http requests served from
the cache over the total number of Http requests.
firstCacheRequestsHitRatio The ratio of the total number of requests at a decision

point which were served from the cache over the total
number of requests at a decision point.

Protocol State
statistics  cacheHitRatio  requestsHitRatio
requestsHitsRatioProtocolState
ELEMENT DESCRIPTION
cacheRequestsEdonkeyHitRatioInspect The ratio of the total number of eDonkey requests at a

decision point which were served from the cache over
the total number of eDonkey requests at a decision
point.
cacheRequestsBittorrentHitRatioInspect The ratio of the total number of BitTorrent requests at

a decision point which were served from the cache
over the total number of BitTorrent requests at a
decision point.
cacheRequestsKazaaHitRatioInspect The ratio of the total number of Kazaa requests at a

the total number of Kazaa requests at a decision
point.
cacheRequestsGnutellaHitRatioInspect The ratio of the total number of Gnutella requests at a

the total number of Gnutella requests at a decision
point.
cacheRequestsAresHitRatioInspect The ratio of the total number of Ares requests at a

the total number of Ares requests at a decision point.
cacheRequestsHttpHitRatioInspect The ratio of the total number of HTTP requests at a

the total number of HTTP requests at a decision
point.

Bytes Hit Ratio
statistics  cacheHitRatio  bytesHitRatio
ELEMENT DESCRIPTION
bytesRequestedEdonkeyHitRatio The ratio of the total number of bytes in eDonkey

packets served from the cache over the total number
of bytes in subscribers-bound eDonkey packets.
bytesRequestedBittorrentHitRatio The ratio of the total number of bytes in BitTorrent

packets served from the cache over the total of bytes
in subscribers-bound BitTorrent packets.
bytesRequestedKazaaHitRatio The ratio of the total number of bytes in Kazaa

in subscriber-bound Kazaa packets.
bytesRequestedGnutellaHitRatio The ratio of the total number of bytes in Gnutella

in subscribers-bound Gnutella packets.
bytesRequestedAresHitRatio The ratio of the total number of bytes in Ares packets

served from the cache over the total number of bytes
in subscribers-bound Ares packets.
bytesRequestedHttpHitRatio The ratio of the total number of bytes in Http packets

served from the cache over the total number of bytes
in subscribers-bound Http packets.
BytesRequestedThunderHitRatio The ratio of the total number of bytes in Thunder

packets served from the cache over the total number
of bytes in subscribers-bound Thunder packets.
BytesRequestedThunderUdpHitRatio The ratio of the total number of bytes in Thunder

UDP packets served from the cache over the total
number of bytes in subscribers-bound Thunder
packets.

Chapter 3: Network Traffic Statistics
statistics  networkTraffic
Incoming Traffic Bytes

statistics  networkTraffic  incomingTrafficBytes
ELEMENT DESCRIPTION
incomingTrafficEdonkey Incoming eDonkey bandwidth.
incomingTrafficBittorrent Incoming BitTorrent bandwidth.
incomingTrafficKazaa Incoming Kazaa bandwidth.
incomingTrafficGnutella Incoming Gnutella bandwidth.
incomingTrafficAres Incoming Ares bandwidth.
incomingTrafficHttp Incoming HTTP bandwidth.
incomingTrafficThunder Incoming Thunder bandwidth.
incomingTrafficThunderUdp Incoming Thunder UDP bandwidth.
incomingTrafficNonp2p Incoming Non-P2P bandwidth.
incomingTrafficOther Incoming unclassified bandwidth.
incomingTrafficInspect The incoming bandwidth subjected to traffic inspection.
incomingTrafficCacheIn The incoming bandwidth that is being stored to cache.
incomingTrafficCacheout The incoming bandwidth of incoming requests or

acknowledgements for outbound cache traffic.
incomingTrafficForward The incoming transparently forwarded traffic.
incomingTrafficAppOther The incoming other bandwidth.
NOTE The sum of the above thirteen statistics should equal the sum of the following
three statistics.

ELEMENT DESCRIPTION
incomingTrafficW2Isp The incoming subscribers-bound bandwidth.
incomingTrafficIsp2W The incoming world-bound bandwidth.
incomingTrafficDirectionUnknown The incoming bandwidth of undetermined direction. No

P2P data is associated with these packets. Inspection
continues until their destination is determined.
Incoming Traffic Bytes eDonkey Direction

statistics  networkTraffic  incomingTrafficBytes 
incomingTrafficBytesProtocolDirection 
incomingTrafficBytesEdonkeyDirection
ELEMENT DESCRIPTION
incomingTrafficEdonkeyW2I The incoming eDonkey subscribers-bound bandwidth.
incomingTrafficEdonkeyI2W The incoming eDonkey world-bound bandwidth.
incomingTrafficEdonkeyUnknown The incoming eDonkey bandwidth of unknown direction.

No P2P data is associated with these packets. Inspection
Incoming Traffic Bytes BitTorrent Direction

incomingTrafficBytesProtocolDirection  t
ELEMENT DESCRIPTION
incomingTrafficBittorrentW2I The incoming BitTorrent subscribers-bound bandwidth.
incomingTrafficBittorrentI2W The incoming BitTorrent world-bound bandwidth.
incomingTrafficBittorrentUnknown The incoming BitTorrent bandwidth of unknown

destination. No P2P data is associated with these packets.
Inspection continues until their destination is determined.

Incoming Traffic Bytes Kazaa Direction
incomingTrafficBytesKazaaDirection
ELEMENT DESCRIPTION
incomingTrafficKazaaW2I The incoming Kazaa subscribers-bound bandwidth.
incomingTrafficKazaaI2W The incoming Kazaa world-bound bandwidth.
incomingTrafficKazaaUnknown The incoming Kazaa bandwidth of unknown destination.

Incoming Traffic Bytes Gnutella Direction

incomingTrafficBytesGnutellaDirection
ELEMENT DESCRIPTION
incomingTrafficGnutellaW2I The incoming Gnutellasubscribers-bound bandwidth.

incomingTrafficGnutellaI2W The incoming Gnutella world-bound bandwidth.
incomingTrafficGnutellaUnknown The incoming Gnutella bandwidth of unknown
destination. No P2P data is associated with these packets.
Inspection continues until their destination is determined.
Incoming Traffic Bytes Ares Direction

incomingTrafficBytesAresDirection
ELEMENT DESCRIPTION
incomingTrafficAresW2I The incoming Ares subscribers-bound bandwidth.
incomingTrafficAresI2W The incoming Ares world-bound bandwidth.

ELEMENT DESCRIPTION
incomingTrafficAresUnknown The incoming Ares bandwidth of unknown destination.

Incoming Traffic Bytes HTTP Direction

incomingTrafficBytesHttpDirection
ELEMENT DESCRIPTION
incomingTrafficHttpW2I The incoming Http subscribers-bound bandwidth.

incomingTrafficGHttp2W The incoming Http world-bound bandwidth.
incomingTrafficHttpUnknown The incoming Http bandwidth of unknown destination.
Incoming Traffic Bytes Non P2P Direction

incomingTrafficBytesNonp2pDirection
ELEMENT DESCRIPTION
incomingTrafficNonp2pW2I The incoming non-P2P subscribers-bound bandwidth.
incomingTrafficNonp2pI2W The incoming non-P2P world-bound bandwidth.
incomingTrafficNonp2pUnknown The incoming non-P2P bandwidth with unknown

destination.

Incoming Traffic Bytes Other Direction
incomingTrafficBytesOtherDirection
ELEMENT DESCRIPTION
incomingTrafficOtherW2I The incoming unclassified subscribers-bound

bandwidth.
incomingTrafficOtherI2W The incoming unclassified world-bound bandwidth.
incomingTrafficOtherUnknown The incoming unclassified bandwidth of unknown

destination.
Incoming Traffic Packet

statistics  networkTraffic  incomingTrafficPackets
ELEMENT DESCRIPTION
incomingPacketsEdonkey The total number of incoming eDonkey packets.
incomingPacketsBittorrent The total number of incoming BitTorrent packets.
incomingPacketsKazaa The total number of incoming Kazaa packets.
incomingPacketsGnutella The total number of incoming Gnutella packets.
incomingPacketsAres The total number of incoming Ares packets.
incomingPacketsHttp The total number of incoming Http packets.
incomingPacketsNonp2p The total number of incoming non-P2P packets.
incomingPacketsOther The total number of incoming unclassified packets.
NOTE The sum of the above eight statistics should equal the sum of the following five
statistics.

ELEMENT DESCRIPTION
incomingPacketsInspect The total number of incoming traffic-inspection

packets for any protocol.
incomingPacketsCacheIn The total number of incoming data packets that will

be cached for any protocol.
incomingPacketsCacheout The total number of incoming requests or

acknowledgements for outgoing data packets for any
protocol.
incomingPacketsForward The total number of incoming data packets that will

not be cached for any protocol.
incomingPacketsAppOther The total number of all other incoming packets for

any protocol.
NOTE The sum of the above five statistics should equal the sum of the following three
statistics.
ELEMENT DESCRIPTION
incomingPacketsW2Isp The total number of incoming packets originating

from the world and destined for local systems.
incomingPacketsIsp2W The total number of incoming packets originating

from local systems and destined for the world.
incomingPacketsDirectionUnknown The total number of incoming packets with unknown

destination. No P2P data is associated with these
packets. Inspection continues until their destination is
determined.

Incoming Traffic Packets eDonkey Direction
statistics  networkTraffic  incomingTrafficPackets 
incomingTrafficPacketsProtocolDirection 
incomingTrafficPacketsEdonkeyDirection
ELEMENT DESCRIPTION
incomingPacketsEdonkeyW2I The total number of incoming eDonkey packets

originating from the world and destined for local
systems.
incomingPacketsEdonkeyI2W The total number of incoming eDonkey packets

originating from local systems and destined for the
world.
incomingPacketsEdonkeyUnknown The total number of incoming eDonkey packets with

unknown destination. No P2P data is associated with
these packets. Inspection continues until their
destination is determined.
Incoming Traffic Packets Bittorrent Direction

incomingTrafficPacketsBittorrentDirection
ELEMENT DESCRIPTION
incomingPacketsBittorrentW2I The total number of incoming BitTorrent packets

systems.
incomingPacketsBittorrentI2W The total number of incoming BitTorrent packets

world.
incomingPacketsBittorrentUnknown The total number of incoming BitTorrent packets with


Incoming Traffic Packets Kazaa Direction
incomingTrafficPacketsKazaaDirection
ELEMENT DESCRIPTION
incomingPacketsKazaaW2I The total number of incoming Kazaa packets

systems.
incomingPacketsKazaaI2W The total number of incoming Kazaa packets

world.
incomingPacketsKazaaUnknown The total number of incoming Kazaa packets with

Incoming Traffic Packets Gnutella Direction

incomingTrafficPacketsGnutellaDirection
ELEMENT DESCRIPTION
incomingPacketsGnutellaW2I The total number of incoming Gnutella packets

systems.
incomingPacketsGnutellaI2W The total number of incoming Gnutella packets

world.
incomingPacketsGnutellaUnknown The total number of incoming Gnutella packets with


Incoming Traffic Packets Ares Direction
incomingTrafficPacketsAresDirection
ELEMENT DESCRIPTION
incomingPacketsAresW2I The total number of incoming Ares packets

systems.
incomingPacketsAresI2W The total number of incoming Ares packets

world.
incomingPacketsAresUnknown The total number of incoming Ares packets with

Incoming Traffic Packets HTTP Direction

incomingTrafficPacketsHttpDirection
ELEMENT DESCRIPTION
incomingPacketsHttpW2I The total number of incoming Http packets

systems.
incomingPacketsHttpI2W The total number of incoming Http packets

world.
incomingPacketsHttpUnknown The total number of incoming Http packets with


Incoming Traffic Packets Non P2P Direction
incomingTrafficPacketsNonp2pDirection
ELEMENT DESCRIPTION
incomingPacketsNonp2pW2I The total number of incoming non-P2P packets

systems.
incomingPacketsNonp2pI2W The total number of incoming non-P2P packets

world.
incomingPacketsNonp2pUnknown The total number of incoming non-P2P packets with

unknown destination.
Incoming Traffic Packets Other Direction

incomingTrafficPacketsOtherDirection
ELEMENT DESCRIPTION
incomingPacketsOtherW2I The total number of incoming unclassified packets

systems.
incomingPacketsOtherI2W The total number of incoming unclassified packets

world.
incomingPacketsOtherUnknown The total number of incoming unclassified packets

with unknown destination.

Outgoing Traffic Bytes
statistics  networkTraffic  outgoingTrafficBytes
ELEMENT DESCRIPTION
outgoingTrafficEdonkey The outgoing eDonkey bandwidth.
outgoingTrafficBittorrent The outgoing BitTorrent bandwidth.
outgoingTrafficKazaa The outgoing Kazaa bandwidth.
outgoingTrafficGnutella The outgoing Gnutella bandwidth.
outgoingTrafficAres The outgoing Ares bandwidth.
outgoingTrafficHttp The outgoing Http bandwidth.
outgoingTrafficNonp2p The outgoing non-P2P bandwidth.
outgoingTrafficOther The outgoing unclassified bandwidth.
statistics.
ELEMENT DESCRIPTION
outgoingTrafficInspect The outgoing bandwidth that is subjected to traffic

inspection.
outgoingTrafficCacheIn The outgoing bandwidth that will be cached for any

protocol.
outgoingTrafficCacheout The outgoing bandwidth originating from the cache.
outgoingTrafficForward The outgoing transparently forwarded bandwidth.
outgoingTrafficAppOther The outgoing other bandwidth.
statistics.

ELEMENT DESCRIPTION
outgoingTrafficW2Isp The outgoing subscribers-bound bandwidth.
outgoingTrafficIsp2W The outgoing world-bound bandwidth.
outgoingTrafficDirectionUnknown The outgoing bandwidth of unknown destination.
Outgoing Traffic Bytes eDonkey Direction

statistics  networkTraffic  outgoingTrafficBytesProtocolDirection 
outgoingTrafficBytesEdonkeyDirection
ELEMENT DESCRIPTION
outgoingTrafficEdonkeyW2I The outgoing subscribers-bound eDonkey bandwidth.
outgoingTrafficEdonkeyI2W The outgoing world-bound eDonkey bandwidth.
outgoingTrafficEdonkeyUnknown The outgoing eDonkey bandwidth of unknown

destination.
Outgoing Traffic Bytes Bittorrent Direction

statistics  networkTraffic  outgoingTrafficBytesProtocolDirection
 outgoingTrafficBytesBittorrentDirection
ELEMENT DESCRIPTION
outgoingTrafficBittorrentW2I The outgoing subscribers-bound BitTorrent

bandwidth.
outgoingTrafficBittorrentI2W The outgoing world-bound BitTorrent bandwidth.
outgoingTrafficBittorrentUnknown The outgoing BitTorrent bandwidth of unknown

destination

Outgoing Traffic Bytes Kazaa Direction
 outgoingTrafficBytesKazaaDirection
ELEMENT DESCRIPTION
outgoingTrafficKazaaW2I The outgoing subscribers-bound Kazaa bandwidth.
outgoingTrafficKazaaI2W The outgoing world-bound Kazaa bandwidth.
outgoingTrafficKazaaUnknown The outgoing Kazaa bandwidth of unknown

destination.
Outgoing Traffic Bytes Gnutella Direction

 outgoingTrafficBytesGnutellaDirection
ELEMENT DESCRIPTION
outgoingTrafficGnutellaW2I The outgoing subscribers-bound Gnutella bandwidth.
outgoingTrafficGnutellaI2W The outgoing world-bound Gnutella bandwidth.
outgoingTrafficGnutellaUnknown The outgoing Gnutella bandwidth of unknown

destination.
Outgoing Traffic Bytes Ares Direction

 outgoingTrafficBytesAresDirection
ELEMENT DESCRIPTION
outgoingTrafficAresW2I The outgoing subscribers-bound Ares bandwidth.
outgoingTrafficAresI2W The outgoing world-bound Ares bandwidth.

ELEMENT DESCRIPTION
outgoingTrafficAresUnknown The outgoing Ares bandwidth of unknown

destination.
Outgoing Traffic Bytes HTTP Direction

 outgoingTrafficBytesHttpDirection
ELEMENT DESCRIPTION
outgoingTrafficHttpW2I The outgoing subscribers-bound Http bandwidth.
outgoingTrafficHttpI2W The outgoing world-bound Http bandwidth.
outgoingTrafficHttpUnknown The outgoing Http bandwidth of unknown

destination.
Outgoing Traffic Bytes Non P2P Direction

 outgoingTrafficBytesNonp2pDirection
ELEMENT DESCRIPTION
outgoingTrafficNonp2pW2I The outgoing subscribers-bound non-P2P bandwidth.
outgoingTrafficNonp2pI2W The outgoing world-bound non-P2P bandwidth.
outgoingTrafficNonp2pUnknown The outgoing non-P2P bandwidth of unknown

destination.

Outgoing Traffic Bytes Other Direction
 outgoingTrafficBytesOtherDirection
ELEMENT DESCRIPTION
outgoingTrafficOtherW2I The outgoing subscribers-bound unclassified

bandwidth.
outgoingTrafficOtherI2W The outgoing world-bound unclassified bandwidth.
outgoingTrafficOtherUnknown The outgoing unclassified bandwidth of unknown

destination.
Outgoing Traffic Packets

statistics  networkTraffic  outgoingTrafficPackets
ELEMENT DESCRIPTION
outgoingPacketsEdonkey The total number of outgoing eDonkey packets.
outgoingPacketsBittorrent The total number of outgoing BitTorrent packets.
outgoingPacketsKazaa The total number of outgoing Kazaa packets.
outgoingPacketsGnutella The total number of outgoing Gnutella packets.
outgoingPacketsAres The total number of outgoing Ares packets.
outgoingPacketsHttp The total number of outgoing Http packets.
outgoingPacketsNonp2p The total number of outgoing non-P2P packets.
outgoingPacketsOther The total number of outgoing unclassified packets.
statistics.

ELEMENT DESCRIPTION
outgoingPacketsInspect The total number of acknowledgements for outgoing

traffic-inspection packets for any protocol.
outgoingPacketsCacheIn The total number of outgoing acknowledgements of

data packets that will be cached for any protocol.
outgoingPacketsCacheout The total number of outgoing data packets originating

from the cache for any protocol.
outgoingPacketsForward The total number of outgoing data packets that were

forwarded for any protocol.
outgoingPacketsAppOther The total number of all other outgoing packets for any
protocol.
statistics.
ELEMENT DESCRIPTION
outgoingPacketsW2Isp The total number of outgoing packets originating

outgoingPacketsIsp2W The total number of outgoing packets originating

outgoingPacketsDirectionUnknown The total number of outgoing packets with unknown

destination.
Outgoing Traffic Packets eDonkey Direction

statistics  networkTraffic  outgoingTrafficPackets 
outgoingTrafficPacketsProtocolDirection 
outgoingTrafficPacketsEdonkeyDirection
ELEMENT DESCRIPTION
outgoingPacketsEdonkeyW2I The total number of outgoing eDonkey packets

systems.

ELEMENT DESCRIPTION
outgoingPacketsEdonkeyI2W The total number of outgoing eDonkey packets

world.
outgoingPacketsEdonkeyUnknown The total number of outgoing eDonkey packets with

Outgoing Traffic Packets Bittorrent Direction

outgoingTrafficPacketsBittorrentDirection
ELEMENT DESCRIPTION
outgoingPacketsBittorrentW2I The total number of outgoing BitTorrent packets

systems.
outgoingPacketsBittorrentI2W The total number of outgoing BitTorrent packets

world.
outgoingPacketsBittorrentUnknown The total number of outgoing BitTorrent packets with

Outgoing Traffic Packets Kazaa Direction

outgoingTrafficPacketsKazaaDirection
ELEMENT DESCRIPTION
outgoingPacketsKazaaW2I The total number of outgoing Kazaa packets

systems.
outgoingPacketsKazaaI2W The total number of outgoing Kazaa packets

world.

ELEMENT DESCRIPTION
outgoingPacketsKazaaUnknown The total number of outgoing Kazaa packets with

Outgoing Traffic Packets Gnutella Direction

outgoingTrafficPacketsGnutellaDirection
ELEMENT DESCRIPTION
outgoingPacketsGnutellaW2I The total number of outgoing Gnutella packets

systems.
outgoingPacketsGnutellaI2W The total number of outgoing Gnutella packets

world.
outgoingPacketsGnutellaUnknown The total number of outgoing Gnutella packets with

Outgoing Traffic Packets Ares Direction

outgoingTrafficPacketsAresDirection statistics  networkTraffic 
outgoingTrafficPackets  outgoingTrafficPacketsProtocolDirection 
outgoingTrafficPacketsAresDirection
ELEMENT DESCRIPTION
outgoingPacketsAresW2I The total number of outgoing Ares packets

systems.
outgoingPacketsAresI2W The total number of outgoing Ares packets

world.
outgoingPacketsAresUnknown The total number of outgoing Ares packets with


Outgoing Traffic Packets HTTP Direction
outgoingTrafficPacketsHttpDirection
ELEMENT DESCRIPTION
outgoingPacketsHttpW2I The total number of outgoing Http packets originating

outgoingPacketsHttpI2W The total number of outgoing Http packets originating

outgoingPacketsHttpUnknown The total number of outgoing Http packets with

Outgoing Traffic Packets Non P2P Direction

outgoingTrafficPacketsNonp2pDirection
ELEMENT DESCRIPTION
outgoingPacketsNonp2pW2I The total number of outgoing non-P2P packets

systems.
outgoingPacketsNonp2pI2W The total number of outgoing non-P2P packets

world.
outgoingPacketsNonp2pUnknown The total number of outgoing non-P2P packets with


Outgoing Traffic Packets Other Direction
outgoingTrafficPacketsOtherDirection
ELEMENT DESCRIPTION
outgoingPacketsOtherW2I The total number of outgoing unclassified packets

systems.
outgoingPacketsOtherI2W The total number of outgoing unclassified packets

world.
outgoingPacketsOtherUnknown The total number of outgoing unclassified packets

with unknown destination.

Chapter 4: Network Connections Statistics
statistics  networksConnections
TCP Concurrent Connections

statistics  networksConnections  tcpConcurrentConnections
ELEMENT DESCRIPTION
concurrentTcpConnectionEdonkey The total number of concurrent connections for

eDonkey traffic.
concurrentTcpConnectionBittorrent The total number of concurrent connections for

BitTorrent traffic.
concurrentTcpConnectionKazaa The total number of concurrent connections for Kazaa

traffic.
concurrentTcpConnectionGnutella The total number of concurrent connections for

Gnutella traffic.
concurrentTcpConnectionAres The total number of concurrent connections for Ares

traffic.
concurrentTcpConnectionHttp The total number of concurrent connections for Http

traffic.
concurrentTcpConnectionNonp2p The total number of concurrent connections for non-

P2P traffic.
concurrentTcpConnectionOther The total number of concurrent connections for other

traffic.
statistics.
ELEMENT DESCRIPTION
concurrentTcpConnectionInspect The total number of concurrent connections

performing traffic inspection.

ELEMENT DESCRIPTION
concurrentTcpConnectionCacheIn The total number of concurrent connections sending

data that will be cached.
concurrentTcpConnectionCacheout The total number of concurrent connections that

involve serving data from the cache.
concurrentTcpConnectionForward The total number of concurrent connections that

involve forwarding data that will not be cached.
concurrentTcpConnectionAppOther The total number of all other types of concurrent

connections.
TCP Concurrent Connections eDonkey Direction

statistics  networksConnections  tcpConcurrentConnections 
tcpConcurrentConnectionsProtocolDirection 
tcpConcurrentConnectionsEdonkeyDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionEdonkeyW2I The total number of concurrent connections for

eDonkey traffic where data is being sent from the
world and destined for local systems.
concurrentTcpConnectionEdonkeyI2W The total number of concurrent connections for

eDonkey traffic where data is being sent from local
systems and destined for the world.
concurrentTcpConnectionEdonkeyUnknown The total number of concurrent connections for

eDonkey data transfer direction is yet undetermined.

TCP Concurrent Connections Bittorrent Direction
tcpConcurrentConnectionsBittorrentDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionBittorrentW2I The total number of concurrent connections for

BitTorrent traffic where data is being sent from the
concurrentTcpConnectionBittorrentI2W The total number of concurrent connections for

BitTorrent traffic where data is being sent from local
concurrentTcpConnectionBittorrentUnknown The total number of concurrent connections for

BitTorrent traffic where data transfer direction is yet
undetermined.
TCP Concurrent Connections Kazaa Direction

tcpConcurrentConnectionsKazaaDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionKazW2I The total number of concurrent connections for Kazaa

traffic where data is being sent from the world and
destined for local systems.
concurrentTcpConnectionKazaaI2W The total number of concurrent connections for Kazaa

traffic where data is being sent from local systems
and destined for the world.
concurrentTcpConnectionKazaaUnknown The total number of concurrent connections for Kazaa

traffic where data transfer direction is yet
undetermined.

TCP Concurrent Connections Gnutella Direction
tcpConcurrentConnectionsGnutellaDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionGnutellaW2I The total number of concurrent connections for

Gnutella traffic where data is being sent from the
concurrentTcpConnectionGnutellaI2W The total number of concurrent connections for

Gnutella traffic where data is being sent from local
concurrentTcpConnectionGnutellaUnknown The total number of concurrent connections for

Gnutella traffic where data transfer direction is yet
undetermined.
TCP Concurrent Connections Ares Direction

tcpConcurrentConnectionsAresDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionAresW2I The total number of concurrent connections for Ares

concurrentTcpConnectionAresI2W The total number of concurrent connections for Ares

concurrentTcpConnectionAresUnknown The total number of concurrent connections for Ares

undetermined.

TCP Concurrent Connections HTTP Direction
tcpConcurrentConnectionsHttpDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionHttpW2I The total number of concurrent connections for Http

concurrentTcpConnectionHttpI2W The total number of concurrent connections for Http

concurrentTcpConnectionHttpUnknown The total number of concurrent connections for Http

undetermined.
TCP Concurrent Connections Non P2P Direction

tcpConcurrentConnectionsNonp2pDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionNonp2pW2I The total number of concurrent connections for non-

P2P traffic where data is being sent from the world
and destined for local systems.
concurrentTcpConnectionNonp2pI2W The total number of concurrent connections for non-

P2P traffic where data is being sent from local
concurrentTcpConnectionNonp2pUnknown The total number of concurrent connections for non-

P2P traffic where data transfer direction is yet
undetermined.

TCP Concurrent Connections Other Direction
tcpConcurrentConnectionsOtherDirection
ELEMENT DESCRIPTION
concurrentTcpConnectionOtherW2I The total number of concurrent connections for

unclassified traffic where data is being sent from the
concurrentTcpConnectionOtherI2W The total number of concurrent connections for

unclassified traffic where data is being sent from local
concurrentTcpConnectionOtherUnknown The total number of concurrent connections for

unclassified traffic where no P2P data is associated
with these packets. Inspection continues until the
TCP Concurrent Connections eDonkey Cache Out Link

tcpConcurrentConnectionsProtocolStateDirection
tcpConcurrentConnectionsEdkStateLink
tcpConcurrentConnectionsEdkCacheOutLink
ELEMENT DESCRIPTION
concurrentTcpConnectionsEdonkeyCacheOutW2I The total number of concurrent

connections served from the cache for
eDonkey traffic where data is being sent
from the world and destined for local
systems.
concurrentTcpConnectionsEdonkeyCacheOutI2W The total number of concurrent

eDonkey traffic where data is being sent
from local systems and destined for the
world.

ELEMENT DESCRIPTION
concurrentTcpConnectionsEdonkeyCacheOutUnknown The total number of concurrent

eDonkey traffic where data transfer
direction is yet undetermined.
TCP Concurrent Connections BitTorrent Cache Out Link

tcpConcurrentConnectionsBtStateLink
tcpConcurrentConnectionsBtCacheOutLink
ELEMENT DESCRIPTION
concurrentTcpConnectionsBtCacheOutW2I The total number of concurrent connections

served from the cache for BitTorrent traffic
where data is being sent from the world and
concurrentTcpConnectionsBtCacheOutI2W The total number of concurrent connections

where data is being sent from local systems and
destined for the world.
concurrentTcpConnectionsBtCacheOutUnknown The total number of concurrent connections

where data transfer direction is yet
undetermined.
TCP Concurrent Connections Kazaa Cache Out Link

tcpConcurrentConnectionsKazStateLink
tcpConcurrentConnectionsKazCacheOutLink
ELEMENT DESCRIPTION
concurrentTcpConnectionsKazCacheOutW2I The total number of concurrent connections

served from the cache for Kazaa traffic where
data is being sent from the world and destined
for local systems.

ELEMENT DESCRIPTION
concurrentTcpConnectionsKazCacheOutI2W The total number of concurrent connections

data is being sent from local systems and
concurrentTcpConnectionsKazCacheOutUnknown The total number of concurrent connections

data transfer direction is yet undetermined.
TCP Concurrent Connections Gnutella Cache Out Link

tcpConcurrentConnectionsGnutlStateLink
tcpConcurrentConnectionsGnutlCacheOutLink
ELEMENT DESCRIPTION
concurrentTcpConnectionsGnutlCacheOutW2I The total number of concurrent connections

served from the cache for Gnutella traffic
where data is being sent from the world and
concurrentTcpConnectionsGnutlCacheOutI2W The total number of concurrent connections

where data is being sent from local systems
concurrentTcpConnectionsGnutlCacheOutUnknown The total number of concurrent connections

where data transfer direction is yet
undetermined.

Tcp Concurrent Connections Ares Cache Out Link
tcpConcurrentConnectionsAresStateLink
tcpConcurrentConnectionsAresCacheOutLink
ELEMENT DESCRIPTION
concurrentTcpConnectionsAresCacheOutW2I The total number of concurrent connections

served from the cache for Ares traffic where
data is being sent from the world and
concurrentTcpConnectionsAresCacheOutI2W The total number of concurrent connections

concurrentTcpConnectionsAresCacheOutUnknown The total number of concurrent connections

TCP Concurrent Connections HTTP Cache Out Link

tcpConcurrentConnectionsHttpStateLink
tcpConcurrentConnectionsHttpCacheOutLink
ELEMENT DESCRIPTION
concurrentTcpConnectionsHttpCacheOutW2I The total number of concurrent connections

served from the cache for HTTP traffic where
data is being sent from the world and
concurrentTcpConnectionsHttpCacheOutI2W The total number of concurrent connections

concurrentTcpConnectionsHttpCacheOutUnknown The total number of concurrent connections


Chapter 5: Cached Content Statistics
statistics  cacheStatus
ELEMENT DESCRIPTION
cacheTotalHashes The total number of unique files stored in the cache.
cacheTotalSize The total size of all files stored in the cache.
cacheEdonkeySize The total size of all eDonkey files stored in the cache.
cacheBittorrentSize The total size of all BitTorrent files stored in the

cache.
cacheKazaaSize The total size of all Kazaa files stored in the cache.
cacheGnutellaSize The total size of all Gnutella files stored in the cache.
cacheAresSize The total size of all Ares files stored in the cache.
cacheHttpSize The total size of all Http files stored in the cache.
cacheEdonkeyHashes The total number of unique eDonkey files stored in

the cache.
cacheBittorrentHashes The total number of unique BitTorrent files stored in

the cache.
cacheKazaaHashes The total number of unique Kazaa files stored in the

cache.
cacheGnutellaHashes The total number of unique Gnutella files stored in

the cache.
cacheAresHashes The total number of unique Ares files stored in the

cache.
cacheHttpHashes The total number of unique Http files stored in the

cache.

Chapter 6: Content Database by Action
Statistics
statistics  peerappContentDb byAction
ELEMENT DESCRIPTION
blockedUrls The total number of urls that where blocked by filters.
allowedUrls The total number of urls that where allowed by filters

redirectedUtls The total number of urls that where redirected by

filters
bypassedUrls The total number of urls that where bypass the filters.

Chapter 7: Management
The following table affects the management. The elements are used either to read system status
information or to issue system commands.
ELEMENT DESCRIPTION
Note: The following element is Read/Write.
clusterControl Used to display the status of a command or to run a

command.
For reading:
0: a started command
1: a stopped command
2: a restart command
When written to, the command that is written is
executed.
Note: The following elements are Read-only.
clusterOpStatus Indicates server state.

1: disabled
2: enabled
3: degraded
clusterUptime Indicates server uptime.
clusterLeader Currently only ce-1

When Allot products with load sharing are supported,
it will indicate the MediaSwift server number of the
“MediaSwift leader”, which is the host with the
earliest uptime. The value is returned as ce-<#>,
where <#> is the MediaSwift server number.
clusterMembers Always takes the value 1.

In future versions, it will represent the number of
operational MediaSwift Server.

Command Table
management  commandTable
The following elements affect the host.
ELEMENT DESCRIPTION
Note: The following element is Read-only.
cacheEngineIndex ce-1
Note: The following elements are Read/Write.
command Used to display the last issued command or to run a

command that affects a specific blade.
For writing:
1: stop
2: start
3: restart
When read, returns the last command that was issued.
logLevel Unavailable
Cache Engine Status Table

management  cacheEngineStatusTable
The following table returns the information about Cache Engine status. All elements are Read-
only.
ELEMENT DESCRIPTION
cacheEngineStatusIndex ce-1
cacheEngineOpState The host’s operational state:

0: enabled
1: disabled
cacheEngineAppStatus The status of the software on the host:

0: starting
1: started
2: stopping
3: stopped

ELEMENT DESCRIPTION
cacheEngineSWVersion The software version on the host.
cacheEngineUptime The host uptime.
cacheEngineAdminState Host’s administrative state

0: unlocked
1: locked

Chapter 8: Traps
The MediaSwift platform generates a single trap called:
peerAppNotification. When this trap it generated, it includes a payload that
defines the exact notification reason.
Specific values might be associated with some of the payloads, providing
additional trap information. Refer to the table below for a full description of the
payloads associated with the trap:
PAYLOAD SEVERITY DESCRIPTION POSSIBLE VALUES
peerAppStorageDisconnected Critical Storage No meaningful value is

disconnected – associated with this
No cache payload.
storage
enclosures are
available.
System enters
disabled mode.
Manual
intervention is
required to
restore cache
storage
connectivity.
peerAppNoAvailableVolumes Critical No cache No meaningful value is

storage volumes associated with this
available. payload.
System enters
disabled mode.
Application auto
restarts to
recover.
peerAppVolumeUnvailable Major The specific The volume number

cache storage associated with this
volume is not payload is added. The
available. value runs from 1 to
the maximum
supported volumes.

peerAppReplicationDisconnected Critical Replication No meaningful value is

engine associated with this
disconnected, payload.
the platform
messaging bus
disconnects.
Application auto
restarts to
recover.
peerAppFailedInitCmdb Critical Failed to No meaningful value is

initialize cache associated with this
storage database. payload.
Application auto
restarts to
recover.
peerAppFailedAllocateMemory Critical Application No meaningful value is

failed to allocate associated with this
memory. payload.
Application auto
restarts to
recover.
peerAppFailedReadConfig Critical Application No meaningful value is

failed to read the associated with this
system payload.
configuration.
Application auto
restarts to
recover.

peerAppFailedInitConfig Critical Application No meaningful value is

failed to associated with this
initialize the payload.
system due to
invalid
configuration
file content.
System remains
in disabled
mode.
Application auto
restarts to
recover.
peerAppFailedInitInterface Critical Application No meaningful value is

initialize a payload.
specific NIC
interface.
Application auto
restarts to
recover.
peerAppFailedInitForwarder Critical Application No meaningful value is

Forwarder
component.
Application auto
restarts to
recover.
peerAppFailedInitCacheIn Critical Application No meaningful value is

cache-in
component.
Application auto
restarts to
recover.

peerAppCacheEngineOpModeChanged Informative A cache engine The values associated

entered a with this payload are:
different
operational  cacheEngineEnabled
mode. (0) – Cache engine is
enabled.
 cacheEngineDiabled
(1) –Cache engine is
disabled.
peerAppLicenseInvalid Critical An invalid No meaningful value is

license file was associated with this
found. payload.
System enters
disable mode
and does not
recover. Manual
intervention is
required for
installing a valid
file.
peerAppLicenseExpired Critical An outdated No meaningful value is

license file was associated with this
found. payload.
System switches
to disable mode
and will not try
to recover.
If a previously
permanent
license file is
found, the
system uses it if
possible.

peerAppClusterStateChanged Information The MediaSwift Possible values for this

cluster state has payload:
changed.
 clusterDisabled (1) –
The payload The MediaSwift
associated value cluster is disabled.
indicates this  clusterEnabled (2) –
change. The MediaSwift
cluster is enabled.
 clusterDegraded (3)
– At least one cluster
member (cache
engine) is disabled.
peerAppCacheEngineOpmodeChanges Information A cache engine Possible values for this

operational state payload:
was changed.
 cacheEngineEnabled
The payload (0) – The Cache
associated value Engine is now
indicates this enabled.
change.  cacheEngineDisabled
(1) – The Cache
Engine is now
disabled.
peerAppCacheEngineStopping Information A cache engine No meaningful value is

is now in the associated with this
process of payload.
stopping its
operation.
peerAppCacheEngineStopped Information A cache engine No meaningful value is

has stopped. associated with this
payload.
peerAppCacheEngineStarting Information A cache engine No meaningful value is

is now starting. associated with this
payload.
peerAppCacheEngineStarted Information A cache engine No meaningful value is

has started. associated with this
payload.

peerAppSmartfilterLoadFailed Critical Application No meaningful value is

failed to load the associated with this
SmartFilter payload.
component.
Application auto
restarts to
recover.
peerAppTooManyOneDirectionalConnections Major Application No meaningful value is

detected too associated with this
many one payload.
directional TCP
sessions.

Chapter 9: Hardware
Probing the information related to the platform hardware component provides
information related to the following hardware components for each Cache
Engine:
 Volumes – describes the information associated with each volume in the

cache storage.
 Cache Engines – describes the memory and system information

associated with each cache engine.
 Network Interfaces – describes the information associated with each

cache engine network interfaces.
Volumes
hardware  volumes  volumeStatusTable
The volume status table outlines the information associated with each volume in the
cache storage. A sample view of this table is shown below:
Figure 1: Sample view of the volumes table
The following table outlines all table entries. This table is a collection of volume
statuses indexed by volume index:

hardware  volumes  volumeStatusTable 
volumeStatusEntry
ELEMENT DESCRIPTION
volumePath Path where the disk is mounted
volumeDevice Path of the device for the partition
volumeMinimum Minimum space required on the disk (in

kBytes) before the errors are triggered. Either
this or dskMinPercent is configured via the
agent's snmpd.conf file.
volumeMinPercent Percentage of minimum space required on the

disk before the errors are triggered. Either this
or dskMinimum is configured via the agent's
snmpd.conf file.
volumeTotal Total size of the disk/partition (kBytes)
volumeUsed Used space on the disk.
volumePercent Percentage of space used on disk.
volumePercentNode Percentage of inodes used on disk.
volumeErrorFlag Error flag signaling that the disk or partition is

under the minimum required space configured
for it.
volumeErrorMsg A text description providing a warning and the

space left on the disk.
Cache Engines
This section presents two separate sub-trees:
Memory statistics
System statistics
The information is shown for each Cache Engine separately. The following figure
presents the tree-view hierarchy or the Cache Engine information:

Figure 2: cacheEngines information tree-view
Memory Statistics
The following example shows the information available in Cache Engine 1:
hardware  cacheEngines  cacheEngine1  memoryStatsCe1
ELEMENT DESCRIPTION
memIndexCe1 Bogus Index. This should always return the

integer 0.
memErrorNameCe1 Bogus Name. This should always return the

string 'swap'.
memTotalSwapCe1 The total amount of swap space configured for

this host.
memAvailSwapCe1 The amount of swap space currently unused or

available.
memTotalRealCe1 The total amount of real/physical memory

installed on this host.
memAvailRealCe1 The amount of real/physical memory currently

unused or available.

ELEMENT DESCRIPTION
memTotalSwapTXTCe1 The total amount of swap space or virtual

memory allocated for text pages on this host.
This object will not be implemented on hosts
where the underlying operating system does
not distinguish text pages from other uses of
swap space or virtual memory.
memAvailSwapTXTCe1 The amount of swap space or virtual memory

currently being used by text pages on this host.
not distinguish ext pages from other uses of
swap space or virtual memory. Note that
(despite the name), this value reports the
amount used, rather than the amount free or
available for use. For clarity, this object is
being deprecated in favor of
memUsedSwapTXT(16)
memTotalRealTXTCe1 The total amount of real/physical memory

allocated for text pages on this host. This
object will not be implemented on hosts where
the underlying perating system does not
distinguish text pages from other uses of
physical memory.
memAvailRealTXTCe1 The amount of real/physical memory currently

being used by text pages on this host. This
the underlying operating system does not
physical memory. Note that (despite the name),
this value reports the amount used, rather than
the amount free or available for use. For
clarity, this object is being deprecated in favor
of 'memUsedRealTXT(17).
memTotalFreeCe1 The total amount of memory free or available

for use on this host. This value typically
covers both real memory and swap space or
virtual memory.

ELEMENT DESCRIPTION
memMinimumSwapCe1 The minimum amount of swap space expected

to be kept free or available during normal
operation of this host. If this value (as reported
by 'memAvailSwap(4)') falls below the
specified level, then 'memSwapError(100)' will
be set to 1 and an error message made available
via 'memSwapErrorMsg(101)'.
memSharedCe1 The total amount of real or virtual memory

currently allocated for use as shared memory.
not explicitly identify memory as specifically
reserved for this purpose.
memBufferCe1 The total amount of real or virtual memory

currently allocated for use as memory buffers.
memCachedCe1 The total amount of real or virtual memory

currently allocated for use as cached memory.
memUsedSwapTXTCe1 The amount of swap space or virtual memory

currently being used by text pages on this host.
not distinguish text pages from other uses of
swap space or virtual memory.
memUsedRealTXTCe1 The amount of real/physical memory currently

being used by text pages on this host. This
the underlying operating system does not
physical memory.

ELEMENT DESCRIPTION
memSwapErrorCe1 Indicates whether the amount of available swap

space (as reported by 'memAvailSwap(4)'), is
less than the desired minimum (specified by
'memMinimumSwap(12)').
memSwapErrorMsgCe1 Describes whether the amount of available

swap space (as reported by
'memAvailSwap(4)'), is less than the desired
minimum (specified by
'memMinimumSwap(12)').
System Statistics
The following example shows the information available in Cache Engine 1:
hardware  cacheEngines  cacheEngine1  systemStatsCe1
ELEMENT DESCRIPTION
ssIndexCe1 Bogus Index. This should always return the

integer 1.
ssErrorNameCe1 Bogus Name. This should always return the

string 'systemStats'.
ssSwapInCe1 The average amount of memory swapped in

from disk, calculated over the last minute.
ssSwapOutCe1 The average amount of memory swapped out

to disk, calculated over the last minute.
ssIOSentCe1 The average amount of data written to disk or

other block device, calculated over the last
minute. This object has been deprecated in
favor of 'ssIORawSent(57)', which can be used
to calculate the same metric, but over any
desired time period.

ELEMENT DESCRIPTION
ssIOReceiveCe1 The average amount of data read from disk or

other block device, calculated over the last
favour of 'ssIORawReceived(58)', which can
be used to calculate the same metric, but over
any desired time period.
ssSysInterruptsCe1 The average rate of interrupts processed

(including the clock) calculated over the last
favour of 'ssRawInterrupts(59)', which can be
used to calculate the same metric, but over any
ssSysContextCe1 The average rate of context switches,

calculated over the last minute. This object has
been deprecated in favour of
'ssRawContext(60)', which can be used to
calculate the same metric, but over any desired
time period.
ssCpuUserCe1 The percentage of CPU time spent processing

user-level code, calculated over the last
favor of 'ssCpuRawUser(50)', which can be
ssCpuSystemCe1 The percentage of CPU time spent processing

system-level code, calculated over the last
favour of 'ssCpuRawSystem(52)', which can be
ssCpuIdleCe1 The percentage of processor time spent idle,

calculated over the last minute. This object has
been deprecated in favour of
'ssCpuRawIdle(53)', which can be used to
calculate the same metric, but over any desired
time period.

ELEMENT DESCRIPTION
ssCpuRawUserCe1 The number of 'ticks' (typically 1/100s) spent

processing user-level code. On a multi-
processor system, the 'ssCpuRaw*' counters
are cumulative over all CPUs, so their sum will
typically be N*100 (for N processors).
ssCpuRawNiceCe1 The number of 'ticks' (typically 1/100s) spent

processing reduced-priority code. This object
will not be implemented on hosts where the
underlying operating system does not measure
this particular CPU metric. On a multi-
ssCpuRawSystemCe1 The number of 'ticks' (typically 1/100s) spent

processing system-level code. On a multi-
typically be N*100 (for N processors). This
object may sometimes be implemented as the
combination of the 'ssCpuRawWait(54)' and
'ssCpuRawKernel(55)' counters, so care must
be taken when summing the overall raw
counters.
ssCpuRawIdleCe1 The number of 'ticks' (typically 1/100s) spent

idle. On a multi-processor system, the
'ssCpuRaw*' counters are cumulative over all
CPUs, so their sum will typically be N*100
(for N processors).
ssCpuRawWaitCe1 The number of 'ticks' (typically 1/100s) spent

waiting for IO. This object will not be
implemented on hosts where the underlying
operating system does not measure this
particular CPU metric. This time may also be
included within the 'ssCpuRawSystem(52)'
counter. On a multi-processor system, the
(for N processors).

ELEMENT DESCRIPTION
ssCpuRawKernelCe1 The number of 'ticks' (typically 1/100s) spent

processing kernel-level code. This object will
not be implemented on hosts where the
this particular CPU metric. This time may also
be included within the 'ssCpuRawSystem(52)'
counter. On a multi-processor system, the
(for N processors).
ssCpuRawInterruptCe1 The number of 'ticks' (typically 1/100s) spent

processing hardware interrupts. This object
will not be implemented on hosts where the
ssIORawSentCe1 Number of blocks sent to a block device.
ssIORawReceivedCe1 Number of blocks received from a block

device.
ssRawInterruptsCe1 Number of interrupts processed.
ssRawContextsCe1 Number of context switches.
ssCpuRawSoftIRQCe1 The number of 'ticks' (typically 1/100s) spent

processing software interrupts. This object will
not be implemented on hosts where the
ssRawSwapInCe1 Number of blocks swapped in.
ssRawSwapOutCe1 Number of blocks swapped out.

Network Interfaces
hardware  ifStatusCacheEngines  ifStatusTable
The interfaces status table outlines the information associated with each network
interface in each Cache Engine. A partial view of this table is shown below:
Figure 3: Sample view of the Network Interfaces table
The following table outlines all table entries. This table is a collection of interface
statuses indexed by blade and interface index:
hardware  ifStatusCacheEngines  ifStatusTable 
ifStatusEntry
ELEMENT DESCRIPTION
ifBladeIndex The Cache Engine in which this interface is

installed.
ifIndex A unique value for each interface. Its value

ranges between 1 and the value of ifNumber.
The value for each interface must remain
constant at least from one re-initialization of
the entity's network management system to the
next re-initialization.
ifDescr A textual string containing information about

the interface. This string should include the
name of the manufacturer, the product name
and the version of the hardware interface.

ELEMENT DESCRIPTION
ifType The type of interface, distinguished according

to the physical/link protocol(s) immediately
`below' the network layer in the protocol stack.
ifMtu The size of the largest datagram which can be

sent/received on the interface, specified in
octets. For interfaces that are used for
transmitting network datagrams, this is the size
of the largest network datagram that can be
sent on the interface.
ifSpeed An estimate of the interface's current

bandwidth in bits per second. For interfaces
which do not vary in bandwidth or for those
where no accurate estimation can be made, this
object should contain the nominal bandwidth
ifPhysAddress The interface's address at the protocol layer

immediately `below' the network layer in the
protocol stack. For interfaces which do not
have such an address (e.g., a serial line), this
object should contain an octet string of zero
length.
ifAdminStatus The desired state of the interface. The

testing(3) state indicates that no operational
packets can be passed.
ifOperStatus The current operational state of the interface.

The testing(3) state indicates that no
operational packets can be passed.
ifLastChange The value of sysUpTime at the time the

interface entered its current operational state.
If the current state was entered prior to the last
re-initialization of the local network
management subsystem, then this object
contains a zero value.
ifInOctets The total number of octets received on the

interface, including framing characters.
ifInUcastPkts The number of subnetwork-unicast packets

delivered to a higher-layer protocol.

ELEMENT DESCRIPTION
ifInNUcastPkts The number of non-unicast (i.e., subnetwork-

broadcast or subnetwork-multicast) packets
delivered to a higher-layer protocol.
ifInDiscards The number of inbound packets which were

chosen to be discarded even though no errors
had been detected to prevent their being
deliverable to a higher-layer protocol. One
possible reason for discarding such a packet
could be to free up buffer space.
ifInErrors The number of inbound packets that contained

errors preventing them from being deliverable
to ahigher-layer protocol.
ifInUnknownProtos The number of packets received via the

interface which were discarded because of an
unknown or unsupported protocol.
ifOutOctets The total number of octets transmitted out of

the interface, including framing characters.
ifOutUcastPkts The total number of packets that higher-level

protocols requested be transmitted to a
subnetwork-unicast address, including those
that were discarded or not sent.
ifOutNUcastPkts The total number of packets that higher-level

protocols requested be transmitted to a non-
unicast (i.e., a subnetwork-broadcast or
subnetwork-multicast) address, including those
that were discarded or not sent.
ifOutDiscards The number of outbound packets which were

chosen to be discarded even though no errors
had been detected to prevent their being
transmitted. One possible reason for
discarding such a packet could be to free up
buffer space.
ifOutErrors The number of outbound packets that could

not be transmitted because of errors.
ifOutQLen The length of the output packet queue (in

packets).

ELEMENT DESCRIPTION
ifSpecific A reference to MIB definitions specific to the

particular media being used to realize the
interface. For example, if the interface is
realized by an Ethernet, then the value of this
object refers to a document defining objects
specific to Ethernet. If this information is not
present, its value should be set to the OBJECT
IDENTIFIER 0 0 , which is a syntactically
valid object identifier, and any conformant
implementation of ASN.1 and BER must be
able to generate and recognize this value.

MediaSwift MIB Guide R2

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

MediaSwift MIB Guide R2

Uploaded by

Copyright:

Available Formats

MediaSwift

NPP User Guide iii

Doc Version Product Date

v2b1 MS3.0 21.11.10

iv MediaSwift MIB Guide

CHAPTER 1: OVERVIEW ................................................................................. 1-1

CHAPTER 2: CACHE HIT RATIO STATISTICS ............................................... 2-1

CHAPTER 3: NETWORK TRAFFIC STATISTICS ........................................... 3-1

MediaSwift MIB Guide v

CHAPTER 4: NETWORK CONNECTIONS STATISTICS ................................ 4-1

CHAPTER 5: CACHED CONTENT STATISTICS ............................................. 5-1

CHAPTER 6: CONTENT DATABASE BY ACTION STATISTICS ................... 6-1

CHAPTER 7: MANAGEMENT .......................................................................... 7-1

CHAPTER 8: TRAPS ........................................................................................ 8-1

CHAPTER 9: HARDWARE ............................................................................... 9-1

vi MediaSwift MIB Guide

MediaSwift MIB Guide 1-1

All elements are Read-only.

cacheRequestsEdonkey The total number of processed eDonkey cache requests.

cacheRequestsBittorrent The total number of processed BitTorrent requests.

cacheRequestsKazaa The total number of processed Kazaa requests.

cacheRequestsGnutella The total number of processed Gnutella requests.

cacheRequestsAres The total number of processed Ares requests.

cacheRequestsHttp The total number of processed HTTP requests.

cacheRequestsThunder The total number of processed Thunder requests.

cacheRequestsThunderUdp The total number of processed Thunder UDP requests.

cacheRequestsInspect The total number of processed requests at a decision point

All elements are Read-only.

cacheRequestsEdonkeyInspect The total number of processed decisions (served from

MediaSwift MIB Guide 2-1

cacheRequestsBittorrentInspect The total number of processed decisions (served from

cacheRequestsKazaaInspect The total number of processed decisions (served from

cacheRequestsGnutellaInspect The total number of processed decisions (served from

cacheRequestsAresInspect The total number of processed decisions (served from

cacheRequestsHttpInspect The total number of processed decisions (served from

Cache Requests in Bytes

All elements are Read-only.

cacheBytesRequestedEdonkey The total number of bytes in processed eDonkey

cacheBytesRequestedBittorrent The total number of bytes in processed BitTorrent

cacheBytesRequestedKazaa The total number of bytes in processed Kazaa protocol

cacheBytesRequestedGnutella The total number of bytes in processed Gnutella

cacheBytesRequestedAres The total number of bytes in processed Ares protocol

cacheBytesRequestedHttp The total number of bytes in processed HTTP protocol

cacheBytesRequestedThunder The total number of bytes in processed Thunder

2-2 MediaSwift MIB Guide

cacheBytesRequestedUdpThunder The total number of bytes in processed Thunder UDP

Cache Requests Hits

All elements are Read-only.

cacheRequestsHitsEdonkey The total number of requests for eDonkey protocol served

cacheRequestsHitsBittorrent The total number of requests for BitTorrent protocol

cacheRequestsHitsKazaa The total number of requests for Kazaa protocol served

cacheRequestsHitsGnutella The total number of requests for Gnutella protocol served

cacheRequestsHitsAres The total number of requests for Ares protocol served

cacheRequestsHitsHttp The total number of requests for HTTP protocol served

cacheRequestsHitsThunder The total number of requests for Thunder protocol served

cacheRequestsHitsThunderUdp The total number of requests for Thunder UDP protocol

MediaSwift MIB Guide 2-3

All elements are Read-only.

cacheRequestsHitsEdonkeyInspect The total number of hits for eDonkey protocol requests.

cacheRequestsHitsBittorrentInspect The total number of hits for BitTorrent protocol

cacheRequestsHitsKazaaInspect The total number of hits for Kazaa protocol requests.

cacheRequestsHitsGnutellaInspect The total number of hits for Gnutella protocol requests.

cacheRequestsHitsAresInspect The total number of hits for Ares protocol requests.