src/mib.txt

   1 -- SQUID-MIB  { iso org(3) dod(6) internet(1) private(4) enterprises(1) 3495 }
   2
   3 SQUID-MIB DEFINITIONS ::= BEGIN
   4
   5 IMPORTS
   6         enterprises, Unsigned32, TimeTicks, Gauge32, Counter32,
   7         MODULE-IDENTITY, OBJECT-TYPE, Integer32
   8                 FROM SNMPv2-SMI
   9
  10         DisplayString, TEXTUAL-CONVENTION
  11                 FROM SNMPv2-TC
  12
  13         InetAddressType, InetAddress
  14                 FROM INET-ADDRESS-MIB;
  15
  16 squid MODULE-IDENTITY
  17     LAST-UPDATED "200812240200Z"
  18     ORGANIZATION "National Laboratory for Applied Network Research"
  19     CONTACT-INFO
  20             "        Squid Developers
  21
  22              E-mail: squid@squid-cache.org"
  23     DESCRIPTION
  24                 "Squid MIB defined for the management of the Squid
  25                 proxy server. See http://www.squid-cache.org/."
  26
  27     REVISION      "200812240200Z"
  28     DESCRIPTION
  29                 "Corrected MIB strictness requirements. Mapped
  30                 valid port ranges"
  31
  32     REVISION      "200712140000Z"
  33     DESCRIPTION
  34                 "Added support for IPv6 Technology."
  35
  36     REVISION      "9901010000Z"
  37     DESCRIPTION
  38                 "Added objects and corrected asn.1 syntax and
  39                 descriptions."
  40
  41     REVISION      "9809220000Z"
  42     DESCRIPTION
  43                 "Move to SMIv2. Prepare to split into proxy/squid."
  44
  45     ::= { nlanr 1 }
  46
  47 --
  48 -- OID Assignments
  49 --
  50         nlanr OBJECT IDENTIFIER ::= { enterprises 3495 }
  51         cacheSystem     OBJECT IDENTIFIER ::= { squid 1 }
  52         cacheConfig     OBJECT IDENTIFIER ::= { squid 2 }
  53         cachePerf       OBJECT IDENTIFIER ::= { squid 3 }
  54         cacheNetwork    OBJECT IDENTIFIER ::= { squid 4 }
  55         cacheMesh       OBJECT IDENTIFIER ::= { squid 5 }
  56
  57
  58 --
  59 -- cacheSystem group { squid 1 }
  60 --
  61
  62         cacheSysVMsize OBJECT-TYPE
  63                 SYNTAX Integer32
  64                 MAX-ACCESS read-only
  65                 STATUS current
  66                 DESCRIPTION
  67                         " Storage Mem size in KB "
  68         ::= { cacheSystem 1 }
  69
  70         cacheSysStorage OBJECT-TYPE
  71                 SYNTAX Integer32
  72                 MAX-ACCESS read-only
  73                 STATUS current
  74                 DESCRIPTION
  75                         " Storage Swap size in KB "
  76         ::= { cacheSystem 2 }
  77
  78         cacheUptime  OBJECT-TYPE
  79                 SYNTAX TimeTicks
  80                 MAX-ACCESS read-only
  81                 STATUS current
  82                 DESCRIPTION
  83                         " The Uptime of the cache in timeticks "
  84         ::= { cacheSystem 3 }
  85
  86 --
  87 -- cacheConfig group { squid 2 }
  88 --
  89 -- Contains configuration information including peers etc.
  90 --
  91
  92         cacheAdmin OBJECT-TYPE
  93                 SYNTAX DisplayString
  94                 MAX-ACCESS read-only
  95                 STATUS current
  96                 DESCRIPTION
  97                         " Cache Administrator E-Mail address "
  98         ::= { cacheConfig 1 }
  99
 100         cacheSoftware OBJECT-TYPE
 101                 SYNTAX DisplayString
 102                 MAX-ACCESS read-only
 103                 STATUS current
 104                 DESCRIPTION
 105                         " Cache Software Name "
 106         ::= { cacheConfig 2 }
 107
 108         cacheVersionId OBJECT-TYPE
 109                 SYNTAX OCTET STRING
 110                 MAX-ACCESS read-only
 111                 STATUS current
 112                 DESCRIPTION
 113                         " Cache Software Version "
 114         ::= { cacheConfig 3 }
 115
 116         cacheLoggingFacility OBJECT-TYPE
 117                 SYNTAX DisplayString
 118                 MAX-ACCESS read-write
 119                 STATUS current
 120                 DESCRIPTION
 121                         " Logging Facility. An informational string
 122                           indicating logging info like debug level,
 123                           local/syslog/remote logging etc "
 124         ::= { cacheConfig 4 }
 125
 126 -- cacheStorageConfig group
 127
 128         cacheStorageConfig OBJECT IDENTIFIER ::= { cacheConfig 5 }
 129
 130         cacheMemMaxSize OBJECT-TYPE
 131                 SYNTAX Integer32
 132                 MAX-ACCESS read-only
 133                 STATUS current
 134                 DESCRIPTION
 135                         " The value of the cache_mem parameter in MB "
 136         ::= { cacheStorageConfig 1 }
 137
 138         cacheSwapMaxSize OBJECT-TYPE
 139                 SYNTAX Integer32
 140                 MAX-ACCESS read-only
 141                 STATUS current
 142                 DESCRIPTION
 143                         " The total of the cache_dir space allocated in MB "
 144         ::= { cacheStorageConfig 2 }
 145
 146         cacheSwapHighWM OBJECT-TYPE
 147                 SYNTAX Integer32
 148                 MAX-ACCESS read-only
 149                 STATUS current
 150                 DESCRIPTION
 151                         " Cache Swap High Water Mark "
 152         ::= { cacheStorageConfig 3 }
 153
 154         cacheSwapLowWM OBJECT-TYPE
 155                 SYNTAX Integer32
 156                 MAX-ACCESS read-only
 157                 STATUS current
 158                 DESCRIPTION
 159                         " Cache Swap Low Water Mark "
 160         ::= { cacheStorageConfig 4 }
 161
 162 -- end of  cacheStorageConfig group
 163
 164         cacheUniqName OBJECT-TYPE
 165                 SYNTAX DisplayString
 166                 MAX-ACCESS read-only
 167                 STATUS current
 168                 DESCRIPTION
 169                         " Cache unique host name "
 170         ::= { cacheConfig 6 }
 171
 172
 173 --
 174 -- cachePerformance group { squid 3 }
 175 --
 176
 177         cacheSysPerf    OBJECT IDENTIFIER ::= { cachePerf 1 }
 178         cacheProtoStats OBJECT IDENTIFIER ::= { cachePerf 2 }
 179
 180         --
 181         -- cacheSysPerf
 182         --
 183
 184         cacheSysPageFaults OBJECT-TYPE
 185                 SYNTAX Counter32
 186                 MAX-ACCESS read-only
 187                 STATUS current
 188                 DESCRIPTION
 189                         " Page faults with physical i/o "
 190         ::= { cacheSysPerf 1 }
 191
 192         cacheSysNumReads OBJECT-TYPE
 193                 SYNTAX Counter32
 194                 MAX-ACCESS read-only
 195                 STATUS current
 196                 DESCRIPTION
 197                         " HTTP I/O number of reads "
 198         ::= { cacheSysPerf 2 }
 199
 200         cacheMemUsage OBJECT-TYPE
 201                 SYNTAX Integer32
 202                 MAX-ACCESS read-only
 203                 STATUS  current
 204                 DESCRIPTION
 205                         " Total memory accounted for KB "
 206         ::= { cacheSysPerf 3 }
 207
 208         cacheCpuTime OBJECT-TYPE
 209                 SYNTAX Integer32
 210                 MAX-ACCESS read-only
 211                 STATUS  current
 212                 DESCRIPTION
 213                         " Amount of cpu seconds consumed "
 214         ::= { cacheSysPerf 4 }
 215
 216         cacheCpuUsage OBJECT-TYPE
 217                 SYNTAX Integer32
 218                 MAX-ACCESS read-only
 219                 STATUS  current
 220                 DESCRIPTION
 221                         " The percentage use of the CPU "
 222         ::= { cacheSysPerf 5 }
 223
 224         cacheMaxResSize OBJECT-TYPE
 225                 SYNTAX Integer32
 226                 MAX-ACCESS read-only
 227                 STATUS  current
 228                 DESCRIPTION
 229                         " Maximum Resident Size in KB "
 230         ::= { cacheSysPerf 6 }
 231
 232         cacheNumObjCount OBJECT-TYPE
 233                 SYNTAX Gauge32
 234                 MAX-ACCESS read-only
 235                 STATUS  current
 236                 DESCRIPTION
 237                         " Number of objects stored by the cache "
 238         ::= { cacheSysPerf 7 }
 239
 240         cacheCurrentLRUExpiration OBJECT-TYPE
 241                 SYNTAX TimeTicks
 242                 MAX-ACCESS read-only
 243                 STATUS current
 244                 DESCRIPTION
 245                         " Storage LRU Expiration Age "
 246         ::= { cacheSysPerf 8 }
 247
 248         cacheCurrentUnlinkRequests OBJECT-TYPE
 249                 SYNTAX Gauge32
 250                 MAX-ACCESS read-only
 251                 STATUS current
 252                 DESCRIPTION
 253                         " Requests given to unlinkd "
 254         ::= { cacheSysPerf 9 }
 255
 256         cacheCurrentUnusedFDescrCnt OBJECT-TYPE
 257                 SYNTAX Gauge32
 258                 MAX-ACCESS read-only
 259                 STATUS current
 260                 DESCRIPTION
 261                         " Available number of file descriptors "
 262         ::= { cacheSysPerf 10 }
 263
 264         cacheCurrentResFileDescrCnt  OBJECT-TYPE
 265                 SYNTAX Gauge32
 266                 MAX-ACCESS read-only
 267                 STATUS current
 268                 DESCRIPTION
 269                         " Reserved number of file descriptors "
 270         ::= { cacheSysPerf 11 }
 271
 272         cacheCurrentFileDescrCnt  OBJECT-TYPE
 273                 SYNTAX Gauge32
 274                 MAX-ACCESS read-only
 275                 STATUS current
 276                 DESCRIPTION
 277                         " Number of file descriptors in use "
 278         ::= { cacheSysPerf 12 }
 279
 280         cacheCurrentFileDescrMax  OBJECT-TYPE
 281                 SYNTAX Gauge32
 282                 MAX-ACCESS read-only
 283                 STATUS current
 284                 DESCRIPTION
 285                         " Highest file descriptors in use "
 286         ::= { cacheSysPerf 13 }
 287
 288         --
 289         -- cacheProtoStats
 290         --
 291
 292                 -- cacheProtoAggregateStats
 293                 --
 294
 295         cacheProtoAggregateStats OBJECT IDENTIFIER ::= { cacheProtoStats 1 }
 296
 297
 298         cacheProtoClientHttpRequests  OBJECT-TYPE
 299                 SYNTAX Counter32
 300                 MAX-ACCESS read-only
 301                 STATUS current
 302                 DESCRIPTION
 303                         " Number of HTTP requests received "
 304         ::= { cacheProtoAggregateStats 1 }
 305
 306         cacheHttpHits OBJECT-TYPE
 307                 SYNTAX Counter32
 308                 MAX-ACCESS read-only
 309                 STATUS current
 310                 DESCRIPTION
 311                         " Number of HTTP Hits "
 312         ::= { cacheProtoAggregateStats 2 }
 313
 314         cacheHttpErrors OBJECT-TYPE
 315                 SYNTAX Counter32
 316                 MAX-ACCESS read-only
 317                 STATUS current
 318                 DESCRIPTION
 319                         " Number of HTTP Errors "
 320         ::= { cacheProtoAggregateStats 3 }
 321
 322         cacheHttpInKb OBJECT-TYPE
 323                 SYNTAX Counter32
 324                 MAX-ACCESS read-only
 325                 STATUS current
 326                 DESCRIPTION
 327                         " Number of HTTP KB's received "
 328         ::= { cacheProtoAggregateStats 4 }
 329
 330         cacheHttpOutKb OBJECT-TYPE
 331                 SYNTAX Counter32
 332                 MAX-ACCESS read-only
 333                 STATUS current
 334                 DESCRIPTION
 335                         " Number of HTTP KB's transmitted "
 336         ::= { cacheProtoAggregateStats 5 }
 337
 338         cacheIcpPktsSent OBJECT-TYPE
 339                 SYNTAX Counter32
 340                 MAX-ACCESS read-only
 341                 STATUS current
 342                 DESCRIPTION
 343                         " Number of ICP messages sent "
 344         ::= { cacheProtoAggregateStats 6 }
 345
 346         cacheIcpPktsRecv OBJECT-TYPE
 347                 SYNTAX Counter32
 348                 MAX-ACCESS read-only
 349                 STATUS current
 350                 DESCRIPTION
 351                         " Number of ICP messages received "
 352         ::= { cacheProtoAggregateStats 7 }
 353
 354         cacheIcpKbSent OBJECT-TYPE
 355                 SYNTAX Counter32
 356                 MAX-ACCESS read-only
 357                 STATUS current
 358                 DESCRIPTION
 359                         " Number of ICP KB's transmitted "
 360         ::= { cacheProtoAggregateStats 8 }
 361
 362         cacheIcpKbRecv OBJECT-TYPE
 363                 SYNTAX Counter32
 364                 MAX-ACCESS read-only
 365                 STATUS current
 366                 DESCRIPTION
 367                         " Number of ICP KB's received "
 368         ::= { cacheProtoAggregateStats 9 }
 369
 370         cacheServerRequests OBJECT-TYPE
 371                 SYNTAX Integer32
 372                 MAX-ACCESS read-only
 373                 STATUS current
 374                 DESCRIPTION
 375                         " All requests from the client for the cache server "
 376         ::= { cacheProtoAggregateStats 10 }
 377
 378         cacheServerErrors OBJECT-TYPE
 379                 SYNTAX Integer32
 380                 MAX-ACCESS read-only
 381                 STATUS current
 382                 DESCRIPTION
 383                         " All errors for the cache server from client requests "
 384         ::= { cacheProtoAggregateStats 11 }
 385
 386         cacheServerInKb OBJECT-TYPE
 387                 SYNTAX Counter32
 388                 MAX-ACCESS read-only
 389                 STATUS current
 390                 DESCRIPTION
 391                         " KB's of traffic received from servers "
 392         ::= { cacheProtoAggregateStats 12 }
 393
 394         cacheServerOutKb OBJECT-TYPE
 395                 SYNTAX Counter32
 396                 MAX-ACCESS read-only
 397                 STATUS current
 398                 DESCRIPTION
 399                         " KB's of traffic sent to servers "
 400         ::= { cacheProtoAggregateStats 13 }
 401
 402         cacheCurrentSwapSize OBJECT-TYPE
 403                 SYNTAX Gauge32
 404                 MAX-ACCESS read-only
 405                 STATUS current
 406                 DESCRIPTION
 407                         " Storage Swap size "
 408         ::= { cacheProtoAggregateStats 14 }
 409
 410        cacheClients OBJECT-TYPE
 411                 SYNTAX Gauge32
 412                 MAX-ACCESS read-only
 413                 STATUS current
 414                 DESCRIPTION
 415                         " Number of clients accessing cache "
 416         ::= { cacheProtoAggregateStats 15 }
 417
 418         --
 419         -- cacheProtoMedianSvcStats group
 420         --
 421         -- This is a table, indexed by the interval we want statistics for
 422         -- Example: cacheDnsSvcTime.10 gives 10-min medians for Dns Service Time.
 423
 424         cacheMedianSvcTable OBJECT-TYPE
 425                 SYNTAX SEQUENCE OF CacheMedianSvcEntry
 426                 MAX-ACCESS not-accessible
 427                 STATUS current
 428                 DESCRIPTION
 429                         " CacheMedianSvcTable "
 430         ::= { cacheProtoStats 2 }
 431
 432         cacheMedianSvcEntry OBJECT-TYPE
 433                 SYNTAX CacheMedianSvcEntry
 434                 MAX-ACCESS not-accessible
 435                 STATUS current
 436                 DESCRIPTION
 437                         " An entry in cacheMedianSvcTable "
 438                 INDEX   { cacheMedianTime }
 439         ::= { cacheMedianSvcTable 1 }
 440
 441         CacheMedianSvcEntry ::= SEQUENCE {
 442                 cacheMedianTime         Integer32,
 443                 cacheHttpAllSvcTime     Integer32,
 444                 cacheHttpMissSvcTime    Integer32,
 445                 cacheHttpNmSvcTime      Integer32,
 446                 cacheHttpHitSvcTime     Integer32,
 447                 cacheIcpQuerySvcTime    Integer32,
 448                 cacheIcpReplySvcTime    Integer32,
 449                 cacheDnsSvcTime         Integer32,
 450                 cacheRequestHitRatio    Integer32,
 451                 cacheRequestByteRatio   Integer32,
 452                 cacheHttpNhSvcTime      Integer32
 453         }
 454
 455         cacheMedianTime OBJECT-TYPE
 456                 SYNTAX Integer32 (1|5|60)
 457                 MAX-ACCESS not-accessible
 458                 STATUS current
 459                 DESCRIPTION
 460                         " The value used to index the table 1/5/60"
 461         ::= { cacheMedianSvcEntry 1 }
 462
 463         cacheHttpAllSvcTime OBJECT-TYPE
 464                 SYNTAX Integer32
 465                 MAX-ACCESS read-only
 466                 STATUS current
 467                 DESCRIPTION
 468                         " HTTP all service time "
 469         ::= { cacheMedianSvcEntry 2 }
 470
 471         cacheHttpMissSvcTime OBJECT-TYPE
 472                 SYNTAX Integer32
 473                 MAX-ACCESS read-only
 474                 STATUS current
 475                 DESCRIPTION
 476                         " HTTP miss service time "
 477         ::= { cacheMedianSvcEntry 3 }
 478
 479         cacheHttpNmSvcTime OBJECT-TYPE
 480                 SYNTAX Integer32
 481                 MAX-ACCESS read-only
 482                 STATUS current
 483                 DESCRIPTION
 484                         " HTTP hit not-modified service time "
 485         ::= { cacheMedianSvcEntry 4 }
 486
 487         cacheHttpHitSvcTime OBJECT-TYPE
 488                 SYNTAX Integer32
 489                 MAX-ACCESS read-only
 490                 STATUS current
 491                 DESCRIPTION
 492                         " HTTP hit service time "
 493         ::= { cacheMedianSvcEntry 5 }
 494
 495         cacheIcpQuerySvcTime OBJECT-TYPE
 496                 SYNTAX Integer32
 497                 MAX-ACCESS read-only
 498                 STATUS current
 499                 DESCRIPTION
 500                         " ICP query service time "
 501         ::= { cacheMedianSvcEntry 6 }
 502
 503         cacheIcpReplySvcTime OBJECT-TYPE
 504                 SYNTAX Integer32
 505                 MAX-ACCESS read-only
 506                 STATUS current
 507                 DESCRIPTION
 508                         " ICP reply service time "
 509         ::= { cacheMedianSvcEntry 7 }
 510
 511         cacheDnsSvcTime OBJECT-TYPE
 512                 SYNTAX Integer32
 513                 MAX-ACCESS read-only
 514                 STATUS current
 515                 DESCRIPTION
 516                         " DNS service time "
 517         ::= { cacheMedianSvcEntry 8 }
 518
 519         cacheRequestHitRatio OBJECT-TYPE
 520                 SYNTAX Integer32
 521                 MAX-ACCESS read-only
 522                 STATUS current
 523                 DESCRIPTION
 524                         " Request Hit Ratios "
 525         ::= { cacheMedianSvcEntry 9 }
 526
 527         cacheRequestByteRatio OBJECT-TYPE
 528                 SYNTAX Integer32
 529                 MAX-ACCESS read-only
 530                 STATUS current
 531                 DESCRIPTION
 532                         " Byte Hit Ratios "
 533         ::= { cacheMedianSvcEntry 10 }
 534
 535         cacheHttpNhSvcTime OBJECT-TYPE
 536                 SYNTAX Integer32
 537                 MAX-ACCESS read-only
 538                 STATUS current
 539                 DESCRIPTION
 540                         " HTTP refresh hit service time "
 541         ::= { cacheMedianSvcEntry 11 }
 542
 543 --
 544 -- cacheNetwork group { squid 4 }
 545 --
 546 -- This material is probably best suited elsewhere, however for now it
 547 -- will reside here until the both the Proxy and Squid MIBs are implemented.
 548 --
 549
 550         cacheIpCache    OBJECT IDENTIFIER ::= { cacheNetwork 1 }
 551         cacheFqdnCache  OBJECT IDENTIFIER ::= { cacheNetwork 2 }
 552         cacheDns        OBJECT IDENTIFIER ::= { cacheNetwork 3 }
 553
 554 --
 555 -- cacheIpCache
 556 --
 557
 558         cacheIpEntries OBJECT-TYPE
 559                 SYNTAX Gauge32
 560                 MAX-ACCESS read-only
 561                 STATUS current
 562                 DESCRIPTION
 563                         " IP Cache Entries "
 564         ::= { cacheIpCache 1 }
 565
 566         cacheIpRequests OBJECT-TYPE
 567                 SYNTAX Counter32
 568                 MAX-ACCESS read-only
 569                 STATUS current
 570                 DESCRIPTION
 571                         " Number of IP Cache requests "
 572         ::= { cacheIpCache 2 }
 573
 574         cacheIpHits OBJECT-TYPE
 575                 SYNTAX Counter32
 576                 MAX-ACCESS read-only
 577                 STATUS current
 578                 DESCRIPTION
 579                         " Number of IP Cache hits "
 580         ::= { cacheIpCache 3 }
 581
 582         cacheIpPendingHits OBJECT-TYPE
 583                 SYNTAX Gauge32
 584                 MAX-ACCESS read-only
 585                 STATUS current
 586                 DESCRIPTION
 587                         " Number of IP Cache pending hits "
 588         ::= { cacheIpCache 4 }
 589
 590         cacheIpNegativeHits OBJECT-TYPE
 591                 SYNTAX Counter32
 592                 MAX-ACCESS read-only
 593                 STATUS current
 594                 DESCRIPTION
 595                         " Number of IP Cache negative hits "
 596         ::= { cacheIpCache 5 }
 597
 598         cacheIpMisses OBJECT-TYPE
 599                 SYNTAX Counter32
 600                 MAX-ACCESS read-only
 601                 STATUS current
 602                 DESCRIPTION
 603                         " Number of IP Cache misses "
 604         ::= { cacheIpCache 6 }
 605
 606         cacheBlockingGetHostByName OBJECT-TYPE
 607                 SYNTAX Counter32
 608                 MAX-ACCESS read-only
 609                 STATUS current
 610                 DESCRIPTION
 611                         " Number of blocking gethostbyname requests "
 612         ::= { cacheIpCache 7 }
 613
 614         cacheAttemptReleaseLckEntries OBJECT-TYPE
 615                 SYNTAX Counter32
 616                 MAX-ACCESS read-only
 617                 STATUS current
 618                 DESCRIPTION
 619                         " Number of attempts to release locked IP Cache entries "
 620         ::= { cacheIpCache 8 }
 621
 622 --
 623 -- cacheFqdnCache
 624 --
 625
 626         cacheFqdnEntries OBJECT-TYPE
 627                 SYNTAX Gauge32
 628                 MAX-ACCESS read-only
 629                 STATUS current
 630                 DESCRIPTION
 631                         " FQDN Cache entries "
 632         ::= { cacheFqdnCache 1 }
 633
 634         cacheFqdnRequests OBJECT-TYPE
 635                 SYNTAX Counter32
 636                 MAX-ACCESS read-only
 637                 STATUS current
 638                 DESCRIPTION
 639                         " Number of FQDN Cache requests "
 640         ::= { cacheFqdnCache 2 }
 641
 642         cacheFqdnHits OBJECT-TYPE
 643                 SYNTAX Counter32
 644                 MAX-ACCESS read-only
 645                 STATUS current
 646                 DESCRIPTION
 647                         " Number of FQDN Cache hits "
 648         ::= { cacheFqdnCache 3 }
 649
 650         cacheFqdnPendingHits OBJECT-TYPE
 651                 SYNTAX Gauge32
 652                 MAX-ACCESS read-only
 653                 STATUS current
 654                 DESCRIPTION
 655                         " Number of FQDN Cache pending hits "
 656         ::= { cacheFqdnCache 4 }
 657
 658         cacheFqdnNegativeHits OBJECT-TYPE
 659                 SYNTAX Counter32
 660                 MAX-ACCESS read-only
 661                 STATUS current
 662                 DESCRIPTION
 663                         " Number of FQDN Cache negative hits "
 664         ::= { cacheFqdnCache 5 }
 665
 666         cacheFqdnMisses OBJECT-TYPE
 667                 SYNTAX Counter32
 668                 MAX-ACCESS read-only
 669                 STATUS current
 670                 DESCRIPTION
 671                         " Number of FQDN Cache misses "
 672         ::= { cacheFqdnCache 6 }
 673
 674         cacheBlockingGetHostByAddr OBJECT-TYPE
 675                 SYNTAX Counter32
 676                 MAX-ACCESS read-only
 677                 STATUS current
 678                 DESCRIPTION
 679                         " Number of blocking gethostbyaddr requests "
 680         ::= { cacheFqdnCache 7 }
 681
 682 --
 683 --      cacheDNS
 684 --
 685
 686         cacheDnsRequests OBJECT-TYPE
 687                 SYNTAX Counter32
 688                 MAX-ACCESS read-only
 689                 STATUS current
 690                 DESCRIPTION
 691                         " Number of external DNS server requests "
 692         ::= { cacheDns 1 }
 693
 694         cacheDnsReplies OBJECT-TYPE
 695                 SYNTAX Counter32
 696                 MAX-ACCESS read-only
 697                 STATUS current
 698                 DESCRIPTION
 699                         " Number of external DNS server replies "
 700         ::= { cacheDns 2 }
 701
 702         cacheDnsNumberServers OBJECT-TYPE
 703                 SYNTAX Counter32
 704                 MAX-ACCESS read-only
 705                 STATUS current
 706                 DESCRIPTION
 707                         " Number of external DNS server processes "
 708         ::= { cacheDns 3 }
 709
 710 --
 711 -- cacheMesh group { squid 5 }
 712 --
 713
 714         cachePeerTable OBJECT-TYPE
 715                 SYNTAX SEQUENCE OF CachePeerTableEntry
 716                 MAX-ACCESS not-accessible
 717                 STATUS current
 718                 DESCRIPTION
 719                         " This table contains an enumeration of
 720                           the peer caches, complete with info "
 721         ::= { cacheMesh 1 }
 722
 723         cachePeerEntry OBJECT-TYPE
 724                 SYNTAX CachePeerTableEntry
 725                 MAX-ACCESS not-accessible
 726                 STATUS current
 727                 DESCRIPTION
 728                         " An entry in cachePeerTable (version 3) "
 729                 INDEX   { cachePeerIndex }
 730         ::= { cachePeerTable 3 }
 731
 732         CachePeerTableEntry ::= SEQUENCE {
 733           cachePeerIndex        CachePeerTableIndex,
 734           cachePeerName         DisplayString,
 735           cachePeerAddressType  InetAddressType,
 736           cachePeerAddress      InetAddress,
 737           cachePeerPortHttp     ValidPort,
 738           cachePeerPortIcp      ValidPort,
 739           cachePeerType         Integer32,
 740           cachePeerState        Integer32,
 741           cachePeerPingsSent    Counter32,
 742           cachePeerPingsAcked   Counter32,
 743           cachePeerFetches      Counter32,
 744           cachePeerRtt          Integer32,
 745           cachePeerIgnored      Counter32,
 746           cachePeerKeepAlSent   Counter32,
 747           cachePeerKeepAlRecv   Counter32
 748         }
 749
 750         ValidPort ::= TEXTUAL-CONVENTION
 751              DISPLAY-HINT "d"
 752              STATUS       current
 753              DESCRIPTION
 754                                 "A integer value from 1 to 65535 to indicate
 755                                 the appropriate port number for the connection."
 756                         SYNTAX       Integer32 (1..65535)
 757
 758         CachePeerTableIndex ::= TEXTUAL-CONVENTION
 759              DISPLAY-HINT "d"
 760              STATUS       current
 761              DESCRIPTION
 762                "A unique value, greater than zero for each
 763                cache peer instance in the managed
 764                system. It is recommended that values are assigned
 765                contiguously starting from 1. The value for each
 766                cache peer index must remain constant
 767                at least from one re-initialization of the entity's
 768                network management system to the next
 769                re-initialization."
 770              SYNTAX       Integer32 (1..2147483647)
 771
 772
 773         cachePeerIndex OBJECT-TYPE
 774                 SYNTAX CachePeerTableIndex
 775                 MAX-ACCESS read-only
 776                 STATUS current
 777                 DESCRIPTION
 778                            "A unique non-zero value identifying
 779                              the particular cache Peer."
 780         ::= { cachePeerEntry 1 }
 781
 782         cachePeerName OBJECT-TYPE
 783                 SYNTAX DisplayString
 784                 MAX-ACCESS read-only
 785                 STATUS current
 786                 DESCRIPTION
 787                           " The FQDN name or internal alias for the
 788                             peer cache "
 789         ::= { cachePeerEntry 2 }
 790
 791         cachePeerAddressType OBJECT-TYPE
 792         SYNTAX      InetAddressType
 793         MAX-ACCESS  read-only
 794         STATUS      current
 795         DESCRIPTION
 796                 "The type of Internet address by which the peer
 797                 cache is reachable."
 798
 799         ::= { cachePeerEntry 3 }
 800
 801         cachePeerAddress OBJECT-TYPE
 802         SYNTAX      InetAddress (SIZE (1..64))
 803         MAX-ACCESS  read-only
 804         STATUS      current
 805         DESCRIPTION
 806         "The Internet address for the peer cache.  The type of this
 807          address is determined by the value of the peerAddressType
 808          object.  Note that implementations must limit themselves
 809          to a single entry in this table per reachable peer.
 810          The peerAddress may not be empty due to the SIZE
 811          restriction.
 812
 813          If a row is created administratively by an SNMP
 814          operation and the address type value is dns(16), then
 815          the agent stores the DNS name internally.  A DNS name
 816          lookup must be performed on the internally stored DNS
 817          name whenever it is being used to contact the peer.
 818
 819          If a row is created by the managed entity itself and
 820          the address type value is dns(16), then the agent
 821          stores the IP address internally.  A DNS reverse lookup
 822          must be performed on the internally stored IP address
 823          whenever the value is retrieved via SNMP."
 824          ::= { cachePeerEntry 4 }
 825
 826
 827         cachePeerPortHttp OBJECT-TYPE
 828                 SYNTAX ValidPort
 829                 MAX-ACCESS read-only
 830                 STATUS current
 831                 DESCRIPTION
 832                         " The port the peer listens for HTTP requests "
 833         ::= { cachePeerEntry 5 }
 834
 835         cachePeerPortIcp OBJECT-TYPE
 836                 SYNTAX ValidPort
 837                 MAX-ACCESS read-only
 838                 STATUS current
 839                 DESCRIPTION
 840                         " The port the peer listens for ICP requests
 841                           should be 0 if not configured to send ICP requests "
 842         ::= { cachePeerEntry 6 }
 843
 844         cachePeerType OBJECT-TYPE
 845                 SYNTAX Integer32
 846                 MAX-ACCESS read-only
 847                 STATUS current
 848                 DESCRIPTION
 849                         " Peer Type "
 850         ::= { cachePeerEntry 7 }
 851
 852         cachePeerState OBJECT-TYPE
 853                 SYNTAX Integer32
 854                 MAX-ACCESS read-only
 855                 STATUS current
 856                 DESCRIPTION
 857                         " The operational state of this peer "
 858         ::= { cachePeerEntry 8 }
 859
 860         cachePeerPingsSent OBJECT-TYPE
 861                 SYNTAX Counter32
 862                 MAX-ACCESS read-only
 863                 STATUS current
 864                 DESCRIPTION
 865                         " Number of pings sent to peer "
 866         ::= { cachePeerEntry 9 }
 867
 868         cachePeerPingsAcked OBJECT-TYPE
 869                 SYNTAX Counter32
 870                 MAX-ACCESS read-only
 871                 STATUS current
 872                 DESCRIPTION
 873                         " Number of pings received from peer "
 874         ::= {  cachePeerEntry 10 }
 875
 876         cachePeerFetches OBJECT-TYPE
 877                 SYNTAX Counter32
 878                 MAX-ACCESS read-only
 879                 STATUS current
 880                 DESCRIPTION
 881                         " Number of times this peer was selected  "
 882         ::= { cachePeerEntry 11 }
 883
 884         cachePeerRtt OBJECT-TYPE
 885                 SYNTAX Integer32
 886                 MAX-ACCESS read-only
 887                 STATUS current
 888                 DESCRIPTION
 889                         " Last known round-trip time to the peer (in ms) "
 890         ::= { cachePeerEntry 12 }
 891
 892         cachePeerIgnored OBJECT-TYPE
 893                 SYNTAX Counter32
 894                 MAX-ACCESS read-only
 895                 STATUS current
 896                 DESCRIPTION
 897                         " How many times this peer was ignored "
 898         ::= { cachePeerEntry 13 }
 899
 900         cachePeerKeepAlSent OBJECT-TYPE
 901                 SYNTAX Counter32
 902                 MAX-ACCESS read-only
 903                 STATUS current
 904                 DESCRIPTION
 905                         " Number of keepalives sent "
 906         ::= { cachePeerEntry 14 }
 907
 908         cachePeerKeepAlRecv OBJECT-TYPE
 909                 SYNTAX Counter32
 910                 MAX-ACCESS read-only
 911                 STATUS current
 912                 DESCRIPTION
 913                         " Number of keepalives received "
 914         ::= { cachePeerEntry 15 }
 915
 916 ---
 917 --- Table of cache's clients, with statistics. Children caches can be identified
 918 --- by non-zero number of ICP requests (unless browsers start using ICP).
 919 ---
 920
 921         cacheClientTable OBJECT-TYPE
 922            SYNTAX  SEQUENCE OF CacheClientEntry
 923            MAX-ACCESS  not-accessible
 924            STATUS  current
 925            DESCRIPTION
 926                     "A list of cache client entries."
 927         ::= { cacheMesh 2 }
 928
 929         cacheClientEntry OBJECT-TYPE
 930            SYNTAX CacheClientEntry
 931            MAX-ACCESS  not-accessible
 932            STATUS  current
 933            DESCRIPTION
 934                     "An IP entry in cacheClientTable "
 935            INDEX { cacheClientAddress }
 936         ::= { cacheClientTable 2 }
 937
 938         CacheClientEntry ::= SEQUENCE {
 939                 cacheClientAddressType  InetAddressType,
 940                 cacheClientAddress      InetAddress,
 941                 cacheClientHttpRequests Counter32,
 942                 cacheClientHttpKb       Counter32,
 943                 cacheClientHttpHits     Counter32,
 944                 cacheClientHTTPHitKb    Counter32,
 945                 cacheClientIcpRequests  Counter32,
 946                 cacheClientIcpKb        Counter32,
 947                 cacheClientIcpHits      Counter32,
 948                 cacheClientIcpHitKb     Counter32
 949         }
 950
 951         cacheClientAddressType OBJECT-TYPE
 952                 SYNTAX InetAddressType
 953                 MAX-ACCESS read-only
 954                 STATUS current
 955                 DESCRIPTION
 956                     "The client's IP address "
 957         ::= { cacheClientEntry 1 }
 958
 959         cacheClientAddress OBJECT-TYPE
 960         SYNTAX      InetAddress (SIZE (1..64))
 961         MAX-ACCESS  read-only
 962         STATUS      current
 963         DESCRIPTION
 964         "The Internet address for the client.  The type of this
 965          address is determined by the value of the peerAddressType
 966          object.  Note that implementations must limit themselves
 967          to a single entry in this table per reachable peer.
 968          The peerAddress may not be empty due to the SIZE
 969          restriction.
 970
 971          If a row is created administratively by an SNMP
 972          operation and the address type value is dns(16), then
 973          the agent stores the DNS name internally.  A DNS name
 974          lookup must be performed on the internally stored DNS
 975          name whenever it is being used to contact the peer.
 976
 977          If a row is created by the managed entity itself and
 978          the address type value is dns(16), then the agent
 979          stores the IP address internally.  A DNS reverse lookup
 980          must be performed on the internally stored IP address
 981          whenever the value is retrieved via SNMP."
 982          ::= { cacheClientEntry 2 }
 983
 984         cacheClientHttpRequests OBJECT-TYPE
 985                 SYNTAX Counter32
 986                 MAX-ACCESS read-only
 987                 STATUS current
 988                 DESCRIPTION
 989                     " Number of HTTP requests received from client "
 990         ::= { cacheClientEntry 3 }
 991
 992         cacheClientHttpKb OBJECT-TYPE
 993                 SYNTAX Counter32
 994                 MAX-ACCESS read-only
 995                 STATUS current
 996                 DESCRIPTION
 997                     " Amount of total HTTP traffic to this client  "
 998         ::= { cacheClientEntry 4 }
 999
