Queryhost - Listing

Details about using the queryhost endpoint to list interfaces

Valid parameters are:

  • hostname - hostname of the server as stored within the database. Required
  • ip - Hostname or IP address. Required if not using hostname or if this is a new host
  • snmp_version - one of 1, 2c or 3. Required if not using hostname or if this is a new host
  • hostid - hostid of the host from the DB. Not required if this is a new host.
  • msid - the monitoring cluster that the query is to be run from. Will use the first node if it is a cluster. Can be set to the primary collector, which is set to 1. Default is primary.
  • snmp_port - port for snmp to listen for devices. Defaults to 161.

The remaining parameters for QueryHost depends on the version of SNMP requested.

Version 1 and 2c

The parameters required are:

  • snmp_community - the community string

Version 3

Extra information is required to satify the snmpv3 credentials. These must be added to the call.

  • snmpv3_username
  • snmpv3_authpassword
  • snmpv3_authprotocol
  • snmpv3_privpassword
  • snmpv3_privprotocol

Listing interfaces

Output of a list response (NOTE: id => 0 is used to set the default threasholds for all interfaces and is not a 'real' interface):

{
  interfaces => [
    {
      discards_critical => 15,
      discards_warning => "",
      errors_critical => 10,
      errors_warning => "",
      extra_info => "alias:'' speed:'' link:'' status:''",
      id => 0,
      ifAlias => undef,
      ifDescr => "",
      ifLink => undef,
      ifSpeed => undef,
      ifStatus => undef,
      interfacename => "",
      throughput_critical => "0:50%",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'192.168.13.0 network' speed:'10Mbit/s' link:'up' status:'up'",
      id => 1,
      ifAlias => "192.168.13.0 network",
      ifDescr => "Ethernet0/0",
      ifLink => "up",
      ifSpeed => "10Mbit/s",
      ifStatus => "up",
      interfacename => "Ethernet0/0",
      throughput_critical => "",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'192.168.21.0 network' speed:'10Mbit/s' link:'down' status:'down'",
      id => 3,
      ifAlias => "192.168.21.0 network",
      ifDescr => "Ethernet0/1",
      ifLink => "down",
      ifSpeed => "10Mbit/s",
      ifStatus => "down",
      interfacename => "Ethernet0/1",
      throughput_critical => "",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'' speed:'8Gbit/s' link:'up' status:'up'",
      id => 5,
      ifAlias => "",
      ifDescr => "Loopback0",
      ifLink => "up",
      ifSpeed => "8Gbit/s",
      ifStatus => "up",
      interfacename => "Loopback0",
      throughput_critical => "",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'' speed:'10Gbit/s' link:'up' status:'up'",
      id => 4,
      ifAlias => "",
      ifDescr => "Null0",
      ifLink => "up",
      ifSpeed => "10Gbit/s",
      ifStatus => "up",
      interfacename => "Null0",
      throughput_critical => "",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'192.168.250.0 network' speed:'2Mbit/s' link:'up' status:'down'",
      id => 2,
      ifAlias => "192.168.250.0 network",
      ifDescr => "Serial0/0",
      ifLink => "up",
      ifSpeed => "2Mbit/s",
      ifStatus => "down",
      interfacename => "Serial0/0",
      throughput_critical => "",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'up'",
      id => 7,
      ifAlias => "",
      ifDescr => "Virtual-Access1",
      ifLink => "up",
      ifSpeed => "100Mbit/s",
      ifStatus => "up",
      interfacename => "Virtual-Access1",
      throughput_critical => "",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'down'",
      id => 8,
      ifAlias => "",
      ifDescr => "Virtual-Access2",
      ifLink => "up",
      ifSpeed => "100Mbit/s",
      ifStatus => "down",
      interfacename => "Virtual-Access2",
      throughput_critical => "",
      throughput_warning => "",
    },
    {
      discards_critical => "",
      discards_warning => "",
      errors_critical => "",
      errors_warning => "",
      extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'down'",
      id => 6,
      ifAlias => "",
      ifDescr => "Virtual-Template1",
      ifLink => "up",
      ifSpeed => "100Mbit/s",
      ifStatus => "down",
      interfacename => "Virtual-Template1",
      throughput_critical => "",
      throughput_warning => "",
    },
  ],
  system_description => "Cisco Internetwork Operating System Software",
}

Testing Connection

{
    system_description => "Cisco Internetwork Operating System Software",
}