HomeGuidesAPI Reference
GuidesAPI ReferenceGitHubAirheads Developer CommunityLog In
Guides

Monitoring-IAP Streaming Event

This section provides information on the IAP device based streaming events within the Monitoring topic.

Protocol Buffer messages for IAP devices in Monitoring Topic

The following are the sample protocol buffer messages for IAP devices in the Monitoring Streaming topic.

message Swarm 
{
optional Action action = 1 [default = UPDATE]; // Mandatory
optional string swarm_id = 2; // Mandatory
optional string name = 3; // Mandatory  
optional Status status = 4 [default = UP]; // Mandatory
optional IpAddress public_ip_address = 5;
optional IpAddress ip_address = 6;
optional string firmware_version = 7; // Mandatory
}
message Tunnel 
{
optional Action action = 1 [default = UPDATE]; // Mandatory
optional string swarm_id = 2; // Mandatory
optional TunnelIndex index = 3;
optional CryptoType crypto_type = 4; // Mandatory
optional string peer_name = 5; // Mandatory
optional IpAddress peer_tun_ip = 6;
optional IpAddress tunnel_ip = 7;
optional Status status = 8 [default = UP]; // Mandatory
optional bool active = 9; // Mandatory
optional uint32 uptime = 10; // Mandatory
optional uint64 tunnel_id = 11; // Mandatory
}
message Interface 
{
optional Action action = 1 [default = UPDATE]; // Mandatory

optional string device_id = 2; // Mandatory
optional MacAddress macaddr = 3; // Mandatory
optional Status status = 4 [default = UP]; // Mandatory
optional IpAddress ipaddr = 5;
optional Duplex duplex_mode = 6; 
optional string name = 7; // Mandatory
optional string port_number = 8; // Mandatory
optional IntfType type = 9; // Mandatory
optional string mode = 10;
optional uint32 vlan = 11;
optional PoeSupport has_poe = 12 [default = NA]; 
optional Status poe_state = 13 [default = UP];
optional Status oper_state = 14 [default = UP]; // Mandatory
optional Status admin_state = 15 [default = UP]; // Mandatory
optional SpeedType speed = 16; // Mandatory
optional uint32 mux = 17;
optional uint32 trusted = 18;
optional string slot = 19;
optional PortType phy_type = 20;
optional string sub_type = 21;
repeated uint32 allowed_vlan = 22;
optional uint32 native_vlan = 23;
optional bool vsx_enabled = 24;
optional StateDownReason state_down_reason = 25;
optional VlanModes vlan_mode = 26;
}
message VapInfo {
optional Action action = 1 [default = UPDATE]; // Mandatory 
optional string device_id = 2; // Mandatory
optional MacAddress radio_mac = 3; // Mandatory
optional bytes essid = 4; // Mandatory
optional MacAddress ap_mac = 5;
optional MacAddress bssid = 6;
}
message Radio 
{
optional Action action = 1 [default = UPDATE]; // Mandatory
optional string device_id = 2; // Mandatory
optional uint32 index = 3; // Mandatory
optional MacAddress macaddr = 4; // Mandatory
optional Status status = 5 [default = UP]; // Mandatory
optional string channel = 6; // Mandatory
optional uint32 band = 7; // Mandatory
optional uint32 channel_width = 8; // Mandatory
optional MacAddress ap_mac = 9;
}
message Ap 
{
optional Action action = 1 [default = UPDATE]; // Mandatory  
optional string serial = 2; // Mandatory
optional string name = 3; // Mandatory
optional MacAddress macaddr = 4; // Mandatory
optional string cluster_id = 5; // Mandatory
optional Status status = 6 [default = UP]; // Mandatory  
optional IpAddress ip_address = 7;
optional string model = 8; // Mandatory
optional string mesh_role = 9; // Mandatory
optional string mode = 10; // Mandatory
optional bool swarm_master = 11; // Mandatory
optional bool modem_connected = 12;
optional UplinkType uplink_type = 13;
optional string firmware_version = 14;
}
message Network {
optional Action action = 1 [default = UPDATE]; // Mandatory
optional string swarm_id = 2; // Mandatory
optional bytes essid = 3; // Mandatory
optional string security = 4; // Mandatory
optional string type = 5; // Mandatory
}
message DeviceStats
{
optional string device_id = 1; // Mandatory
optional uint32 timestamp = 2; // Mandatory
optional uint64 uptime = 3; // Mandatory
optional uint32 cpu_utilization = 4; // Mandatory for IAP and HP switches.
optional uint64 mem_total = 5; // Mandatory for IAP and HP switches.
optional uint64 mem_free = 6; // Mandatory for IAP and HP switches.
optional uint32 power_consumption = 7;
optional uint32 fan_speed = 8;
optional uint32 temperature = 9;
optional Status fan_status = 10;
optional uint32 max_power = 11;
optional uint32 poe_consumption = 12;
optional uint32 poe_budget = 13;
optional uint64 mem_utilization = 14;
}
message RadioStats 
{
optional string device_id = 1; // Mandatory
optional MacAddress macaddr = 2; // Mandatory
optional uint32 timestamp = 3; // Mandatory
optional uint64 tx_bytes = 4; // Mandatory
optional uint64 rx_bytes = 5; // Mandatory
optional uint32 tx_drops = 6; // Mandatory
optional uint32 tx_power = 7; // Mandatory
optional uint32 noise_floor = 8; // Mandatory
optional uint32 utilization = 9; // Mandatory
optional uint64 rx_bad = 10; // Mandatory
}
message VapStats 
{
optional string device_id = 1; // Mandatory
optional MacAddress radio_mac = 2; // Mandatory
optional bytes network = 3; // Mandatory
optional uint32 timestamp = 4; // Mandatory
optional uint64 tx_bytes = 5; // Mandatory
optional uint64 rx_bytes = 6; // Mandatory
}
message TunnelStats 
{
optional string swarm_id = 1; // Mandatory
optional TunnelIndex index = 2; 
optional uint32 timestamp = 3; // Mandatory
optional uint64 tx_bytes = 4; // Mandatory
optional uint64 rx_bytes = 5; // Mandatory
optional uint64 tunnel_id = 6; // Mandatory
optional string tunnel_name = 7;
}
message InterfaceStats 
{
optional string device_id = 1; // Mandatory
optional MacAddress macaddr = 2; // Mandatory
optional uint32 timestamp = 3; // Mandatory
optional uint64 tx_bytes = 4; // Mandatory
optional uint64 rx_bytes = 5; // Mandatory
optional uint32 power_consumption = 6;
optional uint64 in_errors = 7;
optional uint64 out_errors = 8;
optional uint64 in_discards = 9;
optional uint64 out_discards = 10;
optional uint64 in_packets = 11;
optional uint64 out_packets = 12;
optional uint32 in_other_err = 13;
optional uint64 in_multicast_pkt = 14;
optional uint64 in_broadcast_pkt = 15;
optional uint64 in_unicast_pkt = 16;
optional uint64 out_multicast_pkt = 17;
optional uint64 out_broadcast_pkt = 18;
optional uint64 out_unicast_pkt = 19;
optional uint64 in_fcs = 20;
optional uint64 in_alignment = 21;
optional uint32 out_excessive_collision = 22;
optional uint64 in_jabbers = 23;
optional uint64 in_fragmented = 24;
optional uint32 in_giant = 25;
optional uint32 in_runt = 26;
optional uint64 out_collision = 27;
optional uint32 out_late_collision = 28;
optional uint32 out_deferred = 29;
}
message RoleStats 
{
 optional string device_id = 1; // Mandatory  
 optional string user_role = 2; // Mandatory  
 optional uint32 timestamp = 3; // Mandatory 
 optional uint64 tx_bytes = 4; // Mandatory  
 optional uint64 rx_bytes = 5; // Mandatory  
}
message VlanStats 
{
 optional string device_id = 1; // Mandatory 
 optional uint32 vlan = 2; // Mandatory  
 optional uint32 timestamp = 3; // Mandatory  
 optional uint64 tx_bytes = 4; // Mandatory  
 optional uint64 rx_bytes = 5; // Mandatory  
}
message SsidStats 
{
 optional string device_id = 1; // Mandatory  
 optional bytes essid = 2; // Mandatory    
 optional uint32 timestamp = 3; // Mandatory 
 optional uint64 tx_bytes = 4; // Mandatory 
 optional uint64 rx_bytes = 5; // Mandatory  
}
message ModemStats 
{
 optional string device_id = 1;                // Mandatory
 optional uint32 timestamp = 2;                // Mandatory
 optional uint64 tx_bytes = 3;                // Mandatory
 optional uint64 rx_bytes = 4;                // Mandatory
}