1000         cacheClientHttpHits OBJECT-TYPE
1001                 SYNTAX Counter32
1002                 MAX-ACCESS read-only
1003                 STATUS current
1004                 DESCRIPTION
1005                     " Number of hits in response to this client's HTTP requests "
1006         ::= { cacheClientEntry 5 }
1007
1008         cacheClientHTTPHitKb OBJECT-TYPE
1009                 SYNTAX Counter32
1010                 MAX-ACCESS read-only
1011                 STATUS current
1012                 DESCRIPTION
1013                     " Amount of HTTP hit traffic in KB "
1014         ::= { cacheClientEntry 6 }
1015
1016         cacheClientIcpRequests OBJECT-TYPE
1017                 SYNTAX Counter32
1018                 MAX-ACCESS read-only
1019                 STATUS current
1020                 DESCRIPTION
1021                     " Number of ICP requests received from client "
1022         ::= { cacheClientEntry 7 }
1023
1024         cacheClientIcpKb OBJECT-TYPE
1025                 SYNTAX Counter32
1026                 MAX-ACCESS read-only
1027                 STATUS current
1028                 DESCRIPTION
1029                     " Amount of total ICP traffic to this client (child) "
1030         ::= { cacheClientEntry 8 }
1031
1032         cacheClientIcpHits OBJECT-TYPE
1033                 SYNTAX Counter32
1034                 MAX-ACCESS read-only
1035                 STATUS current
1036                 DESCRIPTION
1037                     " Number of hits in response to this client's ICP requests "
1038         ::= { cacheClientEntry 9 }
1039
1040         cacheClientIcpHitKb OBJECT-TYPE
1041                 SYNTAX Counter32
1042                 MAX-ACCESS read-only
1043                 STATUS current
1044                 DESCRIPTION
1045                     " Amount of ICP hit traffic in KB "
1046         ::= { cacheClientEntry 10 }
1047
1048         -- end of cacheClientTable
1049
1050
1051     -- end of cacheMesh group
1052
1053 -- end of SQUID-MIB
1054 --
1055 END
1056