GSA-MIB

All MIBs › GSA-MIB

Category: Device Management, Vendor: GSA

Description: Generic system administration MIB providing standard objects for device administration and configuration management.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) 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.

What Is GSA-MIB?

GSA-MIB is Google's MIB module for the Google Search Appliance (GSA), a hardware/software appliance that crawled and indexed content for enterprise search; despite its generic-sounding name, the object names reveal it is specifically a web-crawling and indexing status MIB rather than a general system-administration MIB. It exposes crawl-engine operational data -- whether crawling is currently running, crawl rate, and both continuous and batch-crawl states -- along with document-level statistics like documents served, bytes transferred, and error counts. Its monitoring focus is software/service status: crawlRunning and batchCrawlRunning indicate whether the indexing engine is actively working, docErrors flags documents that failed to crawl, and counters like docsServed, docBytes, todayDocsCrawled, and docsFound reveal indexing throughput and coverage, all organized under 'status'/'diagnostics' branches suggesting a broader health-check framework. It is registered under Google's own enterprise OID tree (via GOOGLE-MIB) rather than depending on external IETF standards. It was typically deployed on physical Google Search Appliance hardware boxes in enterprise data centers for on-premises web/document search and indexing. Engineers can download the GSA-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in GSA-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

Google Search Appliance (GSA) hardware appliance

Monitoring Examples

An administrator would poll crawlRunning and batchCrawlRunning to confirm the appliance's crawl engine is actively indexing content, and check crawlingRate alongside todayDocsCrawled and docsFound to gauge indexing throughput and coverage for the day. docErrors would be watched for a spike indicating a source of crawl failures (e.g., a misconfigured or unreachable content repository), while batchCrawlStartTime, batchCrawlEndTime, and batchCrawlEndReason would be reviewed together to confirm the most recent scheduled batch crawl completed successfully rather than aborting early.

What Can Be Monitored

crawl engine running status
batch crawl running/schedule status
documents crawled/served/found today
document crawl errors
crawl rate
data volume crawled (bytes)

Imported Objects

From GOOGLE-MIB

gsa	OBJECT-IDENTITY

From SNMPv2-SMI

Integer32
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

DisplayString
TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using crawlRunning OID:

Select a Google Search Appliance (GSA) hardware appliance 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 crawlRunning into the Find box to locate it in the OID tree, then select it and click OK. It reports the crawling activity of GSA. 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 an INTEGER-type OID, Value bounds is the most useful condition here — trigger an alert if the value is anything other than 'running', since that indicates the condition this object reports has changed to one worth investigating. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
crawl	1.3.6.1.4.1.11129.1.1
INT crawlRunningEx	1.3.6.1.4.1.11129.1.1.1	INTEGER	read-only	Crawling activity of GSA
status	1.3.6.1.4.1.11129.1.1.2
I32 docsServed	1.3.6.1.4.1.11129.1.1.2.1	Integer32	read-only	The number of documents being served by the Google Search Appliance
I32 crawlingRate	1.3.6.1.4.1.11129.1.1.2.2	Integer32	read-only	The current crawling rate of the Google Search Appliance
I32 docBytes	1.3.6.1.4.1.11129.1.1.2.3	Integer32	read-only	The total megabytes processed so far by the Google Search Appliance
I32 todayDocsCrawled	1.3.6.1.4.1.11129.1.1.2.4	Integer32	read-only	The number of documents crawled today
I32 docErrors	1.3.6.1.4.1.11129.1.1.2.5	Integer32	read-only	Number of times an error occurred while trying to crawl a document
I32 docsFound	1.3.6.1.4.1.11129.1.1.2.6	Integer32	read-only	Total documents found by the Google Search Appliance
INT batchCrawlRunning	1.3.6.1.4.1.11129.1.1.2.7	INTEGER	read-only	Batch crawl activity of the GSA
I32 batchCrawlStartTime	1.3.6.1.4.1.11129.1.1.2.8	Integer32	read-only	Time the most recent batch crawl started on the Google Search Appliance
I32 batchCrawlEndTime	1.3.6.1.4.1.11129.1.1.2.9	Integer32	read-only	Time the most recent batch crawl ended on the Google Search Appliance
INT batchCrawlEndReason	1.3.6.1.4.1.11129.1.1.2.10	INTEGER	read-only	Reason the most recent batch crawl ended on the Google Search Appliance
diagnostics	1.3.6.1.4.1.11129.1.1.3
serving	1.3.6.1.4.1.11129.1.2
I32 qpm	1.3.6.1.4.1.11129.1.2.1	Integer32	read-only	The serving status, in terms of queries per minute being handled
system	1.3.6.1.4.1.11129.1.3
gsaDisk	1.3.6.1.4.1.11129.1.3.1
INT diskHealth	1.3.6.1.4.1.11129.1.3.1.1	INTEGER	read-only	Information about status of the disk(s) in GSA
STR diskErrors	1.3.6.1.4.1.11129.1.3.1.2	DisplayString	read-only	Errors associated with disk
temperature	1.3.6.1.4.1.11129.1.3.2
INT temperatureHealth	1.3.6.1.4.1.11129.1.3.2.1	INTEGER	read-only	Information about temperature of GSA
STR temperatureErrors	1.3.6.1.4.1.11129.1.3.2.2	DisplayString	read-only	Error string associated with temperature
machine	1.3.6.1.4.1.11129.1.3.3
INT machineHealth	1.3.6.1.4.1.11129.1.3.3.1	INTEGER	read-only	Information about status of the machine
STR machineErrors	1.3.6.1.4.1.11129.1.3.3.2	DisplayString	read-only	Error string associated with machine
search	1.3.6.1.4.1.11129.1.4
reports	1.3.6.1.4.1.11129.1.4.1
logs	1.3.6.1.4.1.11129.1.4.2
eventLogs	1.3.6.1.4.1.11129.1.5

RFC description

Provides monitoring of crawling activity and search statistics on Google Search Appliance servers.

Start monitoring Google Search Appliance (GSA) hardware appliance 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 GSA-MIB