Parameters Descriptions

The following table lists the field, type, rule, and descriptions of the above mentioned protocol buffer messages

Field

Type

Rule

Description

action

Action

Optional

Indicates the action.

  • ADD
  • UPDATE
  • DELETE

swarm_id

String

Optional

Indicates the virtual controller swarm id.

name

String

Optional

Indicates the device name.

status

Status

Optional

Indicates the status UP or DOWN. Default: UP

public_ip_address

IpAddress

Optional

Indicates the public IP address. It contains the following:

  • af— Indicates the address family and contains the following:
    ADDR_FAMILY_INET— Indicates the IP address version.
  • addr— Indicates the address.

ip_address

IpAddress

Optional

Indicates the device IP address. It contains the following:

  • af— Indicates the address family and contains the following:
    ADDR_FAMILY_INET— Indicates the IP address version.
  • addr— Indicates the address.

firmware_version

String

Optional

Indicates the device firmware version.

crypto_type

CryptoType

Optional

Indicates the crypto certificate type.

peer_name

String

Optional

Indicates the peer name.

peer_tun_ip

IpAddress

Optional

Indicates the peer tunnel IP address. It contains the following:

  • af— Indicates the address family and contains the following:
    ADDR_FAMILY_INET— Indicates the IP address version.
  • addr— Indicates the address.

