Bindplane

The Bindplane Developer Hub

Welcome to the Bindplane developer hub. You'll find comprehensive guides and documentation to help you start working with Bindplane as quickly as possible, as well as support if you get stuck. Let's jump right in!

Host - In Alpha

Windows & Linux Host - OS Monitoring

This Source is Currently in Alpha

This Source is available as part of our Early Access Program. Let us know how if you are interesting and we can enable your OS Monitoring through the "Host" Source.

Data Collection Setup

Deployment for this Source is different than others for data collection, as the OS metrics are collected locally from the Data Collector.

Least Privileged User

No additional LPU setup is required. Collection is done with the services user that they BindPlane collection processes are run under.

Network Requirements

Collection is local and not additional network access is required.

Supported Versions

*Windows, All Editions, including Core Supported for:
Windows 2008 R2, 2012 R2, 2016, 2019

*Linux:
Centos/RHEL/OEL 6.x & 7.x
SLES 15
Ubunu 14/16/18
Debian 9

Connection Parameters

Name
Required?
Description

Collect Disks

Configure Monitoring of Disks, See metrics for more details

Collect Disk Partitions

Configure Monitoring of Disk Partitions, See metrics for more details

Collect File System

Configure Monitoring o File Systems, See metrics for more details

Collect File Stores

Configure Monitoring of File Stores, See metrics for more details

Collect Processes

Configure Monitoring of Processes, See metrics for more details

Collect Power Sources

Configure Monitoring of Power Sources, See metrics for more details

Maximum Process Count

The maximum number of processes to collect. Specify a value of '0' to collect all.

Order Processes By

Process Filter

A Java Regex. Only processes whose command line matches this regex will be returned.

Metrics

CPU

Name
Description

Context Switches

The number of context switches which have occurred.

Family

The family of the CPU.

Hostname

The hostname of the system.

ID

The Processor ID. This is a hexidecimal string representing an 8-byte value, normally obtained using the CPUID opcode with the EAX register set to 1. The first four bytes are the resulting contents of the EAX register, which is the Processor signature.

Identifier

Identifier, eg. x86 Family 6 Model 15 Stepping 10.

Idle Utilization (%)

Time that the CPU or CPUs were idle and the system did not have an outstanding disk I/O request.

Interrupts

The number of interrupts which have occurred.

I/O Wait Utilization (%)

Time that the CPU or CPUs were idle during which the system had an outstanding disk I/O request.

IRQ Utilization (%)

Time that the CPU used to service hardware IRQs.

Is 64 Bit?

True if CPU is 64 Bit, else false.

Logical Processors

The number of logical CPUs available for processing.

Model

The model of the CPU.

Name

Name of the CPU, eg. Intel(R) Core(TM)2 Duo CPU T7300 @ 2.00GHz.

Nice Utilization (%)

CPU utilization that occurred while executing at the user level with nice priority.

Physical Packages

The number of packages/sockets in the system.

Physical Processors

The number of physical CPUs/cores available for processing.

Software IRQ Utilization (%)

Time that the CPU used to service soft IRQs.

Steal Utilization (%)

Time which the hypervisor dedicated for other guests in the system. Only supported on Linux.

Stepping

The stepping of the CPU that is installed.

System Load (%)

The recent cpu usage for the whole system; negative if unavailable.

System Load Average (Last 15 Minutes)

Sum of the queued and running entities over the last 15 minutes; negative if unavailable.

System Load Average (Last 5 Minutes)

Sum of the queued and running entities over the last 5 minutes; negative if unavailable.

System Load Average (Last Minute)

Sum of the queued and running entities over the last minute; negative if unavailable.

System Load Between Ticks (%)

The recent cpu usage for the whole system by polling every second.

System Up-time (Seconds)

Amount of time since last boot.

System Utilization (%)

CPU utilization that occurred while executing at the system level (kernel).

Temperature (Celsius)

CPU Temperature if available, 0 otherwise.

User Utilization (%)

CPU utilization that occurred while executing at the user level.

Utilization (%)

Aggregate of CPU utilization that was not spent idle.

Vendor

The vendor of the CPU.

Vendor Frequency (Hertz)

Frequency or -1 if unknown.

Voltage (Volts)

CPU Voltage if available, 0 otherwise.

Disk

Name
Description

Hostname

The hostname of the system.

Model

The manufacturer's model name and number.

Name

The name of the disk.

Read Size (Bytes)

Size of reads from disk.

Reads (Reads)

Number of reads from disk.

Serial

The serial number of the disk.

Size (Bytes)

The total size of the disk.

Transfer Time (Milliseconds)

The time spent reading or writing.

Write Size (Bytes)

Size of writes to disk.

Writes (Writes)

Number of writes to disk.

Disk Partition

Name
Description

Hostname

The hostname of the system.

Identifier

The unique partition id.

Major ID

Device ID (Major).

Minor ID

Device ID (Minor).

Mount Point

The location where the partition is mounted.

Name

The name of the partition.

Size (Bytes)

Total size of the partition.

Type

Type of description of the partition.

UUID

UUID of the partition.

File Store

Name
Description

Description

A description of the file store.

Free Space (Bytes)

The amount of usable space of the file store.

Hostname

The hostname of the system.

Logical Volume

The logical volume of the file store.

Mount Point

The mountpoint of the file store.

