mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
6575042f5f
* clean up all but header incrementing in Creating-Transport.md * make Device-Dependencies.md mdl happy * make Entities.md as mdl happy as possible... one long table line left * make mdl as happy as possible for index.md * clean up Introduction.md as much as possible * minor formatting cleanup... move each icon onto its own row * make ack and notes the same style * clean Macros.md up * clean Rules.md up as much as possible * tweak one line a bit to get it to format a bit nicer * a bit more format tweaking, making sure it does not sure with > * clean up as much as possible for Templates.md * make Testing.md as mdl happy as possibly * clean Transports.md up as much as possible * clean as many issues as possible for Alerts.md * clean up as much of ARP.md as possible * clean up as much as possible for Bills.md * make DeviceGroups.md as mdl happy as possible * cleanup Devices.md * make as mdl happy as possible Inventory.md and index.md * mdl cleanup for Logs.md and PortGroups.md * make Ports.md and Routing.md as happy as possible * clean up Services.md, Switching.md, and Systems.md as much as possible * more markup cleanup * lots more md cleanup udner Devloping/ * reapply bits from #10343 that accidentally got removed when merging
93 lines
3.1 KiB
Markdown
93 lines
3.1 KiB
Markdown
source: Alerting/Entities.md
|
|
path: blob/master/doc/
|
|
|
|
# Entities
|
|
|
|
Entities as described earlier are based on the table and column names
|
|
within the database, if you are unsure of what the entity is you want
|
|
then have a browse around inside MySQL using `show tables` and `desc <tablename>`.
|
|
|
|
Below are some common entities that you can use within the alerting
|
|
system. This list is not exhaustive and you should look at the MySQL
|
|
database schema for the full list.
|
|
|
|
## Devices
|
|
|
|
Entity | Description
|
|
---|---
|
|
`devices.hostname` | The device hostname
|
|
`devices.sysName` | The device sysName
|
|
`devices.sysDescr` | The device sysDescr
|
|
`devices.hardware` | The device hardware
|
|
`devices.version` | The device os version
|
|
`devices.location` | The device location
|
|
`devices.status` | The status of the device, 1 | up, 0 | down
|
|
`devices.status_reason` | The reason the device was detected as down (icmp or snmp)
|
|
`devices.ignore` | If the device is ignored this will be set to 1
|
|
`devices.disabled` | If the device is disabled this will be set to 1
|
|
`devices.last_polled` | The the last polled datetime (yyyy-mm-dd hh:mm:ss)
|
|
`devices.type` | The device type such as network, server, firewall, etc.
|
|
|
|
## BGP Peers
|
|
|
|
Entity | Description
|
|
---|---
|
|
`bgpPeers.astext` | This is the description of the BGP Peer
|
|
`bgpPeers.bgpPeerIdentifier` | The IP address of the BGP Peer
|
|
`bgpPeers.bgpPeerRemoteAs` | The AS number of the BGP Peer
|
|
`bgpPeers.bgpPeerState` | The operational state of the BGP session
|
|
`bgpPeers.bgpPeerAdminStatus` | The administrative state of the BGP session
|
|
`bgpPeers.bgpLocalAddr` | The local address of the BGP session.
|
|
|
|
## IPSec Tunnels
|
|
|
|
Entity | Description
|
|
---|---
|
|
`ipsec_tunnels.peer_addr` | The remote VPN peer address
|
|
`ipsec_tunnels.local_addr` | The local VPN address
|
|
`ipsec_tunnels.tunnel_status` | The VPN tunnels operational status.
|
|
|
|
## Memory pools
|
|
|
|
Entity | Description
|
|
---|---
|
|
`mempools.mempool_type` | The memory pool type such as hrstorage, cmp and cemp
|
|
`mempools.mempool_descr` | The description of the pool such as Physical memory, Virtual memory and System memory
|
|
`mempools.mempool_perc` | The used percentage of the memory pool.
|
|
|
|
## Ports
|
|
|
|
Entity | Description
|
|
---|---
|
|
`ports.ifDescr` | The interface description
|
|
`ports.ifName` | The interface name
|
|
`ports.ifSpeed` | The port speed in bps
|
|
`ports.ifHighSpeed` | The port speed in mbps
|
|
`ports.ifOperStatus` | The operational status of the port (up or down)
|
|
`ports.ifAdminStatus` | The administrative status of the port (up or down)
|
|
`ports.ifDuplex` | Duplex setting of the port
|
|
`ports.ifMtu` | The MTU setting of the port.`
|
|
|
|
## Processors
|
|
|
|
Entity | Description
|
|
---|---
|
|
`processors.processor_usage` | The usage of the processor as a percentage
|
|
`processors.processor_descr` | The description of the processor.
|
|
|
|
## Storage
|
|
|
|
Entity | Description
|
|
---|---
|
|
`storage.storage_descr` | The description of the storage
|
|
`storage.storage_perc` | The usage of the storage as a percentage.
|
|
|
|
## Health / Sensors
|
|
|
|
Entity | Description
|
|
---|---
|
|
`sensors.sensor_desc` | The sensors description.
|
|
`sensors.sensor_current` | The current sensors value.
|
|
`sensors.sensor_prev` | The previous sensor value.
|
|
`sensors.lastupdate` | The sensors last updated datetime stamp.
|