SQUID-MIB

All MIBs › SQUID-MIB

Organization: National Laboratory for Applied Network Research

Last Updated: 2008-12-24

Category: Net-SNMP and Linux

Description: Monitors the Squid web proxy/cache server via SNMP, exposing cache hit ratios, HTTP request counts, client/server traffic volume, median service times, and DNS lookup stats.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring SQUID-MIB with a free 30-day trial of IPNetwork Monitor.

What Is SQUID-MIB?

SQUID-MIB is a vendor-neutral SNMP module maintained by the open-source Squid project for managing and monitoring the Squid web caching proxy server, a widely deployed HTTP/FTP caching intermediary used to reduce bandwidth and accelerate web access. It exposes performance and traffic counters covering client and server request volumes, cache hit/miss ratios, byte throughput, median service times, and DNS resolution statistics. Administrators rely on it primarily to monitor the software health and performance status of the Squid process itself — tracking request throughput, cache efficiency, and response latency trends that indicate whether the proxy is keeping pace with load or degrading. Because Squid runs as a userspace daemon rather than dedicated hardware, this MIB has no explicit external dependency beyond the standard SNMPv2-SMI framework it is built on. It is typically deployed on Linux/Unix cache servers or proxy appliances in enterprise or ISP networks where web traffic optimization and content delivery acceleration are required. Engineers can download the SQUID-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in SQUID-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Squid proxy/cache server (software appliance)
vendor-neutral, standards-based MIB for Unix/Linux HTTP cache software

Monitoring Examples

An administrator would poll counters analogous to cache HTTP hit and request totals to compute the cache hit ratio and confirm the proxy is offloading origin traffic effectively; a falling hit ratio combined with a rising median service time suggests cache storage pressure or misconfiguration. DNS-related counters (lookups, wait time) reveal whether slow name resolution is the source of latency spikes. Since sample_objects is empty for this entry, these object names are inferred from Squid's well-known public MIB rather than confirmed here.

What Can Be Monitored

cache hit ratio
HTTP request counts
client/server traffic volume
median service time
DNS lookup statistics
byte throughput

Imported Objects

From INET-ADDRESS-MIB

InetAddress
InetAddressType

From SNMPv2-SMI

Counter32
Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE
TimeTicks
Unsigned32
enterprises

From SNMPv2-TC

DisplayString
TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using cacheSysPageFaults OID:

