Non-sample based Rhino statistics (all gauges and counters) that are registered according to the legacy OID model are accessible via SNMP tables.

SNMP Table Structure

Each SNMP table represents a single parameter set type. The values in each SNMP table represent statistics from the individual parameter sets associated with the table’s parameter set type. Each table uses the name of a parameter set, converted to an OID, as a table index. Individual table rows represent parameter sets, while the table columns represent statistics from the parameter set type.

The first column is special, as it contains the parameter set index value as a string. For the purposes of SNMP, the name of the root parameter set for each parameter set type can be considered "(root)".

All other parameter sets use their normal parameter set names, converted to OIDs, as index keys.

For example, the following output (generated using snmpwalk) shows the legacy OID model registered example Usage.Services.SbbID[name=UsageTestSbb,vendor=OpenCloud,version=1.0] parameter set type’s representation in the SNMP agent as OIDs:

1.3.6.1.4.1.19808.2.1.300.1.0 = INTEGER: 2
1.3.6.1.4.1.19808.2.1.300.2.1.1.TestSBBTableIndex.(default) = STRING: "Services.S-7cb11624-,vendor=OpenCloud,version=1.0].(default)"
1.3.6.1.4.1.19808.2.1.300.2.1.1.TestSBBTableIndex = STRING: "[Services.S-f36d2ae2-ageTestSbb,vendor=OpenCloud,version=1.0]"
1.3.6.1.4.1.19808.2.1.300.2.1.2.TestSBBTableIndex.(default) = Counter64: 0
1.3.6.1.4.1.19808.2.1.300.2.1.2.TestSBBTableIndex = Counter64: 0
1.3.6.1.4.1.19808.2.1.300.2.1.3.TestSBBTableIndex.(default) = Counter64: 0
1.3.6.1.4.1.19808.2.1.300.2.1.3.TestSBBTableIndex = Counter64: 0

Note
What the colors represent
  • Blue: The base OID for the Usage.Services.SbbID[name=UsageTestSbb,vendor=OpenCloud,version=1.0] parameter set type. This can be either statically or dynamically set.

  • Yellow: A subindex for data associated with this parameter set type:
    .1 represents the parameter set count for this parameter set type.
    .2 represents the parameter set data table.

  • Olive: A fixed number representing the table entry OID. This will always be .1.

  • Green: Statistic columns. The first column (.1) represents the parameter set name for a given table row. The rest of the columns correspond to individual statistics.

  • Red: The table index. This example has substituted the OID representation of the table index with the TestSBBTableIndex and TestSBBTableIndex.(default) variables.

  • Purple: The raw statistic values.

The OID representation of the table indices in this example is as follows:

  • TestSBBTableIndex is the string Services.S-f36d2ae2-ageTestSbb,vendor=OpenCloud,version=1.0] stored in an OID representation as:

83.101.114.118.105.99.101.115.46.83.45.102.51.54.100.50.97.101.50.45.97.103.101.84.101.115.116.83.98.98.44.118.101.110.100.111.114.61.79.112.101.110.67.108.111.117.100.44.118.101.114.115.105.111.110.61.49.46.48.93
  • TestSBBTableIndex.(default) is the string Services.S-7cb11624-,vendor=OpenCloud,version=1.0].(default) stored in an OID representation as:

83.101.114.118.105.99.101.115.46.83.45.55.99.98.49.49.54.50.52.45.44.118.101.110.100.111.114.61.79.112.101.110.67.108.111.117.100.44.118.101.114.115.105.111.110.61.49.46.48.93.46.40.100.101.102.97.117.108.116.41

These table indices have parameter set names that are longer than 255 characters. Therefore, the stored representation is truncated, leading to the -f36d2ae2- and -7cb11624- gaps in the decoded strings.

Warning

For static model non-statically mapped parameter sets and legacy model parameter sets, exceptionally long parameter set names may be truncated if their OID representation is longer than 255 characters. This is to prevent pathname length problems with management clients that store SNMP statistics in files named after the index OID.

Tip

For usage parameter set types, the base OID and individual statistics can be specified in annotations described in Annotations. For statistics parameter set type in resource adaptor, the base OID can be specified in element stats-parameter-set-type in oc-resource-adaptor-jar.xml. Otherwise, they will be dynamically allocated according to the range specified in Dynamic Rhino monitoring parameter sets.

Previous page Next page
Rhino Version 3.1