tunnel_ip

IpAddress

Optional

Indicates the tunnel IP address. It contains the following:

  • af— Indicates the address family and contains the following:
    ADDR_FAMILY_INET— Indicates the IP address version.
  • addr— Indicates the address.

active

Bool

Optional

Indicates the tunnel active status.

uptime

Uint32

Optional

Indicates the tunnel uptime.

tunnel_id

Uint64

Optional

Indicates the tunnel ID.

device_id

String

Optional

Indicates the associated serial number.

macaddr

MacAddress

Optional

Indicates the mac address.

  • addr— Indicates the address.

ipaddr

IpAddress

Optional

Indicates the IP address of the device.

duplex_mode

Duplex

Optional

Indicates the duplex mode. Contains the following:

  • HALF
  • FULL
  • AUTO

port_number

String

Optional

Indicates the port number.

type

IntfType

Optional

Indicates the interface type. Contains any of the following:

  • ETHERNET
  • LOOPBACK
  • VLAN
  • TUNNEL
  • PORT_CHANNEL
  • STANDBY
  • BRIDGE
  • SPLIT
  • STACK
  • MGMT
  • NONE

mode

String

Optional

Indicates the device mode.

vlan

Uint32

Optional

Indicates the assigned VLAN.

poe_state

Status

Optional

Indicates the POE enabled device status, UP or DOWN.

oper_state

Status

Optional

Indicates the operational status.

admin_state

Status

Optional

Indicates the administrative state as UP or DOWN.

speed

SpeedType

Optional

Indicates the speed information. Contains any of the following:

  • INVALID
  • AUTO
  • 10
  • 100
  • 1000
  • 10000

mux

Uint32

Optional

Indicates the mux information.

trusted

Uint32

Optional

Indicates the trusted information.

slot

String

Optional

Indicates the slot information. Usually it's name.

phy_type

PortType

Optional

Indicates the port type. Contains any of the following:

  • RJ45
  • GBIC
  • SERIAL
  • USB
  • X2

sub_type

String