Select a Squid proxy/cache server (software appliance), vendor-neutral standards-based MIB for Unix/Linux HTTP cache software (traffic/cache-performance counters) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cacheSysPageFaults into the Find box to locate it in the OID tree, then select it and click OK. It reports the page faults with physical i/o. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
STR cacheAdmin	1.3.6.1.4.1.3495.1.2.1	DisplayString	read-only	Cache Administrator E-Mail address
C32 cacheAttemptReleaseLckEntries	1.3.6.1.4.1.3495.1.4.1.8	Counter32	read-only	Number of attempts to release locked IP Cache entries
C32 cacheBlockingGetHostByAddr	1.3.6.1.4.1.3495.1.4.2.7	Counter32	read-only	Number of blocking gethostbyaddr requests
C32 cacheBlockingGetHostByName	1.3.6.1.4.1.3495.1.4.1.7	Counter32	read-only	Number of blocking gethostbyname requests
IP cacheClientAddress	1.3.6.1.4.1.3495.1.5.2.2.2	InetAddress	read-only	The Internet address for the client. The type of this address is determined by the value of the peerAddressType object. Note that implementations must limit themselves to a single entry in this table per reachable peer. The peerAddress may not be empty due to the SIZE restriction. If a row is created administratively by an SNMP operation and the address type value is dns(16), then the agent stores the DNS name internally. A DNS name lookup must be performed on the internally stored DNS name whenever it is being used to contact the peer. If a row is created by the managed entity itself and the address type value is dns(16), then the agent stores the IP address internally. A DNS reverse lookup must be performed on the internally stored IP address whenever the value is retrieved via SNMP.
IPt cacheClientAddressType	1.3.6.1.4.1.3495.1.5.2.2.1	InetAddressType	read-only	The client's IP address
cacheClientEntry	1.3.6.1.4.1.3495.1.5.2.2		not-accessible	An IP entry in cacheClientTable
C32 cacheClientHTTPHitKb	1.3.6.1.4.1.3495.1.5.2.2.6	Counter32	read-only	Amount of HTTP hit traffic in KB
C32 cacheClientHttpHits	1.3.6.1.4.1.3495.1.5.2.2.5	Counter32	read-only	Number of hits in response to this client's HTTP requests
C32 cacheClientHttpKb	1.3.6.1.4.1.3495.1.5.2.2.4	Counter32	read-only	Amount of total HTTP traffic to this client
C32 cacheClientHttpRequests	1.3.6.1.4.1.3495.1.5.2.2.3	Counter32	read-only	Number of HTTP requests received from client
C32 cacheClientIcpHitKb	1.3.6.1.4.1.3495.1.5.2.2.10	Counter32	read-only	Amount of ICP hit traffic in KB
C32 cacheClientIcpHits	1.3.6.1.4.1.3495.1.5.2.2.9	Counter32	read-only	Number of hits in response to this client's ICP requests
C32 cacheClientIcpKb	1.3.6.1.4.1.3495.1.5.2.2.8	Counter32	read-only	Amount of total ICP traffic to this client (child)
C32 cacheClientIcpRequests	1.3.6.1.4.1.3495.1.5.2.2.7	Counter32	read-only	Number of ICP requests received from client
G32 cacheClients	1.3.6.1.4.1.3495.1.3.2.1.15	Gauge32	read-only	Number of clients accessing cache
cacheClientTable	1.3.6.1.4.1.3495.1.5.2		not-accessible	A list of cache client entries.
cacheConfig	1.3.6.1.4.1.3495.1.2
I32 cacheCpuTime	1.3.6.1.4.1.3495.1.3.1.4	Integer32	read-only	Amount of cpu seconds consumed
I32 cacheCpuUsage	1.3.6.1.4.1.3495.1.3.1.5	Integer32	read-only	The percentage use of the CPU
G32 cacheCurrentFileDescrCnt	1.3.6.1.4.1.3495.1.3.1.12	Gauge32	read-only	Number of file descriptors in use
G32 cacheCurrentFileDescrMax	1.3.6.1.4.1.3495.1.3.1.13	Gauge32	read-only	Highest file descriptors in use
TIK cacheCurrentLRUExpiration	1.3.6.1.4.1.3495.1.3.1.8	TimeTicks	read-only	Storage LRU Expiration Age
G32 cacheCurrentResFileDescrCnt	1.3.6.1.4.1.3495.1.3.1.11	Gauge32	read-only	Reserved number of file descriptors
G32 cacheCurrentSwapSize	1.3.6.1.4.1.3495.1.3.2.1.14	Gauge32	read-only	Storage Swap size
G32 cacheCurrentUnlinkRequests	1.3.6.1.4.1.3495.1.3.1.9	Gauge32	read-only	Requests given to unlinkd
G32 cacheCurrentUnusedFDescrCnt	1.3.6.1.4.1.3495.1.3.1.10	Gauge32	read-only	Available number of file descriptors
cacheDns	1.3.6.1.4.1.3495.1.4.3
C32 cacheDnsNumberServers	1.3.6.1.4.1.3495.1.4.3.3	Counter32	read-only	Number of external DNS server processes
C32 cacheDnsReplies	1.3.6.1.4.1.3495.1.4.3.2	Counter32	read-only	Number of external DNS server replies
C32 cacheDnsRequests	1.3.6.1.4.1.3495.1.4.3.1	Counter32	read-only	Number of external DNS server requests
I32 cacheDnsSvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.8	Integer32	read-only	DNS service time
cacheFqdnCache	1.3.6.1.4.1.3495.1.4.2
G32 cacheFqdnEntries	1.3.6.1.4.1.3495.1.4.2.1	Gauge32	read-only	FQDN Cache entries
C32 cacheFqdnHits	1.3.6.1.4.1.3495.1.4.2.3	Counter32	read-only	Number of FQDN Cache hits
C32 cacheFqdnMisses	1.3.6.1.4.1.3495.1.4.2.6	Counter32	read-only	Number of FQDN Cache misses
C32 cacheFqdnNegativeHits	1.3.6.1.4.1.3495.1.4.2.5	Counter32	read-only	Number of FQDN Cache negative hits
G32 cacheFqdnPendingHits	1.3.6.1.4.1.3495.1.4.2.4	Gauge32	read-only	Number of FQDN Cache pending hits
C32 cacheFqdnRequests	1.3.6.1.4.1.3495.1.4.2.2	Counter32	read-only	Number of FQDN Cache requests
I32 cacheHttpAllSvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.2	Integer32	read-only	HTTP all service time
C32 cacheHttpErrors	1.3.6.1.4.1.3495.1.3.2.1.3	Counter32	read-only	Number of HTTP Errors
C32 cacheHttpHits	1.3.6.1.4.1.3495.1.3.2.1.2	Counter32	read-only	Number of HTTP Hits
I32 cacheHttpHitSvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.5	Integer32	read-only	HTTP hit service time
C32 cacheHttpInKb	1.3.6.1.4.1.3495.1.3.2.1.4	Counter32	read-only	Number of HTTP KB's received
I32 cacheHttpMissSvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.3	Integer32	read-only	HTTP miss service time
I32 cacheHttpNhSvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.11	Integer32	read-only	HTTP refresh hit service time
I32 cacheHttpNmSvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.4	Integer32	read-only	HTTP hit not-modified service time
C32 cacheHttpOutKb	1.3.6.1.4.1.3495.1.3.2.1.5	Counter32	read-only	Number of HTTP KB's transmitted
C32 cacheIcpKbRecv	1.3.6.1.4.1.3495.1.3.2.1.9	Counter32	read-only	Number of ICP KB's received
C32 cacheIcpKbSent	1.3.6.1.4.1.3495.1.3.2.1.8	Counter32	read-only	Number of ICP KB's transmitted
C32 cacheIcpPktsRecv	1.3.6.1.4.1.3495.1.3.2.1.7	Counter32	read-only	Number of ICP messages received
C32 cacheIcpPktsSent	1.3.6.1.4.1.3495.1.3.2.1.6	Counter32	read-only	Number of ICP messages sent
I32 cacheIcpQuerySvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.6	Integer32	read-only	ICP query service time
I32 cacheIcpReplySvcTime	1.3.6.1.4.1.3495.1.3.2.2.1.7	Integer32	read-only	ICP reply service time
cacheIpCache	1.3.6.1.4.1.3495.1.4.1
G32 cacheIpEntries	1.3.6.1.4.1.3495.1.4.1.1	Gauge32	read-only	IP Cache Entries
C32 cacheIpHits	1.3.6.1.4.1.3495.1.4.1.3	Counter32	read-only	Number of IP Cache hits
C32 cacheIpMisses	1.3.6.1.4.1.3495.1.4.1.6	Counter32	read-only	Number of IP Cache misses
C32 cacheIpNegativeHits	1.3.6.1.4.1.3495.1.4.1.5	Counter32	read-only	Number of IP Cache negative hits
G32 cacheIpPendingHits	1.3.6.1.4.1.3495.1.4.1.4	Gauge32	read-only	Number of IP Cache pending hits
C32 cacheIpRequests	1.3.6.1.4.1.3495.1.4.1.2	Counter32	read-only	Number of IP Cache requests
STR cacheLoggingFacility	1.3.6.1.4.1.3495.1.2.4	DisplayString	read-write	Logging Facility. An informational string indicating logging info like debug level, local/syslog/remote logging etc
I32 cacheMaxResSize	1.3.6.1.4.1.3495.1.3.1.6	Integer32	read-only	Maximum Resident Size in KB
cacheMedianSvcEntry	1.3.6.1.4.1.3495.1.3.2.2.1		not-accessible	An entry in cacheMedianSvcTable
cacheMedianSvcTable	1.3.6.1.4.1.3495.1.3.2.2		not-accessible	CacheMedianSvcTable
I32 cacheMedianTime	1.3.6.1.4.1.3495.1.3.2.2.1.1	Integer32	not-accessible	The value used to index the table 1/5/60
I32 cacheMemMaxSize	1.3.6.1.4.1.3495.1.2.5.1	Integer32	read-only	The value of the cache_mem parameter in MB
I32 cacheMemUsage	1.3.6.1.4.1.3495.1.3.1.3	Integer32	read-only	Total memory accounted for KB
cacheMesh	1.3.6.1.4.1.3495.1.5
cacheNetwork	1.3.6.1.4.1.3495.1.4
G32 cacheNumObjCount	1.3.6.1.4.1.3495.1.3.1.7	Gauge32	read-only	Number of objects stored by the cache
IP cachePeerAddress	1.3.6.1.4.1.3495.1.5.1.3.4	InetAddress	read-only	The Internet address for the peer cache. The type of this address is determined by the value of the peerAddressType object. Note that implementations must limit themselves to a single entry in this table per reachable peer. The peerAddress may not be empty due to the SIZE restriction. If a row is created administratively by an SNMP operation and the address type value is dns(16), then the agent stores the DNS name internally. A DNS name lookup must be performed on the internally stored DNS name whenever it is being used to contact the peer. If a row is created by the managed entity itself and the address type value is dns(16), then the agent stores the IP address internally. A DNS reverse lookup must be performed on the internally stored IP address whenever the value is retrieved via SNMP.
IPt cachePeerAddressType	1.3.6.1.4.1.3495.1.5.1.3.3	InetAddressType	read-only	The type of Internet address by which the peer cache is reachable.
cachePeerEntry	1.3.6.1.4.1.3495.1.5.1.3		not-accessible	An entry in cachePeerTable (version 3)
C32 cachePeerFetches	1.3.6.1.4.1.3495.1.5.1.3.11	Counter32	read-only	Number of times this peer was selected
C32 cachePeerIgnored	1.3.6.1.4.1.3495.1.5.1.3.13	Counter32	read-only	How many times this peer was ignored
CAC cachePeerIndex	1.3.6.1.4.1.3495.1.5.1.3.1	CachePeerTableIndex	read-only	A unique non-zero value identifying the particular cache Peer.
C32 cachePeerKeepAlRecv	1.3.6.1.4.1.3495.1.5.1.3.15	Counter32	read-only	Number of keepalives received
C32 cachePeerKeepAlSent	1.3.6.1.4.1.3495.1.5.1.3.14	Counter32	read-only	Number of keepalives sent
STR cachePeerName	1.3.6.1.4.1.3495.1.5.1.3.2	DisplayString	read-only	The FQDN name or internal alias for the peer cache
C32 cachePeerPingsAcked	1.3.6.1.4.1.3495.1.5.1.3.10	Counter32	read-only	Number of pings received from peer
C32 cachePeerPingsSent	1.3.6.1.4.1.3495.1.5.1.3.9	Counter32	read-only	Number of pings sent to peer
VAL cachePeerPortHttp	1.3.6.1.4.1.3495.1.5.1.3.5	ValidPort	read-only	The port the peer listens for HTTP requests
VAL cachePeerPortIcp	1.3.6.1.4.1.3495.1.5.1.3.6	ValidPort	read-only	The port the peer listens for ICP requests should be 0 if not configured to send ICP requests
I32 cachePeerRtt	1.3.6.1.4.1.3495.1.5.1.3.12	Integer32	read-only	Last known round-trip time to the peer (in ms)
I32 cachePeerState	1.3.6.1.4.1.3495.1.5.1.3.8	Integer32	read-only	The operational state of this peer
cachePeerTable	1.3.6.1.4.1.3495.1.5.1		not-accessible	This table contains an enumeration of the peer caches, complete with info
I32 cachePeerType	1.3.6.1.4.1.3495.1.5.1.3.7	Integer32	read-only	Peer Type
cachePerf	1.3.6.1.4.1.3495.1.3
cacheProtoAggregateStats	1.3.6.1.4.1.3495.1.3.2.1
C32 cacheProtoClientHttpRequests	1.3.6.1.4.1.3495.1.3.2.1.1	Counter32	read-only	Number of HTTP requests received
cacheProtoStats	1.3.6.1.4.1.3495.1.3.2
I32 cacheRequestByteRatio	1.3.6.1.4.1.3495.1.3.2.2.1.10	Integer32	read-only	Byte Hit Ratios
I32 cacheRequestHitRatio	1.3.6.1.4.1.3495.1.3.2.2.1.9	Integer32	read-only	Request Hit Ratios
I32 cacheServerErrors	1.3.6.1.4.1.3495.1.3.2.1.11	Integer32	read-only	All errors for the cache server from client requests
C32 cacheServerInKb	1.3.6.1.4.1.3495.1.3.2.1.12	Counter32	read-only	KB's of traffic received from servers
C32 cacheServerOutKb	1.3.6.1.4.1.3495.1.3.2.1.13	Counter32	read-only	KB's of traffic sent to servers
I32 cacheServerRequests	1.3.6.1.4.1.3495.1.3.2.1.10	Integer32	read-only	All requests from the client for the cache server
STR cacheSoftware	1.3.6.1.4.1.3495.1.2.2	DisplayString	read-only	Cache Software Name
cacheStorageConfig	1.3.6.1.4.1.3495.1.2.5
I32 cacheSwapHighWM	1.3.6.1.4.1.3495.1.2.5.3	Integer32	read-only	Cache Swap High Water Mark
I32 cacheSwapLowWM	1.3.6.1.4.1.3495.1.2.5.4	Integer32	read-only	Cache Swap Low Water Mark
I32 cacheSwapMaxSize	1.3.6.1.4.1.3495.1.2.5.2	Integer32	read-only	The total of the cache_dir space allocated in MB
C32 cacheSysNumReads	1.3.6.1.4.1.3495.1.3.1.2	Counter32	read-only	HTTP I/O number of reads
C32 cacheSysPageFaultsEx	1.3.6.1.4.1.3495.1.3.1.1	Counter32	read-only	Page faults with physical i/o
cacheSysPerf	1.3.6.1.4.1.3495.1.3.1
I32 cacheSysStorage	1.3.6.1.4.1.3495.1.1.2	Integer32	read-only	Storage Swap size in KB
cacheSystem	1.3.6.1.4.1.3495.1.1
I32 cacheSysVMsize	1.3.6.1.4.1.3495.1.1.1	Integer32	read-only	Storage Mem size in KB
STR cacheUniqName	1.3.6.1.4.1.3495.1.2.6	DisplayString	read-only	Cache unique host name
TIK cacheUptime	1.3.6.1.4.1.3495.1.1.3	TimeTicks	read-only	The Uptime of the cache in timeticks
OCT cacheVersionId	1.3.6.1.4.1.3495.1.2.3	OCTET STRING	read-only	Cache Software Version
nlanr	1.3.6.1.4.1.3495
squid	1.3.6.1.4.1.3495.1			Squid MIB defined for the management of the Squid proxy server. See http://www.squid-cache.org/.

RFC description

Monitors Squid proxy server performance, cache operations, and system resources for content caching and web filtering.

Start monitoring Squid proxy/cache server (software appliance), vendor-neutral standards-based MIB for Unix/Linux HTTP cache software (traffic/cache-performance counters) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download SQUID-MIB