Name

The name of the file store.

Total Space (Bytes)

Total size of the file store.

Type

The partition type of the file store (FAT, NTFS, ext2, ext4, etc.).

Utilization (%)

The amount of usable space that the file store is utilizing.

UUID

UUID or GUID of the file store.

Volume

Partition where this file store is located.

File System

Name
Description

Hostname

The hostname of the system.

Maximum File Descriptors

The maximum number of open file descriptors.

Open File Descriptor Utilization (%)

The current utilization of open file descriptors.

Open File Descriptors

The current number of open file descriptors.

Host

Name
Description

Bitness

The bitness of the operating system (either 32 or 64 bit).

DNS Servers

The DNS servers that are set.

Domain

The domain that the system belongs to.

Family

The family of the operating system.

IPv4 Default Gateway

The default gateway(routing destination for 0.0.0.0/0) for IPv4, empty string if not defined.

IPv6 Default Gateway

The default gateway(routing destination for ::/0) for IPv6, empty string if not defined.

Manufacturer

The manufacturer of the operating system.

Name

The hostname of the system.

Processes (Processes)

The number of processes currently running.

Thread Count (Threads)

The number of threads currently running.

Version

The version of the operating system.

Memory

Name
Description

Available (Bytes)

The amount of physical memory currently available.

Hostname

The hostname of the system.

Page Size (Bytes)

Size of a page.

Swap Pages In (Pages)

Number of pages read from paging/swap file(s).

Swap Pages Out (Pages)

Number of pages written to paging/swap file(s).

Swap Used (Bytes)

The current memory committed to the paging/swap file(s).

Swap Utilization (%)

The current utilization of swap memory.

Total (Bytes)

The amount of actual physical memory.

Total Swap (Bytes)

The current size of the paging/swap file(s).

Used (Bytes)

The amount of physical memory currently in use.

Utilization (%)

The current utilization of memory.

Network Interface

Name
Description

Display Name

Description of the network interface. On some platforms, may be the same as name.

Hostname

The hostname of the system.

Inbound Errors (Errors)

Number of inbound errors.

Inbound Packets (Packets)

Number of packets received.

Inbound Throughput (Bytes)

The total amount of data received using this network interface.

IPv4 Addresses

The IPv4 addresses assigned to the network interface.

IPv6 Addresses

The IPv6 addresses assigned to the network interface.

MAC Address

The MAC address of the network interface.

MTU (Bytes)

The MTU that is configured for the network interface.

Name

The name of the network interface according to the operating system.

Outbound Errors (Errors)

Number of outbound errors.

Outbound Packets (Packets)

Number of packets Sent.

Outbound Throughput (Bytes)

The total amount of data sent using this network interface.

Speed (Bits per Second)

The maximum speed of the network interface.

Process

Name
Description

Command Line

The process' command line text. The format of this string is platform-dependent.

Current Working Directory

The process' current working directory.

Data Read (Bytes)

The amount of data the process has read from disk.

Data Written (Bytes)

The amount of data the process has written to disk.

Group

The group of the process. On Windows systems, populating this value for processes other than the current user requires administrative privileges (and still may fail for some system processes).

Group ID

The group ID of the process. On Windows systems, populating this value for processes other than the current user requires administrative privileges (and still may fail for some system processes).

Hostname

The hostname of the system.

ID

The ID of the process given by the operating system.

Kernel Time (Milliseconds)

The amount of time the process has executed in kernel/system mode.

Name

The name of the process.

Open Files

The number of open file handles (or network connections) that belongs to the process. -1 if unknown or not supported.

Parent Process ID

The parent process' ID, if any.

Path

The full filepath of the executing process.

Priority

The priority of the process. For Linux and Unix, priority is a value in the range -20 to 19 (20 on some systems). The default priority is 0; lower priorities cause more favorable scheduling. For Windows, priority values can range from 0 (lowest priority) to 31 (highest priority). Mac OS X has 128 priority levels, ranging from 0 (lowest priority) to 127 (highest priority). They are divided into several major bands: 0 through 51 are the normal levels; the default priority is 31. 52 through 79 are the highest priority regular threads; 80 through 95 are for kernel mode threads; and 96 through 127 correspond to real-time threads, which are treated differently than other threads by the scheduler.

Resident Set Size (Bytes)

The Resident Set Size (RSS). On Windows, returns the private working set size. It is used to show how much memory is allocated to that process and is in RAM. It does not include memory that is swapped out. It does include memory from shared libraries as long as the pages from those libraries are actually in memory. It does include all stack and heap memory.

Start Time (Milliseconds)

The time at which the process started since the epoch.

State

The execution state of the process. Either NEW, RUNNING, SLEEPING, WAITING, ZOMBIE, STOPPED, or OTHER (unknown).

Thread Count

The number of threads in this process.

Up Time (Milliseconds)

The amount of time since the process has started.

User

The user name that owns the process. On Windows systems, also returns the domain prepended to the username.

User ID

The userID. On Windows systems, returns the Security ID (SID).

User Time (Milliseconds)

The amount of time the process has executed in user mode.

Virtual Size (Bytes)

The Virtual Memory Size (VSZ). It includes all memory that the process can access, including memory that is swapped out and memory that is from shared libraries.

Host - In Alpha


Windows & Linux Host - OS Monitoring

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.