Optional

Indicates the sub type name.

allowed_vlan

Uint32

Repeated

Indicates the list of allowed VLANs.

native_vlan

Uint32

Optional

Indicates the native VLAN ID.

vsx_enabled

Bool

Optional

Indicates the boolean value whether the vsx is enabled or not.

state_down_reason

StateDownReason

Optional

Indicates the state down reason. Contains any one of the following:

  • UNINITIALIZED
  • WAITING_FOR_LINK
  • ADMIN_INTERFACE_DOWN
  • MODULE_MISSING
  • MODULE_UNRECOGNIZED
  • MODULE_UNSUPPORTED
  • MODULE_INCOMPATIBLE
  • MODULE_FAULT
  • GROUP_SPEED_MISMATCH
  • LANES_SPLIT
  • LANES_NOT_SPLIT
  • INVALID_MTU
  • INVALID_SPEEDS
  • AUTONEG_NOT_SUPPORTED
  • AUTONEG_REQUIRED
  • INTERFACE_ABSENT
  • PHYSICAL_INTERFACE_FAILED
  • PSPO_ENABLEMENT_LAYER_DOWN
  • CARD_INTERFACE_ERRORS
  • INTERFACE_OK

vlan_mode

VlanModes

Optional

Indicates the VLAN mode. Contains any of the following:

  • ACCESS
  • NATIVE_TAGGED
  • NATIVE_UNTAGGED

radio_mac

MacAddress

Optional

Indicates the AP Radio mac address.

  • addr— Indicates the address.

essid

Bytes

Optional

Indicates the ESSID.

ap_mac

MacAddress

Optional

Indicates the AP mac address.

  • addr— Indicates the address.

bssid

MacAddress

Optional

Indicates the BSSID.

index

Uint32

Optional

Indicates the AP Radio index.

channel

String

Optional

Indicates the AP channel.

band

Uint32

Optional

Indicates the AP band.

  • 0 for 2.4 Ghz
  • 1 for 5 Ghz
channel_widthUint32OptionalIndicates the AP channel width.
serialStringOptionalIndicates the AP serial number.
cluster_idStringOptionalIndicates the AP cluster ID.
modelStringOptionalIndicates the AP model.
mesh_roleStringOptionalIndicates the AP mesh role.
swarm_masterBoolOptionalIndicates the swarm master status.
modem_connectedBoolOptionalIndicates the modem connected status.
uplink_typeUplinkTypeOptionalIndicates the AP uplink type.
securityStringOptionalIndicates the network security.
typeStringOptionalIndicates the network type.
timestampUint32OptionalIndicates the time of occurrence.
uptimeUint64OptionalIndicates the AP uptime.
cpu_utilizationUint32OptionalIndicates the CPU utilization.
mem_totalUint64OptionalIndicates the total memory.
mem_freeUint64OptionalIndicates the free memory.
power_consumptionUint32OptionalIndicates the power consumption of the device.
fan_speedUint32OptionalIndicates the device fan speed.
temperatureUint32OptionalIndicates the device temperature value.
fan_statusStatusOptionalIndicates the device fan status.
max_powerUint32OptionalIndicates max power of the device.
poe_consumptionUint32OptionalIndicates the device POE consumption.
poe_budgetUint32OptionalIndicates the device POE budget.
mem_utilizationUint64OptionalIndicates the device memory utilization.
tx_bytesUint64OptionalIndicates the number of bytes transmitted.
rx_bytesUint64OptionalIndicates the number of bytes received.
tx_dropsUint32OptionalIndicates the number of transmission drop.
tx_powerUint32OptionalIndicates the Radio Tx power.
noise_floorUint32OptionalIndicates the Radio noise floor.
utilizationUint32OptionalIndicates the Radio utilization.
rx_badUint64OptionalIndicates the Rx error .
networkBytesOptionalIndicates the network ESSID name.
tunnel_nameStringOptionalIndicates the tunnel profile name.
user_roleStringOptionalIndicates the user role.

Examples for IAP Streaming Events within Monitoring Topic

action: UPDATE
swarm_id: "bd200b80010c1214284383336e6de41915ac6c2f789a667bfb"
name: "SetMeUp-C0:20:D4"
status: UP
public_ip_address {
af: ADDR_FAMILY_INET
addr: "\000\000\000\001"
}
ip_address {
af: ADDR_FAMILY_INET
addr: "\000\000\000\000"
}
firmware_version: "8.7.1.0_77203"
action: UPDATE
swarm_id: "b491b01b019aeb978245ecd067490b159bfd52c36aec3e0dd5"
crypto_type: CA_CERT
peer_name: "10.29.10.82"
peer_tun_ip {
af: ADDR_FAMILY_INET
addr: "\000\000\000\000"
}
tunnel_ip {
af: ADDR_FAMILY_INET
addr: "\000\000\000\000"
}
status: DOWN
active: false
uptime: 1601896140
tunnel_id: 1
action: UPDATE
device_id: "DZ0001581"
macaddr {
addr: "\360\\\031\311\367j"
}
status: DOWN
duplex_mode: FULL
name: "eth0"
port_number: "0"
type: BRIDGE
vlan: 1
oper_state: DOWN
admin_state: DOWN
speed: SPEED_1000
allowed_vlan: 1
allowed_vlan: 2

.

.

allowed_vlan: 4094
action: ADD
device_id: "CNDSHN74L6"
radio_mac

{ addr: " \246\315Au\200" }
essid: "000-guest-live"
ap_mac

{ addr: " \246\315\314\027X" }
bssid

{ addr: " \246\315Au\200" }
action: UPDATE
device_id: "CNDGK2R5GX"
index: 1
macaddr {
addr: " \246\315\270\326\200"
}
status: UP
channel: "6"
band: 0
channel_width: 20
ap_mac {
addr: " L\003\036\351\374"
}
action: UPDATE
serial: "CNDSHN74L6"
name: "20:a6:cd:cc:17:58"
macaddr

{ addr: " \246\315\314\027X" }
cluster_id: "31a376e40130e120331994a72e42f46b96379ff8c00065f83c"
status: DOWN
ip_address

{ af: ADDR_FAMILY_INET addr: "\n\035\006\262" }
model: "325"
mesh_role: "Unknown"
mode: "access"
swarm_master: true
modem_connected: false
uplink_type: ETHERNET
firmware_version: "8.7.0.0_75915"
action: DELETE
swarm_id: "b491b01b019aeb978245ecd067490b159bfd52c36aec3e0dd5"
essid: "252-tunnel"
security: "WPA2 Personal"
type: "Employee"
device_id: "DZ0001581"
timestamp: 1601898300
uptime: 364223
cpu_utilization: 7
mem_total: 490090496
mem_free: 234157664
mem_utilization: 52
device_id: "DZ0001581"
macaddr {
addr: "\360\\\031\037v\260"
}
timestamp: 1601899200
tx_bytes: 0
rx_bytes: 0
tx_drops: 0
tx_power: 18
noise_floor: 92
utilization: 1
rx_bad: 160
device_id: "DZ0001581"
radio_mac {
addr: "\360\\\031\037v\240"
}
network: "252-tunnel"
timestamp: 1601899200
tx_bytes: 0
rx_bytes: 0
swarm_id: "b491b01b019aeb978245ecd067490b159bfd52c36aec3e0dd5"
timestamp: 1601899200
tx_bytes: 0
rx_bytes: 0
tunnel_id: 0
tunnel_name: "mythili-tunnel"
device_id: "DZ0001581"
user_role: "wired-SetMeUp"
timestamp: 1601899200
tx_bytes: 48670
rx_bytes: 20072
device_id: "DZ0001581"
vlan: 3333
timestamp: 1601899200
tx_bytes: 48670
rx_bytes: 20072
device_id: "DZ0001581"
essid: "000-sanity"
timestamp: 1601899200
tx_bytes: 0
rx_bytes: 0
device_id: "DZ0001581"
timestamp: 1601899200
tx_bytes: 48670
rx_bytes: 20072