Legacy Documentation for Statseeker API v2.1 r12

Index

Examples and Sample Code

Data Dictionary

Version

This guide is specific to the latest version of the Statseeker RESTful API, version 2.1 r12, which was made available with Statseeker version 5.5.4.

[top]

Overview

The Statseeker API (Application Programming Interface) provides access to view and edit Statseeker configuration settings, as well to retrieve and manipulate timeseries data via an interface other than that provided by the Statseeker’s web GUI (Graphical User Interface). Most of the processes and objects that you are used to interacting with in Statseeker (network discovery, users, groups, devices, interfaces, device events, thresholds, reporting data, etc.) are exposed as resources from the API.

The API adheres to basic RESTful API principles:

  • Implementing resource-oriented URLs
  • Uses HTTP response codes to indicate API errors
  • Uses HTTP authentication
  • Accepts HTTP verbs (GET, PUT, POST, and DELETE)

[top]

Code Samples

Code samples have been provided throughout this guide in a range of languages. Regardless of your implementation, in the end your request is submitted to the Statseeker API via an HTTP request, and consequently, in many instances some method of character encoding will be required. While some implementations will incorporate libraries that will handle any required encoding, others may not. In response, we have provided sample code demonstrating the use of both Unicode and URL (percent) encoding throughout this guide, so you may need to modify this aspect of the samples to suit the requirements specific to your environment.

The simplest implementation is using cURL to query the API. This allows you to begin investigating the Statseeker API with little to no requisite environmental configuration. All cURL examples provided in this guide are suited to use on a Unix based cURL implementation, which allows the use of both single quotes () and double quotes() for nested data objects. A Windows-based cURL implementation may not allow the use of single quotes, in this instance use double quotes and escape any inner pairs with backslash (\).

Example:
UnixWindows

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <MY_TOKEN>" \
    -X POST \
    "https://your.statseeker.server/api/v2.1/group/?indent=3" \
    -d '{"data":[{"name":"Group1"}]}' 

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <MY_TOKEN>" \
    -X POST \
    "https://your.statseeker.server/api/v2.1/group/?indent=3" \
    -d "{\"data\":[{\"name\":\"Group1\"}]}" 

Many instances of code samples in this document use nested quotes and, depending on your development environment, you may need to encode inner quote pairs so that they are interpreted correctly. In some examples we have URL encoded inner single-quotes and they are presented as %27. In other examples we have used the Unicode \u0027 for the same purpose. Presenting the samples in this way simply serves to highlight that there may be specific encoding requirements depending on your environment.

[top]

Request Headers

All requests should include the following HTTP headers:

Header Mandatory Value Notes
Accept no application/json This specifies the media type accepted in the response
Content-Type no application/json This specifies the media type of the content being sent to the API
Authorization yes Basic [base-64 encoded username:password] The Basic keyword indicates the authentication method being used and the base-64 encoded username:password pair provides the credentials needed to access the API. See Authentication for further details.
Bearer {authentication_token} The authentication token returned from a POST request to the Statseeker authentication end-point (/ss-auth)

[top]

Authentication

*** WARNING : Authentication requirements have changed with Statseeker v5.5.4 (API v2.1 r12) ***

  • v5.5.4 introduced token-based authentication, see User Authentication for details
  • New Installations: default to token-based authentication
  • Updated Servers: default to basic access authentication – this authentication method has been deprecated and will be removed in a future release

Statseeker v5.5.3 and earlier servers will only accept basic authentication.


Statseeker uses token-based authentication for user access to the server, by default, this includes API access. The Statseeker server has a resource which handles authentication requests, successful authentication returns an access token and this token must then be included with any subsequent API request. The API can also be set to use Basic Access Authentication instead of token authentication. This setting only applies to authentication with the API and does not impact user authentication via the web interface (GUI).

[top]

Set the API Authentication Method

To specify the API authentication method used:

  • Select Admin Tool > Statseeker Administration > Web Server Configuration
  • Click Edit (top-right)
  • Set RESTful API Authentication Mode as needed and click Save

See Web Server Configuration for more information.

[top]

Token-Based Authentication
  • The Statseeker server has a resource, located at https://your.statseeker.server/ss-auth, which handles authentication requests
  • To authenticate you must submit a POST request to the authentication endpoint, containing the username and password in the body of the request
  • Successful authentication will return an access token and this token must then be included with any subsequent request

The following sample code demonstrates this process:

cURLPython (requests)Ruby (rest-client)
Initial request to authenticate the user and return the authentication token.


curl \
	-X POST \
	-H "Content-type: application/x-www-form-urlencoded" \
	-d "user=user_name&password=user_password" \
	"https://your.statseeker.server/ss-auth"


Subsequent request to access the API.
Replace <MY_TOKEN> with the authentication token in the response to your previous POST. This token can be reused until it expires, once expired you will need to request a new token. For details on token expiry settings, see Authentication Token Settings.


curl \ 
	-X GET \
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	"https://your.statseeker.server/api/v2.1"


# import requests for handling connection and encoding
import requests
import json

def do_request(server, query, user, pword):

    # request auth token
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
	
	# If auth was successful, include my token and make my API request
    if resp.status_code == 200:        
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'your_api_user'
pword = 'your_user_password'
# API root endpoint
query = 'api/v2.1'
# optional response formatting
query += '/?indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)

# output the response to my API request
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
   
        # Include my token and make my API request
        headers["content_type"] = :json
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
end
# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'your_api_user'
pword = 'your_user_password'
# api root endpoint
$query = 'api/v2.1'
# optional formatting of the response
$query += '/?links=none&indent=3'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"
[top]

Example: Token-based Auth with a fall back to Basic Auth

In this example we attempt token authentication and if this process fails, we fallback to basic authentication.

PythonRuby


# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful. Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or
        # API set to use basic auth.
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# optional response formatting
query += '/?indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers["content_type"] = :json
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# optional formatting of the response
$query += '/?links=none&indent=3'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"
[top]

Basic Authentication (Deprecated – only available on servers that have been upgraded from earlier versions)

The Statseeker API uses the same HTTP Basic Access (BA) authentication used by the Statseeker web interface (i.e.username:password).

This basic authentication must be included in the HTTP Authorization header for every request sent to the API, see below for examples of supplying this authorization.

cURLPython (requests)Ruby (rest-client)

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1"

 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'

# api root endpoint
$uri = 'https:/your.statseeker.server/api/v2.1/'

# api user credentials
$user = 'username'
$pword = 'password'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# send request
response = RestClient::Request.new({
      method: :get,
      url: $uri + $rspFormat,
      user: $user,
      password: $pword,
    }).execute
	
# output response to screen
puts "#{response.to_str}"
[top]

Manage API User’s access to Data

API access also requires that the user account initiating the communication has been assigned permission to interact with the API. The default admin user account (created during the Statseeker installation process) is configured with API read/write access by default and, when creating additional Statseeker users API access can be assigned:

  • Via the web interface, by setting the API Access field, see User Accounts for details
  • Via the API, by setting api_access = rw, for read-write access (alternatively, r, or w, for read-only and write-only respectively)

Independent of a user accounts’ ability to access the API is the user accounts’ data access permissions. These permissions can be used to restrict the user from viewing data from specific elements of your network infrastructure. These permissions are managed through user-group associations that will have been configured when the user account was created. If you are not familiar with this process, see Users & Grouping.

You may want to consider creating a dedicated API user account:

  • Assign the account API read/write access
  • To enable access to all data, assign the account ‘All Groups’ permission (see Users & Grouping for details)
  • Reference this account in all API scripts

[top]

Response Codes

Statseeker uses RESTful HTTP response codes to indicate success or failure of API requests

Code Message Notes
200 Success Successful API request

Note: when referencing deprecated objects/endpoints the response will return a Status: 200 OK, but the response header will contain a Warning 299 – Deprecated API. In this instance, refer to the Resource Reference for the resource being requested.
400 Bad Request Malformed request, check request syntax and supplied parameters
401 Unauthorized Authorization error, check the supplied username and password
404 Not Found The specified endpoint cannot be located
500 Server Error Something has gone wrong on Statseeker’s end


Note: if the request is correctly formed but the specified resource does not exist, then the API will return a 200 response but the data object will be an empty array.

Example Request:
We are requesting a user with an ID of not_a_valid_user_id.

https://your.statseeker.server/api/v2.1/user/not_a_valid_user_id/?links=none

Example Response:
The response will return a data object containing all the data retrieved for the specified user, in this case an empty array and the corresponding data_total is 0.


{
    "version": "2.1",
    "revision": "9",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1575850381,
        "objects": [
            {
                "type": "user",
                "sequence": 0,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 0,
                "data": []
            }
        ]
    }
}

[top]

Limits on Size of Response Object

The API has configurable limits on the size of the data being returned from any single API query. The default value of these limits are:

  • Event based data (syslog, threshold events) is limited to 1 million rows per request
  • Timeseries data is limited to 1GB of data returned per request

These default values are intentionally set very high, and should not impact typical use of the API. They will however prevent a single API query from consuming enough system resources to severely impact the performance of your Statseeker server. The limit values can be modified to suit your Statseeker server resources, please contact Statseeker Technical Support for assistance.

[top]

Pagination

The API automatically paginates the response when large data sets are returned. By default, the API will return 50 results per response.

The number of results returned in a single response can be modified from the default value of 50 by setting the limit parameter on the request.

The following example HTTP request will return 200 results per response
https://your.statseeker.server/api/v2.1/cdt_port/?&limit=200

When moving through paginated data with the pagination links (Next, Previous, etc) the request URL is altered to append an offset request parameter. Following on from the example above, with limit=200 and setting offset=100, the request will return the 101st to 300th result:

https://your.statseeker.server/api/v2.1/cdt_port/?&limit=200&offset=100

[top]

API Endpoints

The API allows you to add, retrieve and modify data relating to a large number of data-object/resource types. These resources are related to either the network hardware that your Statseeker server is monitoring, or various configuration settings (user accounts, thresholds and alerts, automated processes, network configuration details, etc.) applied to your Statseeker server.

Most API’s feature a static selection of object-focused endpoints, which are available to everyone. The Statseeker API is a little different, while many resources are available through the default installation, some are available as modular Custom Data Type (CDT) packages which can be added and removed as needed. This feature, combined with the fact that Statseeker doesn’t force users to upgrade their installation, means that the resource-level endpoints available on one Statseeker deployment may be quite different to those available on another.

Note:

The remainder of this section provides a basic overview of the types of endpoints available through the API, and the types of requests that can be made against those endpoint types. These endpoint types, and their available actions, are universal across deployments, but the data objects available at the resource level may differ between Statseeker installations.

Endpoint URL Description
Statseeker Endpoints
Authentication /ss-auth

https://your.statseeker.server/ss-auth

The authentication endpoint authenticates users and generates authentication tokens
API Endpoints
API Root /api/{api_version}/

https://your.statseeker.server/api/v2.1/

The root endpoint for the API
Resource /api/{api_version}/{resource}

https://your.statseeker.server/api/v2.1/user

The resource endpoint, for running get, add, update, and delete queries on specific resources. This is the endpoint type used to retrieve your timeseries and configuration data from your Statseeker server, see:

  • Resource Endpoint for details on the parameters that can be passed when interacting with resource level endpoints
  • Resource Reference for details on the various resource level endpoints including fields, methods and requirements
Describe /api/{api_version}/{resource}/describe

https://your.statseeker.server/api/v2.1/user/describe

The describe endpoint, for running describe queries on specific resources
Execute /api/{api_version}/{resource}/execute

https://your.statseeker.server/api/v2.1/discover/execute

The execute endpoint, for running execute queries on specific resources
ID /api/{api_version}/{resource}/{id}

https://your.statseeker.server/api/v2.1/user/1234

The ID endpoint, for running get, update, and delete queries on a specific entry within a resource
Field /api/{api_version}/{resource}/{id}/{field}

https://your.statseeker.server/api/v2.1/user/1234/name

The field endpoint, for running update queries on a field of a specific entry within a resource

[top]

Authentication Endpoint (/ss-auth))

This endpoint is used to authenticate users and generate authentication tokens for use in API requests. For details on this endpoint and examples of authenticating users see Authentication.

[top]

Root Endpoint (/api/v2.1)

The base (root) endpoint for the API is:

  • https://your.statseeker.server/api/[api_version]

, where:

  • https://your.statseeker.server is the URL of your Statseeker server
  • [api_version] is one the accepted version references, see below
Version References Message
v1 Version 1 of the API, this is a legacy, read-only api, and is not covered in this document
v2, v2.0 Version 2 of the API, the initial implementation of the Statseeker RESTful Read-Write API
v2.1 Version 2.1 of the API, added access to all timeseries data (device\interface metrics) collected by Statseeker
latest Currently, Version 2.1 of the API

[top]

Versioning

The base endpoint of /api/latest will return the latest version of the API installed on your Statseeker server. This version is identified in every response from the API in the version key.

Example Response:


{
    "info": "The Statseeker RESTful API",
    "version": "2.1",
    "data": {response_data},
    "revision": "10"
}

You can access an API version, other than the latest, by altering your base URL to specify the version you want to use.

E.g./api/v1 will return API v1, or /api/v2 will return API v2.0.

There may be multiple revisions released for a given API version, these revisions address issues relating to bugs within the API itself, and issues relating to Custom Data Type (CDT) packages that the API can interact with.

For more information on the relationship between the API and CDT packages, see API Endpoints.

[top]

GET

A GET request to the root endpoint will return all resource types available to your Statseeker installation.

The parameters that may be passed when sending a GET request.

Parameters Type/Valid Values Description
links
  • only – only return the links object, no data object
  • none – only return the data object, no links object
  • html – return html links. If the response is being displayed in a browser then the links may be clicked to send a GET request for the associated object/field.
  • htmlonly – only return html links, no data object
Modifies how the links contained within the response object are presented
indent positive integer Number of characters to indent when formatting code blocks for display

[top]

Resource Endpoint (/api/v2.1/{resource})

The resource level endpoints are where you will spend the vast majority if your time when interacting with the Statseeker API. In order to retrieve reporting data on your network infrastructure you will be routinely sending GET requests to resource level endpoints. These requests will contain:

  • The resource level endpoint to specify what type of data objects you are reporting on (device, interface, CPU, memory, etc.)
  • filters to specify which of these data objects to return
  • fields and formats parameters to specify what data is to be returned (average outbound traffic, maximum aggregated CPU load, etc.)
  • timefilters to specify the reporting period

The Statseeker RESTful API contains many resources allowing you to access and interact with both the data that Statseeker has collected on your network, and the configuration options used by Statseeker to collect and manage that data. Some of the object types available at the resource level endpoint include:

  • Users (/api/v2.1/user)
  • Groups (/api/v2.1/group)
  • Devices (/api/v2.1/cdt_device)
  • Interfaces (/api/v2.1/cdt_port)

As of Statseeker v5.5.4, the API contained over 240 resource level endpoints, all aspects of these endpoints are detailed in the Resource Reference. This list can be expanded upon by adding CDT packages and modules for new device types. For a complete list of all resources available, from *your* Statseeker installation:

  • Send a GET request to the root endpoint
  • Refer to the Resource Reference for details on each of those resources

[top]

Get

Send a GET request to a resource endpoint to return details on instances of the specified resource.

The parameters that may be passed when sending a GET request.

Parameters Type/Valid Values Description
fields A comma separated list of field names
E.g.fields=id,name,location
The list of fields that will be returned in the response. This parameter will be ignored if fields_adv is also specified.
fields_adv A JSON string detailing the fields to be returned
E.g.fields_adv={“Device Name”:{“field”:”name”}, “IP”:{“field”:”ipaddress”},”Location”:{“field”:”sysLocation”},”SNMP Polling”:{“field”:”snmp_poll”,”filter”:{“query”:”=%27off%27″}}}
The list of fields that will be returned in the response
filter An SQL filter string
E.g.“SNMP Polling”:{“field”:”snmp_poll”,”filter”:{“query”:”=%27off%27″}}
A filter to be applied to the response data inside of fields_adv
groups A comma separated list of group names or group IDs A list of groups to be used to filter the response data, only data associated with members of the specified groups will be returned
grouping_mode
  • AND
  • OR
The mode to use when processing multiple group parameters
group_by A comma separated array of fields names, or a formula that will be applied to field values

  • Each field name must be enclosed in braces {}
  • The data format must be specified for every timeseries or event field

Example Arrays:

  • group_by={cdt_device.name},{ifSpeed}
  • group_by={cdt_device.name},{ifSpeed},{RxUtil}&RxUtil_aggregation_format=max

Example Formula:

group_by={TxUtil:avg}+{RxUtil:max}

Use when you want to aggregate data across multiple entities, such as total traffic across multiple interfaces.

Requires that:

  • Field names be enclosed in braces {}
  • The fields to be grouped by are specified in the fields parameter of the request
  • The field format be provided for any timeseries/event fields specified in the group_by parameter
    • When using an array, the {field}_aggregation_format parameter is used to specify the format to be applied
    • When using a formula, the format is appended to the field name and the field name and format are separated by a colon :
interval positive integer
E.g.interval=300
The polling interval to be applied to all timeseries metrics specified in the fields parameter. When not specified, the default polling interval of 60 seconds is used.
limit positive integer
E.g.limit=100
The number of items to return per ‘page’ of the response, see Pagination for details. The API will automatically paginate response data with a default limit=50.
offset positive integer
E.g.offset=100
The number of result items to skip, see Pagination for details. The API will automatically paginate response data with a default offset={limit}.
sortmode string

  • novals_after – null values are always sorted after valid values, only valid values are affected by the {field}_sort parameter
  • novals_before – null values are always sorted before valid values, only valid values are affected by the {field}_sort parameter
  • novals_large – null values are counted as larger than any other value and will be sorted to the end of results if the field is sorted ascending, and sorted to the start if sorted descending
  • novals_small – null values are counted as smaller than any other value and will be sorted to the start of results if a field is sorted ascending, and sorted to end if sorted descending
Specify how the response should handle null values.
Default =novals_small, this setting is used in all instances where sortmode is not set.

timefmt string
The syntax for specifying the time format matches that used by STRFTIME.

E.g. timefmt=%A %H:%M:%S (%y-%m-%d)
will return a timestamp in the format
Wednesday 15:44:48 (19-07-17)
The format in which to return timestamps when value_time is set
value_time One of:

  • start – The timestamp at which the event began
  • mid – the midpoint of the start and end timestamps
  • end – the timestamp at which the event finished
  • all – an array of start, mid and end
  • none – do not return a timestamp

E.g.value_time=all

Optionally return a timestamp for returned timeseries data points. Timestamps are return in epoch time unless timefmt is also specified.


When the fields parameter has been specified, the following additional parameters may be used.

Parameters Type/Valid Values Description
{field}_field string A user defined variable name followed by a valid field name for the resource.

E.g.yesterday_RxUtil

See Named Fields for more information and examples.
{field}_formats Comma separated list, see Timeseries Data: Stats, Formats & Options The formats to request from the API for the given field, required for timeseries data fields

Note: a global formats key (formats=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_formula string Specify and SQL-style formula to be used to populate the field, see Field Formulas for details.

Syntax for referencing other fields within the formula:

  • Configuration field: {field}, e.g. {ping_poll}
  • Timeseries/Event fields must also define a data format: {field:format}, e.g. {ping_rtt:current}
{field}_filter string The filter to apply to the given field. These filters can be either SQL-style filters or extended RegEx filters, for details and examples of applying filters see:

{field}_filter_format string The format to use for the filter, required for timeseries data fields
{field}_interval integer The polling interval (in seconds) to use for the specified field. When used, a field-specific timefilter for the specified field must also also be used.

Note: when not specified, the default interval of 60 seconds is used. A global interval key (interval=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_timefilter string The timefilter to use for the given field, required for timeseries data fields.

Note: a global timefilter key (timefilter=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_tz string An alternate timezone to use for the {field}_timefilter.

All timefilters use the Statseeker server’s timezone unless an override is specified by supplying {field}_tz.

Note: a global timezone key (tz=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_sort Comma separated list List specifying the sort hierarchy and direction, in the following format:{field}_sort={rank}{direction} and for Timeseries data:{field}_sort={rank}{direction}{format}
E.g.name_sort=1,asc
RxUtil_sort=1,desc,avg
{field}_stats Comma separated list, see Timeseries Data: Stats, Formats & Options The stats to use for the given field
{field}_aggregation_format One of:

Format Description
95th The 95th percentile of the values
avg The average of the values
cat Concatenation of the values. Not supported for non-scalar formats such as vals
count The number of rows that match, and have a non-null value
count_all The number of rows that match, including NULL values
first The first matching value
last The last matching value
list Concatenate values as per the cat format, but return the output as comma separated list of values
max The maximum value
median The median value
min The minimum value
stddev The standard deviation value
sum The sum of all values
total Similar to sum, but returns 0 instead of NULL if there are only NULL values in the data being aggregated
The aggregation format to use for the specified field

Note: using aggregation, the following rules apply:

  • When the aggregated data is a number – ignore all null values and return the aggregated value required based on non-null values only
  • When the aggregated data is NOT a number – attempt to convert all values to a number prior to aggregation. Any instance of null will result in the aggregated value being returned as null.

[top]



Linked Resources

There are two types of resource links available:

  • standard links – default links defined by Statseeker
  • custom links – user-defined links

Standard Links

Most resources are linked to at least one other resource in a parent-child relationship. You can use this linking to access any of the parent-resource fields from the child resource (e.g. a query to the interface object {cdt_port} can access any of the fields contained in the device resource {cdt_device} for the device that the interface resides on) This linking is one-way, from child to parent/ancestor. The format for specifying a field from a linked resource is:

{linked_resource_name}.{field}
E.g.cdt_device.name

To see which parent-resources can be linked to from a given resource, run a GET command against the describe endpoint (api/v2.1/{resource}/describe) for that resource and review content of objects.links.

Example:

api/v2.1/cdt_cpu/describe, will return something like:


{
    "version": "2.1",
    "revision": "10",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1596514086,
        "objects": [
            {
                "type": "cdt_cpu",
                "title": "CPU",
                "description": "The custom data entities for the cpu table",
                "fields": {...},
                "commands": {...},
                "info": {...},
                "allow_formula_fields": true,
                "links": {
                    "deviceLink": {
                        "title": "Link to Device",
                        "object": "cdt_device",
                        "default": 1
                    }
                },
                "global_field_options": {...}
            }
        ]
    },
    "links": [...]
}

We can see, in the response object above, that objects.links specifies a link (deviceLink) to the device resource cdt_device.

Example:

You can request data about interfaces showing a high rate of discarded packets from the cdt_port resource, and in the same call request ping-related data from the cdt_device resource of the parent device for each port.

api/v2.1/cdt_port/?fields=name,InOutDiscards,RxDiscardsPercent,TxDiscardsPercent,InOutOctets,cdt_device.name,cdt_device.ping_rtt&formats=avg&InOutDiscards_formats=total,avg&InOutOctets_formats=total&timefilter=range=now -45m to now&InOutDiscards_sort=1,desc,avg&limit=5&links=none

  • fields=name,InOutDiscards,RxDiscardsPercent,TxDiscardsPercent,InOutOctets,cdt_device.name,cdt_device.ping_rtt – the fields we want to retrieve, including name and ping from the parent object cdt_device.name,cdt_device.ping_rtt
  • formats=avg – a global formats parameter for all timeseries data
  • InOutDiscards_formats=total,avg&InOutOctets_formats=total – metric specific overrides for the formats to retrieve additional formats for some metrics
  • timefilter=range=now -45m to now – a global timefilter parameter for all timeseries data
  • InOutDiscards_sort=1,desc,avg – sort the interfaces presenting the highest discard rate to the top
  • limit=5&links=none – limit the initial response to 5 ports and don’t show the links reference object

Once a field from a linked resource has been retrieved, it can be treated like any other field. You can specify formats, and timefilters for the field and you can sort and filter the response object by that field. In the example above we requested cdt_device.name, we can reference that to apply a filter to the request to only return data on the interfaces from a single device (or selection of devices).

Example:
api/v2.1/cdt_port/?fields=name,InOutDiscards,RxDiscardsPercent,TxDiscardsPercent,InOutOctets,cdt_device.name,cdt_device.ping_rtt&formats=avg&InOutDiscards_formats=total,avg&InOutOctets_formats=total&timefilter=range=now -45m to now&InOutDiscards_sort=1,desc,avg&limit=5&links=none&cdt_device.name_filter=LIKE(“NewYork%25”)

  • cdt_device.name_filter=LIKE(“NewYork%25”) – filter the response to only show ports on devices with a name starting with NewYork

Response:


{
    "info": "The Statseeker RESTful API",
    "version": "2.1",
    "data": {
        "objects": [
            {
                "status": {
                    "errcode": 0,
                    "success": true
                },
                "data": [
                    {
                        "name": "Gi6/20",
                        "cdt_device.ping_rtt": {
                            "avg": 35.5126
                        },
                        "InOutDiscards": {
                            "total": 5900.34,
                            "avg": 655.593
                        },
                        "InOutOctets": {
                            "total": 13768100000
                        },
                        "cdt_device.name": "NewYork-swt4",
                        "TxDiscardsPercent": {
                            "avg": 0.023552
                        },
                        "RxDiscardsPercent": {
                            "avg": 0
                        },
                        "id": 811
                    },
                    {
                        "name": "Gi2/28",
                        "cdt_device.ping_rtt": {
                            "avg": 47.5407
                        },
                        "InOutDiscards": {
                            "total": 5774.36,
                            "avg": 641.596
                        },
                        "InOutOctets": {
                            "total": 13159300000
                        },
                        "cdt_device.name": "NewYork-swt3",
                        "TxDiscardsPercent": {
                            "avg": 0.0231991
                        },
                        "RxDiscardsPercent": {
                            "avg": 0
                        },
                        "id": 1032
                    },
                    {
                        "name": "Gi6/18",
                        "cdt_device.ping_rtt": {
                            "avg": 35.5126
                        },
                        "InOutDiscards": {
                            "total": 5673.6,
                            "avg": 630.4
                        },
                        "InOutOctets": {
                            "total": 6980780000
                        },
                        "cdt_device.name": "NewYork-swt4",
                        "TxDiscardsPercent": {
                            "avg": 0.00432219
                        },
                        "RxDiscardsPercent": {
                            "avg": 0
                        },
                        "id": 808
                    },
                    {
                        "name": "Gi2/4",
                        "cdt_device.ping_rtt": {
                            "avg": 35.5126
                        },
                        "InOutDiscards": {
                            "total": 5418.93,
                            "avg": 602.103
                        },
                        "InOutOctets": {
                            "total": 1743290000
                        },
                        "cdt_device.name": "NewYork-swt4",
                        "TxDiscardsPercent": {
                            "avg": 0.0754798
                        },
                        "RxDiscardsPercent": {
                            "avg": 0
                        },
                        "id": 709
                    },
                    {
                        "name": "Gi7/22",
                        "cdt_device.ping_rtt": {
                            "avg": 25.2689
                        },
                        "InOutDiscards": {
                            "total": 5256.75,
                            "avg": 584.083
                        },
                        "InOutOctets": {
                            "total": 8214830000
                        },
                        "cdt_device.name": "NewYork-swt1",
                        "TxDiscardsPercent": {
                            "avg": 0
                        },
                        "RxDiscardsPercent": {
                            "avg": 0.013608
                        },
                        "id": 1491
                    }
                ],
                "type": "cdt_port",
                "data_total": 787,
                "sequence": 0
            }
        ],
        "errmsg": "ok",
        "success": true,
        "time": 1534217902
    },
    "revision": "5"
}

Custom Links

Custom links, like their standard counter-part, allow you to query a resource and, via the defined link, request data from another resource in the same query. To achieve this the custom link is first created by linking the field from one resource to the corresponding field in another. Once the link has been created, when querying the resource defined as the ‘link source’ you can also query the resource defined as the ‘link destination’. The syntax for specifying a field from a linked resource is the same as when using standard links:

{linked_resource_name}.{field}
E.g.cdt_device.name

Example:

We have a threshold set for an average 5-minute memory usage of over 90%. With the API we can query threshold event records for details on breaches of this threshold, but we cannot request recent memory usage data leading up to the breach because there is no link between the threshold event resource and the memory resource.

We first create a link between the threshold event and the memory resources by specifying a field that exists in both:

  • The threshold_record resource contains an entityid field which contains the ID of the entity that triggered the breach, in this instance the memory entity
  • The cdt_memory resource contains an id field which contains the ID of the memory entity

The link is created by:

  • Sending a POST command to the resource endpoint
  • Specifying the source resource and field
  • Specifying the destination resource and corresponding field

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <MY_TOKEN>" \
    -X POST \
    "https://my.statseeker.server/api/v2.1/link/?indent=3" \
    -d '{
          "data": [{
            "name": "memoryLink",
            "title": "Link to Memory",
            "default": 1,
            "src": "threshold_record",
            "src_fields": {"entityid": {}},
            "src_query": "{entityid}",
            "dst": "cdt_memory",
            "dst_fields": {"id": {}},
            "dst_query": "{id}"
          }]
        }'

After the link has been created, any query to the source resource can also query data from the linked destination resource. In the example above, we can request memory data while querying threshold records.

Note: for details on the link resource, refer to the link resource in the Resource Reference.

With the link created, we can now send our query containing the following URL:

https://my.statseeker.server/api/v2.1/threshold_record/?fields=time,device,entityTypeName,event,cdt_memory.memoryUsedPercent,Usage5m&Usage5m_field=memoryUsedPercent&Usage5m_object=memory&Usage5m_formats=vals&Usage5m_timefilter=range%20=%20now%20-5m%20to%20now&formats=avg,min,max&timefilter=range=start_of_today%20to%20now&entityTypeName_filter==’memory’&entityTypeName_hide=1&lastx=5&timefmt=%c

Breakdown:

  • https://your.statseeker.server/api/v2.1/threshold_record/ – the resource endpoint, specifying the threshold_record resource
  • ?fields=time,device,entityTypeName,event,cdt_memory.memoryUsedPercent,Usage5m – the fields to return, including the memoryUsedPercent field from our linked cdt_memory resource. We want to return 2 different sets of memoryUsedPercent data, so we include a custom named field, Usage5m for the second set.
Note: for details on named fields, see Named Fields.
  • &Usage5m_field=memoryUsedPercent&Usage5m_object=memory – define the custom named field as another instance of cdt_memory.memoryUsedPercent
  • &Usage5m_formats=vals&Usage5m_timefilter=range = now -5m to now – specify the format and timefilter for the custom field
  • &formats=avg,min,max&timefilter=range=start_of_today%20to%20now – specify the format and timefilter for all other timeseries metrics, in this case it is only cdt_memory.memoryUsedPercent
  • &entityTypeName_filter==’memory’ – filter the returned threshold event records to just those concerning breaches of memory thresholds
  • &entityTypeName_hide=1 – we need to retrieve the entityTypeName in order to filter on it, but we don’t need to see the value in my returned data, so we hide it
  • &lastx=5 – return the 5 most recent records
  • &timefmt=%c – we are specifying the format to use when displaying the time that the threshold breach occurred

Here is the response we receive from the API request:


{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1596598309,
        "objects": [
            {
                "type": "threshold_record",
                "sequence": 0,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 5,
                "data": [                    
                    {
                        "time": "Wed Aug  5 13:24:00 2020",
                        "device": "NewYork-srv4",
                        "event": "Mem905m (memory.memoryUsedPercent avg, threshold: 90%)",
                        "cdt_memory.memoryUsedPercent": {
                            "min": 5,
                            "max": 94.8153,
                            "avg": 49.3997
                        },
                        "Usage5m": {
                            "vals": [
                                89.5952,
                                92.3465,
                                93.1448,
                                94.4017,
                                94.7985
                            ]
                        },
                        "id": "5F2A2650-1B-2"
                    },
                    {
                        "time": "Wed Aug  5 13:19:00 2020",
                        "device": "Budapest-srv2",
                        "event": "Mem905m (memory.memoryUsedPercent avg, threshold: 90%)",
                        "cdt_memory.memoryUsedPercent": {
                            "min": 4.99998,
                            "max": 96.9951,
                            "avg": 50.3273
                        },
                        "Usage5m": {
                            "vals": [
                                91.668,
                                94.1118,
                                95.4288,
                                96.9171,
                                95.5872
                            ]
                        },
                        "id": "5F2A2524-16-2"
                    },
                    {
                        "time": "Wed Aug  5 13:19:00 2020",
                        "device": "NewYork-srv4",
                        "event": "Mem905m (memory.memoryUsedPercent avg, threshold: 90%)",
                        "cdt_memory.memoryUsedPercent": {
                            "min": 5,
                            "max": 94.8153,
                            "avg": 49.3997
                        },
                        "Usage5m": {
                            "vals": [
                                91.5952,
                                92.3465,
                                93.1448,
                                94.4017,
                                94.7985
                            ]
                        },
                        "id": "5F2A2524-15-2"
                    },
                    {
                        "time": "Wed Aug  5 13:14:00 2020",
                        "device": "Budapest-srv2",
                        "event": "Mem905m (memory.memoryUsedPercent avg, threshold: 90%)",
                        "cdt_memory.memoryUsedPercent": {
                            "min": 4.99998,
                            "max": 97.9951,
                            "avg": 50.3273
                        },
                        "Usage5m": {
                            "vals": [
                                91.668,
                                94.1118,
                                95.4288,
                                96.9171,
                                96.5872
                            ]
                        },
                        "id": "5F2A23F8-E-2"
                    },
                    {
                        "time": "Wed Aug  5 12:44:00 2020",
                        "device": "Pretoria-srv",
                        "event": "Mem905m (memory.memoryUsedPercent avg, threshold: 90%)",
                        "cdt_memory.memoryUsedPercent": {
                            "min": 20.1107,
                            "max": 96.9795,
                            "avg": 51.634
                        },
                        "Usage5m": {
                            "vals": [
                                91.2561,
                                91.4009,
								91.587,
                                91.8134,
                                92.0167
                            ]
                        },
                        "id": "5F2A1CF0-6C-2"
                    }                    
                ]
            }
        ]
    },
}

[top]




Named Fields

The API doesn’t allow you to explicitly request the same field twice in the same call. When you want to request multiple sets of data for the same field, but with different options, you can use named fields; simply add a custom field to the fields parameter.

Example:

I want to request TxUtil data on all ports on a device but I want the data broken into today and yesterday. To do this I am going to:

  • Specify two named fields, yesterdayTx and todayTx
    fields=cdt_device.name,name,yesterdayTx,todayTx
  • Define what those fields refer to
    yesterdayTx_field=TxUtil&todayTx_field=TxUtil
  • Set specific timefilters for each named field
    yesterdayTx_timefilter=range=start_of_today -1d to start_of_today&todayTx_timefilter=range=start_of_today to now
  • Use a global formats parameter to apply to both
    formats=min,max,avg,95th
  • Filter the response to just the device in question
    cdt_device.name_filter=IS(“<DEVICE NAME>”)

My full request string will be:
api/v2.1/cdt_port/?fields=cdt_device.name,name,yesterdayTx,todayTx&todayTx_field=TxUtil&formats=max,min,avg,95th&todayTx_timefilter=range=start_of_today to now&yesterdayTx_field=TxUtil&yesterdayTx_timefilter=range=start_of_today -1d to start_of_today&cdt_device.name_filter=IS(“<DEVICE NAME>”)&links=none

The response is:


{
    "info": "The Statseeker RESTful API",
    "version": "2.1",
    "data": {
        "objects": [
            {
                "status": {
                    "errcode": 0,
                    "success": true
                },
                "data": [
                    {
                        "cdt_device.name": "<DEVICE NAME>",
                        "yesterdayTx": {
                            "max": 9.85221,
                            "avg": 9.78883,
                            "95th": 9.84576,
                            "min": 8.00007
                        },
                        "name": "Gi0/1",
                        "todayTx": {
                            "max": 9.8516,
                            "avg": 9.80882,
                            "95th": 9.84672,
                            "min": 9.34127
                        },
                        "id": 1975
                    },
                    {
                        "cdt_device.name": "<DEVICE NAME>",
                        "yesterdayTx": {
                            "max": 786.667,
                            "avg": 294.361,
                            "95th": 766.18,
                            "min": 83.6935
                        },
                        "name": "Gi0/2",
                        "todayTx": {
                            "max": 543.072,
                            "avg": 182.109,
                            "95th": 497.423,
                            "min": 95.8462
                        },
                        "id": 1976
                    },
                    {
                        "cdt_device.name": "<DEVICE NAME>",
                        "yesterdayTx": {
                            "max": 783.816,
                            "avg": 256.446,
                            "95th": 714.649,
                            "min": 94.7673
                        },
                        "name": "Gi0/3",
                        "todayTx": {
                            "max": 786.667,
                            "avg": 495.852,
                            "95th": 781.882,
                            "min": 96.1355
                        },
                        "id": 1977
                    },
                    {
                        "cdt_device.name": "<DEVICE NAME>",
                        "yesterdayTx": {
                            "max": 7.48404,
                            "avg": 3.68874,
                            "95th": 4.88369,
                            "min": 0.995533
                        },
                        "name": "Gi0/4",
                        "todayTx": {
                            "max": 7.70181,
                            "avg": 4.54324,
                            "95th": 5.55599,
                            "min": 2.71828
                        },
                        "id": 1978
                    },
                    {
                        "cdt_device.name": "<DEVICE NAME>",
                        "yesterdayTx": {
                            "max": 8.37714,
                            "avg": 2.99202,
                            "95th": 6.29977,
                            "min": 0.96669
                        },
                        "name": "Gi0/5",
                        "todayTx": {
                            "max": 8.24358,
                            "avg": 6.07991,
                            "95th": 7.4297,
                            "min": 3.94083
                        },
                        "id": 1979
                    }
                ],
                "type": "cdt_port",
                "data_total": 5,
                "sequence": 0
            }
        ],
        "errmsg": "ok",
        "success": true,
        "time": 1533779107
    },
    "revision": "5"
}

[top]




Field Formulas

Field formulas allow you to request a user defined field from the API and populate that field via a formula based on other fields returned in the request. The formula accepts SQL operators and conventions, and can reference the values of other fields, returned by the query, with the following syntax:

  • Configuration field: {field}, e.g. {ping_poll}
  • Timeseries/Event fields must also define a data format: {field:format}, e.g. {ping_rtt:current}

[top]


Formula Example: Convert InOctets to Mebibytes

Request: /api/v2.1/cdt_port/?fields=cdt_device.name,name,InOctets,InMB&timefilter=range = now -30m to now&formats=vals&InMB_formula={InOctets:vals}/1024/1024&cdt_device.name_filter=IS(“<DEVICE NAME>”)

The request:

  • Defines a named field, InMB
  • Specifies the formula to use to populate that field: InMB_formula={InOctets:vals} / 1024 / 1024
  • Must include any field referenced within the formula as well as any required data format, in this case {InOctets:vals}

Response:


{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1597795111,
        "objects": [
            {
                "type": "cdt_port",
                "sequence": 0,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 2,
                "data": [
                    {
                        "cdt_device.name": "<DEVICE NAME>",
                        "name": "int.2",
                        "InOctets": {
                            "vals": [
                                72506880,
                                72525312,
                                72607744,
                                72499968,
                               ...
                                73761536,
                                72515328
                            ]
                        },
                        "InMB": [
                            69.1479,
                            69.1655,
                            69.2441,
                            69.1414,
                            ...
                            70.3445,
                            69.156
                        ],
                        "id": 591
                    },
                    {
                        "cdt_device.name": "<DEVICE NAME>",
                        "name": "int.3",
                        "InOctets": {
                            "vals": [
                                1204222976,
                                1162312704,
                                1141559296,
                                1186676992,
                                ...
                                1385965824,
                                1365224192
                            ]
                        },
                        "InMB": [
                            1148.44,
                            1108.47,
                            1088.68,
                            1131.7,
                            ...
                            1321.76,
                            1301.98
                        ],
                        "id": 592
                    }
                ]
            }
        ]
    },
    "links": []
}

[top]




Formula Example: Ping Latency Gauge using a Case Statement

Request: /api/v2.1/cdt_device/?fields=name,ping_rtt,status&timefilter=range = now -30m to now&formats=avg&status_formula=CASE WHEN {ping_rtt:avg} < 10 THEN 'Green' WHEN {ping_rtt:avg} < 50 THEN 'Amber' WHEN {ping_rtt:avg} IS NULL THEN 'Unknown' ELSE 'Red' END

The request:

  • Defines a named field, status
  • Provides a case statement to populate that field: status_formula=CASE WHEN {ping_rtt:avg} < 10 THEN 'Green' WHEN {ping_rtt:avg} < 50 THEN 'Amber' WHEN {ping_rtt:avg} IS NULL THEN 'Unknown' ELSE 'Red' END
  • Must include any field referenced within the formula as well as any required data format, in this case {ping_rtt:avg}

Response:


{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1597793987,
        "objects": [
            {
                "type": "cdt_device",
                "sequence": 360,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 226,
                "data": [
                    {
                        "name": "NewYork-ups1",
                        "ping_rtt": {
                            "avg": 35.4
                        },
                        "status": "Amber",
                        "id": 338
                    },
                    {
                        "name": "NewYork-ups2",
                        "ping_rtt": {
                            "avg": 41.7333
                        },
                        "status": "Amber",
                        "id": 339
                    },
                    {
                        "name": "NewYork-swt2",
                        "ping_rtt": {
                            "avg": 52.6
                        },
                        "status": "Red",
                        "id": 347
                    },
					
                    ...
					...
					
					
                    {

                        "name": "Phoenix-swt1",
                        "ping_rtt": {
                            "avg": 41.6667
                        },
                        "status": "Amber",
                        "id": 387
                    }
                ]
            }
        ]
    },
    "links": []
}

[top]




Formula Example: Nested Formulas

Request: /api/v2.1/cdt_device/?fields=name,sysLocation,ping_rtt,status,prettyPing,prettyStatus&timefilter=range = now -30m to now&formats=avg&status_formula=CASE WHEN {ping_rtt:avg} < 10 THEN 'Green' WHEN {ping_rtt:avg} < 50 THEN 'Amber' WHEN {ping_rtt:avg} IS NULL THEN 'Unknown' ELSE 'Red' END&prettyPing_formula={ping_rtt:avg} || ' ms'&prettyStatus_formula={status} || ' (' || {prettyPing} || ')'&sysLocation_filter=IS("LosAngeles")

The request:

  • Defines a multiple named fields: status, prettyPing, prettyStatus
  • Defines formula to populate each:
    • status_formula=CASE WHEN {ping_rtt:avg} < 10 THEN 'Green' WHEN {ping_rtt:avg} < 50 THEN 'Amber' WHEN {ping_rtt:avg} IS NULL THEN 'Unknown' ELSE 'Red' END
    • prettyPing_formula={ping_rtt:avg} || ‘ ms’
    • prettyStatus_formula={status} || ‘ (‘ || {prettyPing} || ‘)’ – requires output from other formula fields
  • Must include any field referenced within the formula as well as any required data format, in this case {ping_rtt:avg}, {status} and {prettyPing}

Response:


{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1597796468,
        "objects": [
            {
                "type": "cdt_device",
                "sequence": 360,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 12,
                "data": [
                    {
                        "name": "LosAngeles-ups1",
                        "sysLocation": "LosAngeles",
                        "ping_rtt": {
                            "avg": 38.1333
                        },
                        "status": "Amber",
                        "prettyPing": "38.1333 ms",
                        "prettyStatus": "Amber (38.1333 ms)",
                        "id": 350
                    },
                    {
                        "name": "LosAngeles-ups2",
                        "sysLocation": "LosAngeles",
                        "ping_rtt": {
                            "avg": 32.4
                        },
                        "status": "Amber",
                        "prettyPing": "32.4 ms",
                        "prettyStatus": "Amber (32.4 ms)",
                        "id": 351
                    },
					...
					...
                    {
                        "name": "LosAngeles-rtr",
                        "sysLocation": "LosAngeles",
                        "ping_rtt": {
                            "avg": 43.8
                        },
                        "status": "Amber",
                        "prettyPing": "43.8 ms",
                        "prettyStatus": "Amber (43.8 ms)",
                        "id": 361
                    }
                ]
            }
        ]
    },
    "links": []
}

[top]




GET Example: Retrieving Details on Multiple Devices

Return specified details on all devices in a specified group, the fields I am returning are:

  • name
  • id
  • community
  • ipaddress
  • snmp_version
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/cdt_device/?fields=name,id,community,ipaddress,snmp_version&groups=<GROUP NAME>&indent=3"


# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_device'
# specify fields to be returned
query += '/?fields=name,id,community,ipaddress,snmp_version'
# Filters
query += '&groups=<GROUP NAME>'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += "/cdt_device"
# specify fields to be returned
$query += '?fields=name,id,community,ipaddress,snmp_version'
# Filters
$query += '&groups=<GROUP NAME>'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"


{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.172",
            "name": "Brisbane-Server1",
            "community": "public",
            "id": 551
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.180",
            "name": "Brisbane-Server2",
            "community": "public",
            "id": 552
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.186",
            "name": "Sydney-Server1",
            "community": "public",
            "id": 555
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.187",
            "name": "Sydney-Server2",
            "community": "public",
            "id": 556
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.194",
            "name": "Melbourne-Server1",
            "community": "public",
            "id": 557
          }
        ],
        "type": "cdt_device",
        "data_total": 5
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496188135
  },
  "links": [],
  "api_version": "2.1"
}
[top]

POST

Use the POST request to create new instances of the specified resource. The data object included in a POST request must be a json string with a single data key. Some resource types will require additional keys within the data object, use the /describe endpoint to view the requirements for a given resource.

[top]

Example: Creating Multiple Groups

RequestPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X POST \
	"https://your.statseeker.server/api/v2.1/group/?indent=3" \
	-d '{"data":[{"name":"<GROUP NAME 1>"},{"name":"<GROUP NAME 2>"}]}' 



# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.post(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.post(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/group'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"data":[{"name":"<GROUP NAME 1>"},{"name":"<GROUP NAME 2>"}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :post,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :post,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"data":[{"name":"<GROUP NAME 1>"},{"name":"<GROUP NAME 2>"}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "name": "<GROUP NAME 1>",
            "id": 46458
          },
          {
            "name": "<GROUP NAME 2>",
            "id": 46459
          }
        ],
        "type": "group",
        "data_total": 2
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496190459
  },
  "api_version": "2.1"
}
[top]

PUT Requests

Use the PUT request to update an existing instance of the specified resource. The data object included must be a json string with both a fields key (to identify the resource/s to be updated) and a data key (to specify the data to be updated). Some resource types will require additional keys within the data object, use the /describe endpoint to view the requirements for a given resource.

When sending a PUT request, the data object (request payload) requires both a data key and a fields key.

Example: Updating a Group Name
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X PUT \
	"https://your.statseeker.server/api/v2.1/group/?indent=3" \
	-d '{"fields":{"name":{"field":"name","filter":{"query":"=\u0027<OLD GROUP NAME>\u0027"}}},"data":[{"name":"<NEW GROUP NAME>"}]}'

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.put(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.put(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += ''
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"fields":{"name":{"field":"name","filter":{"query":"='<OLD GROUP NAME>'"}}},"data":[{"name":"<NEW GROUP NAME>"}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :put,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :put,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"fields":{"name":{"field":"name","filter":{"query":"=\'<OLD GROUP NAME>\'"}}},"data":[{"name":"<NEW GROUP NAME>"}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"


{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496190511
  },
  "api_version": "2.1"
}

[top]

DELETE

Use the DELETE request to delete an existing instance of the specified resource. The data object included must be a json string with a single fields key. Some resource types will require additional keys within the data object, use the /describe endpoint to view the requirements for a given resource.

[top]

Example: Deleting Multiple Groups

We will be deleting all groups with a name matching a specified filter string.

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X DELETE \
	"https://your.statseeker.server/api/v2.1/group/?indent=3" \ 
	-d '{"fields":{"name":{"field":"name","filter":{"query":"LIKE \u0027<FILTER STRING>\u0027"}}}}'


# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.delete(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.delete(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/group'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"fields":{"name":{"field":"name","filter":{"query":"LIKE '<FILTER STRING>'"}}}})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :delete,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :delete,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"fields":{"name":{"field":"name","filter":{"query":"LIKE \'<FILTER STRING>\'"}}}}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"



{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623638287
   }
}
[top]

The Describe Endpoint (/api/v2.1/{resource}/describe)

The /describe endpoint is particularly useful as it allows you to query a specified resource to return details on the resource.

The response from a GET request targeting the {resource}/describe endpoint will contain:

  • All fields pertaining to the resource
  • All request methods that can be applied to the resource
  • All fields and data that can be used with each request method

The various HTTP request types are mapped to commands within the API.

HTTP Request Method API Command
GET get
POST add
PUT update
DELETE delete

The /describe endpoint can be applied to any resources returned from a GET request applied to the root endpoint.
I.e.https://your.statseeker.server/api/v2.1/ will return all resources available to the Statseeker installation, and any of these can have /describe applied to return details on the resource.

[top]

GET

The parameters that may be passed when sending a GET request.

Parameters Type/Valid Values Description
links
  • only – only return the links object, no data object
  • none – only return the data object, no links object
  • html – return html links. If the response is being displayed in a browser then the links may be clicked to send a GET request for the associated object/field.
  • htmlonly – only return html links, no data object
Modifies how the links contained within the response object are presented
indent positive integer Number of characters to indent when formatting code blocks for display

[top]

Example: Requesting a /describe on the User Resource
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server1/api/v2.1/user/describe/?indent=3"


# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += 'user/describe'
# optional response formatting
query += '/?indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}') 


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += 'user/describe'
# optional response formatting
$query += '/?indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "fields": {
          "tz": {
            "datatype": "string",
            "description": "User time zone",
            "title": "Time Zone"
          },
          "name": {
            "datatype": "string",
            "description": "User name",
            "title": "Name"
          },
          "auth": {
            "datatype": "string",
            "description": "User authentication method",
            "title": "Authentication method"
          },
          "email": {
            "datatype": "string",
            "description": "User email address",
            "title": "Email"
          },
          "api": {
            "datatype": "string",
            "description": "User API access permission",
            "title": "API Access"
          },
          "password": {
            "datatype": "string",
            "description": "User password",
            "title": "Password"
          },
          "id": {
            "datatype": "integer",
            "description": "User Identifier",
            "title": "ID"
          }
        },
        "commands": {
          "delete": {
            "valid_fields": {
              "tz": {
                "required": false
              },
              "name": {
                "required": false
              },
              "auth": {
                "required": false
              },
              "email": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "id": {
                "required": false
              }
            },
            "valid_data": null
          },
          "add": {
            "valid_fields": null,
            "valid_data": {
              "tz": {
                "required": false
              },
              "name": {
                "required": true
              },
              "auth": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "email": {
                "required": false
              }
            }
          },
          "describe": {
            "valid_fields": null,
            "valid_data": null
          },
          "update": {
            "valid_fields": {
              "tz": {
                "required": false
              },
              "name": {
                "required": false
              },
              "auth": {
                "required": false
              },
              "email": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "id": {
                "required": false
              }
            },
            "valid_data": {
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "tz": {
                "required": false
              },
              "email": {
                "required": false
              },
              "auth": {
                "required": false
              }
            }
          },
          "get": {
            "valid_fields": {
              "tz": {
                "required": false
              },
              "name": {
                "required": false
              },
              "auth": {
                "required": false
              },
              "email": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "id": {
                "required": false
              }
            },
            "valid_data": null
          }
        },
        "type": "user",
        "description": "Statseeker Users",
        "title": "User"
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496190907
  },
  "api_version": "2.1"
}
[top]

The Execute Endpoint (/api/v2.1/{resource}/execute)

The execute endpoint is used to run an execute command on a specific resource, currently this functionality is limited to:

  • the discover resource (/api/v2.1/discover/execute)
  • the config_build resource (/api/v2.1/config_build/execute)

[top]

GET

A GET request to a {resource}/execute endpoint will run the command associated with that resource.

The parameters that may be passed when sending a GET request depend upon the resource the execute is being run against.
For example, the valid parameters for running an execute against the discover resource are:

Parameters Type/Valid Values Description
getNext Boolean, defaults to false Discover using SNMP getNext. Only for use with mode=single.
snmpv3config Path The path to the configuration file containing details on the SNMPv3 devices to be added. Only for use with mode=snmpv3add
verbose Values:

  • 0 – least verbose
  • 1
  • 2
  • 3 – most verbose
Verbosity level to be used when outputting to the log file
ip IP address The IP address of the device to be discovered. Only for use with mode=single.
minimal Boolean, defaults to false Perform a minimal discovery on the specified device. A minimal discovery only walks the following tables:

  • SNMPv2-MIB.system
  • SNMP-FRAMEWORK-MIB.snmpEngine
  • IF-MIB.ifTable
  • IF-MIB.ifXTable


Only for use with mode=single

snmperrlog Boolean, defaults to false Enable SNMP error logging
device string The name of the device to rewalk. Only for use with mode=rewalk.
logfile Path, defaults to defaults to ~/nim/etc/discover.log The path to the discovery process log file ()
snmpv1 Boolean, defaults to false Force SNMPv1 collection. Only for use with mode=single
block Boolean, defaults to false If set to true, then the discovery process will not run if another discovery process is already in progress
mode Values:

  • hosts – discover by the Statseeker hosts file
  • ranges – discover by Statseeker ranges configuration
  • rewalk – rewalk the discovered network for changes
  • single – discover a single device
  • snmpv3add – add an SNMPv3 device
The mode of discovery to be used

[top]

Example: Discovering a Single Device

The device IP is 10.100.89.252.

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/discover/execute/?mode=single&ip=10.100.89.252&verbose=0&links=none" 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/discover/execute/'
# specify options
query += '?mode=single&ip=10.100.89.252&verbose=0'
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/user/describe'
# specify options
$query += "/?mode=single&ip=10.100.89.252&verbose=0"
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"


{
    "version": "2.1",
    "revision": "9",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1575867957,
        "objects": [
            {
                "type": "discover",
                "sequence": 1,
                "status": {
                    "success": true,
                    "errcode": 0
                }
            }
        ]
    }
}
[top]

ID Endpoint (/api/v2.1/{resource}/{id})

The ID endpoint is used to run queries on a specific resource.

[top]

GET

The parameters that may be passed when sending a GET request.

Parameters Type/Valid Values Description
fields A comma separated list of field names
E.g.fields=id,name,location
The list of fields that will be returned in the response. This parameter will be ignored if fields_adv is also specified.
fields_adv A JSON string detailing the fields to be returned
E.g.fields_adv={“Device Name”:{“field”:”name”}, “IP”:{“field”:”ipaddress”},”Location”:{“field”:”sysLocation”},”SNMP Polling”:{“field”:”snmp_poll”,”filter”:{“query”:”=\u0027off\u0027″}}}
The list of fields that will be returned in the response
interval positive integer
E.g.interval=300
The polling interval to be applied to all timeseries metrics specified in the fields parameter. When not specified, the default polling interval of 60 seconds is used.
limit positive integer
E.g.limit=100
The number of items to return per ‘page’ of the response, see Pagination for details. The API will automatically paginate response data with a default limit=50.
offset positive integer
E.g.offset=100
The number of result items to skip, see Pagination for details. The API will automatically paginate response data with a default offset={limit}.
groups A comma separated list of group names or group IDs A list of groups to be used to filter the response data, only data associated with members of the specified groups will be returned
grouping_mode
  • and
  • or
The mode to use when processing multiple values in the group parameter
filter An SQL filter string
E.g.“SNMP Polling”:{“field”:”snmp_poll”,”filter”:{“query”:”=\u0027off\u0027″}}
A filter to be applied to the response data


When the fields parameter has been specified, the following additional parameters may be used.

Parameters Type/Valid Values Description
{field}_field string A user defined variable name followed by a valid field name for the resource.

E.g.yesterday_RxUtil

See Named Fields for more information and examples.
{field}_formats Comma separated list, see Timeseries Data: Stats, Formats & Options The formats to request from the API for the given field, required for timeseries data fields

Note: a global formats key (formats=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_filter string The filter to apply to the given field
{field}_filter_format string The format to use for the filter, required for timeseries data fields
{field}_interval integer The polling interval (in seconds) to use for the specified field. When used, a field-specific timefilter for the specified field must also also be used.

Note: when not specified, the default interval of 60 seconds is used. A global interval key (interval=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_timefilter string The timefilter to use for the given field, required for timeseries data fields.

Note: a global timefilter key (timefilter=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_tz string An alternate timezone to use for the {field}_timefilter.

All timefilters use the Statseeker server’s timezone unless an override is specified by supplying {field}_tz.

Note: a global timezone key (tz=) may also be used to apply the same values to all timeseries metrics specified in fields
{field}_sort Comma separated list specifying the sort hierarchy and direction, in the following format:{field}_sort={rank}{direction} and for Timeseries data:{field}_sort={rank}{direction}{format}
E.g.name_sort=1,asc
RxUtil_sort=1,desc,avg
{field}_stats Comma separated list, see Timeseries Data: Stats, Formats & Options The stats to use for the given field
{field}_aggregation_format One of:

Format Description
95th The 95th percentile of the values
avg The average of the values
cat Concatenation of the values. Not supported for non-scalar formats such as vals
count The number of rows that match, and have a non-null value
count_all The number of rows that match, including NULL values
first The first matching value
last The last matching value
list Concatenate values as per the cat format, but return the output as comma separated list of values
max The maximum value
median The median value
min The minimum value
stddev The standard deviation value
sum The sum of all values
total Similar to sum, but returns 0 instead of NULL if there are only NULL values in the data being aggregated
The aggregation format to use for the specified field

Note: using aggregation, the following rules apply:

  • When the aggregated data is a number – ignore all null values and return the aggregated value required based on non-null values only
  • When the aggregated data is NOT a number – attempt to convert all values to a number prior to aggregation. Any instance of null will result in the aggregated value being returned as null.

[top]

Example: Retrieving Details on a Device

Return specified details on a device with a specified ID. The details I am going to retrieve are:

  • name
  • id
  • community
  • ipaddress
  • snmp_version
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/cdt_device/<DEVICE ID>/?fields=name,id,community,ipaddress,snmp_version&indent=3" 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_device/<DEVICE ID>'
# specify fields to be returned
query += '/?fields=name,id,community,ipaddress,snmp_version'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_device/<DEVICE ID>'
# specify fields to be returned
$query += '/?fields=name,id,community,ipaddress,snmp_version'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"



{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1623636846,
        "objects": [
            {
                "type": "cdt_device",
                "sequence": 0,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 1,
                "data": [
                    {
                        "name": "Chicago-srv1",
                        "id": <DEVICE ID>,
                        "community": "public",
                        "ipaddress": "10.100.46.11",
                        "snmp_version": 2
                    }
                ]
            }
        ]
    }
}
[top]

PUT

The PUT request can be used to update the fields associated with the specified resource. Not all fields contained within a specific resource may be updated, use the /describe endpoint to view the requirements for a given resource.
[top]

Example: Updating a Group Name
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X PUT \
	"https://your.statseeker.server/api/v2.1/group/<GROUP ID>/?indent=3" \
	-d '{"data":[{"name":"<NEW NAME>"}]}' 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.put(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.put(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/group/<GROUP ID>'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"data":[{"name":"<NEW NAME>"}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')



# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :put,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :put,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group/<GROUP ID>'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"data":[{"name":"<NEW NAME>"}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"



{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623637436
   }
}
[top]

DELETE

The DELETE request can be used to delete the specified resource.

[top]

Example: Deleting a Group
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X DELETE \
	"https://your.statseeker.server/api/v2.1/group/<GROUP ID>/?indent=3"

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.delete(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.delete(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/group/<GROUP ID>'
# optional response formatting
query += '/?indent=3&links=none'
# data
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}') 


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :delete,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :delete,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group/<GROUP ID>'
# optional response formatting
$query += '/?indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"


{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623637436
   }
}
[top]

Field Endpoint (/api/v2.1/{resource}/{id}/{field})

The Field endpoint is used to run queries on a specific field within a specified resource, use the /describe endpoint to view the field restrictions for a given resource.

[top]

GET

The parameters that may be passed when sending a GET request behave exactly like the {field}_* parameters for the Resource and ID endpoints. When targeting timeseries metrics, the following parameters may be specified.

Parameters Type/Valid Values Description
formats Comma separated list, see Timeseries Data: Stats, Formats & Options The formats to request from the API for the given field, required for timeseries data fields

Note: a global formats key (formats=) may also be used to apply the same values to all timeseries metrics specified in fields
filter string The filter to apply to the given field
filter_format string The format to use for the filter, required for the timeseries data field
interval integer The polling interval (in seconds) to use for the specified field.

Note: when not specified, the default interval of 60 seconds is used.
timefilter string The timefilter to use for the field
tz string An alternate timezone to use for the timefilter.

All timefilters use the Statseeker server’s timezone unless an override is specified
stats Comma separated list, see Timeseries Data: Stats, Formats & Options The stats to use for the given field

[top]

Example: Returning a User’s Time Zone
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/user/<USER ID>/tz/?indent=3"

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/user/<USER ID>/tz'
# optional response formatting
query += '/?indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}') 


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/user/<USER ID>/tz'
# optional response formatting
$query += '/?indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"


{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623638836,
      "objects":[
         {
            "type":"user",
            "sequence":0,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":1,
            "data":[
               {
                  "tz":"Australia/Brisbane",
                  "id":<USER ID>
               }
            ]
         }
      ]
   }
}
[top]

PUT

The PUT request can be used to update the specified field. Not all fields contained within a specific resource may be updated, use the /describe endpoint to view the restrictions for a given resource. The data object must contain a value key containing the new value/s to be set for the field.
[top]

Example: Updating a User’s Time Zone
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X PUT \
	"https://your.statseeker.server/api/v2.1/user/<USER ID>/tz/?indent=3" \
	-d '{"value":"Europe/Paris"}'

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.put(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.put(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/user/<USER ID>/tz'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"value":"Europe/Paris"})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :put,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :put,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/user/<USER ID>/tz'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"value":"Europe/Paris"}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"



{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496193864
  },
  "api_version": "2.1"
}
[top]



Common Resources: Examples and Sample Code

Most of the processes and objects that you are used to interacting with in Statseeker (network discovery, users, groups, devices, interfaces, alerts, etc.) are exposed as resources from the API standpoint and through querying the API these resources can be returned as data objects which you can review and modify.

Statseeker exposes many resources via the API but most API users will spend the majority of their time working with just a few. The most commonly used resources are presented below along with examples of interacting with those resources.

Note:

[top]

Users

The User resource allows you to interact with (create, edit, delete, and report on) Statseeker user records.

The user object
Field ID Field Title Type Get, Add, Update Description
api API Access string G, U, A User API access permission, one of:

  • r
  • rw
auth Authentication method string G, U, A User authentication method, one of:

  • file
  • ldap
  • radius
auth_refresh Authentication Refresh integer G, U, A The time allowed after a token has expired that it will be refreshed (in seconds)
auth_ttl Authentication TTL integer G, U, A The TTL for authentication tokens (in seconds)
email Email string G, U, A User email address
exportDateFormat Date Format string G, U, A User specified Date Format
id ID integer G User Identifier
is_admin Is Admin integer G, U, A Whether the user has admin access, one of:

  • 0
  • 1
name Name string G, A (required) User name
password Password string G, U, A User password
reportRowSpacing Report Row Spacing string G, U, A The report row spacing preference for the user
top_n Top N integer G, U, A The default Top N number for the user
tz Time Zone string G, U, A User time zone

[top]

Example: Creating a New User

cURLPythonRubyResponse

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-X POST \
	-H "Authorization: Bearer <MY_TOKEN>" \
	"https://your.statseeker.server/api/v2.1/user/?indent=3" \
	-d '{"data":[{"name":"<USER NAME>","password":"<PASSWORD>","auth":"<AUTHENTICATION METHOD>","email":"<EMAIL ADDRESS>","api":"<API PERMISSION>","tz":"<TIMEZONE>"}]}' 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.post(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.post(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/user'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"data":[{"name":"<USER NAME>","password":"<PASSWORD>","auth":"<AUTHENTICATION METHOD>","email":"<EMAIL ADDRESS>","api":"<API PERMISSION>","tz":"<TIMEZONE>"}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}') 

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :post,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :post,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/user'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
# define payload in json format
$reqData = '{"data":[{"name":"<USER NAME>","password":"<PASSWORD>","auth":"<AUTHENTICATION METHOD>","email":"<EMAIL ADDRESS>","api":"<API PERMISSION>","tz":"<TIMEZONE>"}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"


{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623643182,
      "objects":[
         {
            "type":"user",
            "sequence":1,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":1,
            "data":[
                  "api":"<API PERMISSION>",
                  "auth":"<AUTHENTICATION METHOD>",
                  "email":"<EMAIL ADDRESS>",
                  "name":"<USER NAME>",
                  "password":"<PASSWORD>",
                  "tz":"<TIMEZONE>",
                  "id":94551,
                  "is_admin":0
               }
            ]
         }
      ]
   }
}
[top]

Example: Updating an Existing User

cURLPythonRubyResponse

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X PUT \
	"https://your.statseeker.server/api/v2.1/user/<USER ID>?indent=3" \
	-d '{"data":[{"api":"<API PERMISSION>","tz":"<NEW TIMEZONE>"}]}' 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.put(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.put(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/user/<USER ID>'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"data":[{"api":"<API PERMISSION>","tz":"<NEW TIMEZONE>"}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :put,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :put,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/user/<USER ID>'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"data":[{"api":"<API PERMISSION>","tz":"<NEW TIMEZONE>"}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"


{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623644832
   }
}
[top]

Devices (cdt_device)

The cdt_device resource allows you to interact with your currently discovered network devices.

The cdt_device object
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G, U The poll state of the entity

  • on
  • off
auth_method SNMPv3 Authentication Method string G, U, A Authentication method for SNMPv3 devices, one of:

  • md5
  • sha
auth_pass SNMPv3 Authentication Password string G, U, A Authentication password for SNMPv3 devices
auth_user SNMPv3 Authentication Username string G, U, A Authentication user for SNMPv3 devices
community Community string G, U, A The community string status of the device
context SNMPv3 Context string G, U, A Context for SNMPv3 devices
custom_data_details Custom Data Details string G, U A JSON string object indicating which custom entities have been found during a discovery
discover_getNext Use GetNext string G, U Walk this device using SNMP getNext instead of getBulk, one of:

  • 0
  • 1
discover_minimal Use Minimal Walk string G, U Walk this device using a minimal set of oids, one of:

  • 0
  • 1
discover_snmpv1 Use SNMPv1 string G, U Walk this device using SNMPv1, one of:

  • 0
  • 1
hostname Hostname string G, U, A The hostname of the device
ipaddress IP Address string G, U, A (required) The IP address of the device
latitude Latitude float G, U The user defined latitude of the device’s location
longitude Longitude float G, U The user defined longitude of the device’s location
manual_name User Defined Name string G, U The user defined name of the device
memorySize Memory Size integer G The amount of physical read-write memory contained by the entity
mis MAC/IP/Switch Collection State string G, U Include this device in the MIS report calculations, one of

  • on
  • off
ping_dup Ping Duplicate integer G Number of duplicate ping responses received
Timeseries Data: Stats, Formats & Options
ping_lost1 Ping Lost 1 integer G Number of times that a single ping request is lost
Timeseries Data: Stats, Formats & Options
ping_lost2 Ping Lost 2 integer G Number of times that two ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_lost3 Ping Lost 3 integer G Number of times that three ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_lost4 Ping Lost 4 integer G Number of times that four ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_outage Ping Outage integer G, U Number of seconds to wait before a device is considered to be down
ping_poll Ping Poll string G, U, A The ping polling status of the device, one of:

  • on
  • off
ping_rtt Ping RTT integer G The current ping state of the device
Timeseries Data: Stats, Formats & Options
ping_rtt_ms Ping RTT(High Precision) float G The current ping state of the device in ms to 3 decimal places
Timeseries Data: Stats, Formats & Options
ping_state Ping State string G, U The current ping state of the device, one of:

  • up
  • down

Can be combined with an event format for event-based analytics, see Event Formats.

priv_method SNMPv3 Privacy Method string G, U, A Privacy method for SNMPv3 devices, one of:

  • aes
  • aes192
  • aes256
  • des
  • des3
priv_pass SNMPv3 Privacy Password string G, U, A Privacy password for SNMPv3 devices
retired Retired string G The device has been Retired, one of:

  • on
  • off
snmpEngineID SNMP Engine ID string G, U An SNMP engine’s administratively-unique identifier
snmp_maxoid SNMP Max OID integer G, U Maximum number of oids to poll in a single request
snmp_poll SNMP Poll string G, U, A The SNMP polling status of the device, one of:

  • on
  • off
snmp_version SNMP Version integer G, U, A The SNMP version of the device, one of:

  • 1
  • 2
  • 3
sysContact Contact string G, U The textual identification of the contact person for the entity
sysDescr System Description string G, U A textual description of the entity
sysLocation Location string G, U The physical location of the entity
sysName System Name string G, U An administratively-assigned name for the entity
sysObjectID Object ID string G, U The vendor’s authoritative identification of the network management subsystem contained in the entity
sysServices Services integer G, U A value which indicates the set of services that the entity may potentially offer
vendor Vendor string G The vendor name for the device
Links

This resource has links to the following:

[top]

Example: Configuring a Device as Ping-Only

cURLPythonRubyResponse

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X PUT \
	"https://your.statseeker.server/api/v2.1/cdt_device/<DEVICE ID>/?indent=3" \
	-d '{"data":[{"ping_poll":"on","snmp_poll":"off"}]}'

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.put(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.put(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_device/<DEVICE ID>'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"data":[{"ping_poll":"on","snmp_poll":"off"}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :put,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :put,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_device/<DEVICE ID>'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"data":[{"ping_poll":"on","snmp_poll":"off"}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"


{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1623646976,
        "objects": [
            {
                "type": "cdt_device",
                "sequence": 1,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 1,
                "data": [
                    {
                        "name": "Houston-swt1",
                        "id": <DEVICE ID>,
                        "community": "public",
                        "ipaddress": "10.100.47.253",
                        "snmp_version": 2,
                        "poll": "off",
                        "ping_poll": "on"
                    }
                ]
            }
        ]
    }
}

[top]

Example: Returning Details on all Ping-Only Devices

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/cdt_device/?fields=name,ipaddress,sysLocation,snmp_poll,ping_poll&snmp_poll_filter=IS(%27off%27)&ping_poll_filter=IS(%27on%27)" 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_device'
# specify fields to be returned
query += '/?fields=name,ipaddress,sysLocation,snmp_poll,ping_poll'
# Filters
query += '&snmp_poll_filter=IS("off")&ping_poll_filter=IS("on")'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + '/' + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker >= v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + '/' + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_device'
# specify fields to be returned
$query += '/?fields=name,ipaddress,sysLocation,snmp_poll,ping_poll'
# Filters
$query += '&snmp_poll_filter=IS("off")&ping_poll_filter=IS("on")'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623647384,
      "objects":[
         {
            "type":"cdt_device",
            "sequence":1,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":2,
            "data":[
               {
                  "name":"Houston-swt1",
                  "ipaddress":"10.100.47.253",
                  "sysLocation":"Houston",
                  "snmp_poll":"off",
                  "ping_poll":"on",
                  "id":425
               },
			   {				  
				  "name":"Adelaide-swt1",
				  "ipaddress":"10.100.89.253",
				  "sysLocation":"Adelaide",
				  "snmp_poll":"off",
				  "ping_poll":"on",
				  "id":433
				}
            ]
         }
      ]
   }
}
[top]

Example: Requesting Ping Metrics for a Device

Return ping times for the last 15 minutes as well as the average ping trip time for that period.

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/cdt_device/cdt_device/<DEVICE ID>?fields=name,ping_rtt&ping_rtt_formats=avg,vals&ping_rtt_timefilter=range%3Dnow%20-%2015m%20TO%20now%20-1m" 



# import requests for handling connection and encoding
import requests, json
# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_device/<DEVICE ID>'
# specify fields to be returned
query += '/?fields=name,ping_rtt'
# specify data formats
query += '&ping_rtt_formats=avg,vals'
# Filters
query += '&ping_rtt_timefilter=range%3Dnow%20-%2015m%20TO%20now%20-1m'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_device/<DEVICE ID>'
# specify fields to be returned
$query += '/?fields=name,ping_rtt'
# specify data formats
$query += '&ping_rtt_formats=avg,vals'
# Filters
$query += '&ping_rtt_timefilter=range%3Dnow%20-%2015m%20TO%20now%20-1m'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"



{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623648677,
      "objects":[
         {
            "type":"cdt_device",
            "sequence":1,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":1,
            "data":[
               {
                  "name":"Houston-rtr",
                  "ping_rtt":{
                     "vals":[
                        23,
                        28,
                        30,
                        26,
                        32,
                        21,
                        28,
                        27,
                        26,
                        25,
                        30,
                        27,
                        30,
                        27
                     ],
                     "avg":27.1429
                  },
                  "id":<DEVICE ID>
               }
            ]
         }
      ]
   }
}
[top]

Example: Return Ping Availability Percentage for a group of devices, during business hours last month

Show the ping availability for each device in a specified group during business hours (6am – 6pm) over the previous month

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/cdt_device?fields=name,ipaddress,ping_state&ping_state_formats=avl_inPercent&ping_state_filter_format=state&ping_state_timefilter=range=start_of_last_month%20to%20end_of_last_month;%20time%20=%2006:00%20to%2018:00;&ping_state_states=up&groups=<GROUP NAME>&links=none&indent=3" 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_device'
# specify fields to be returned
query += '/?fields=name,ipaddress,ping_state'
# specify data formats
query += '&ping_state_formats=avl_inPercent'
# Filters
query += '&ping_state_filter_format=state&ping_state_states=up&groups=<GROUP NAME>&ping_state_timefilter=range=start_of_last_month to end_of_last_month;time = 06:00 to 18:00;'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_device/'
# specify fields to be returned
$query += '/?fields=name,ipaddress,ping_state'
# specify data formats
$query += '&ping_state_formats=avl_inPercent'
# Filters
$query += '&ping_state_filter_format=state&ping_state_states=up&groups=<GROUP NAME>&ping_state_timefilter=range=start_of_last_month to end_of_last_month; time = 06:00 to 18:00;'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"


{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1615862113,
        "objects": [
            {
                "type": "cdt_device",
                "sequence": 307,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 59,
                "data": [
                    {
                        "name": "NewYork-rtr",
                        "ipaddress": "10.100.44.254",
                        "ping_state": {
                            "avl_inPercent": 93.4969
                        },
                        "id": 175
                    },
                    {
                        "name": "Chicago-rtr",
                        "ipaddress": "10.100.46.254",
                        "ping_state": {
                            "avl_inPercent": 98.1472
                        },
                        "id": 195
                    },
                    {
                        "name": "Rome-rtr",
                        "ipaddress": "10.100.52.254",
                        "ping_state": {
                            "avl_inPercent": 96.6486
                        },
                        "id": 247
                    },
                    {
                        "name": "Paris-rtr",
                        "ipaddress": "10.100.53.254",
                        "ping_state": {
                            "avl_inPercent": 96.6329
                        },
                        "id": 260
                    },
                    {
                        "name": "Barcelona-rtr",
                        "ipaddress": "10.100.54.254",
                        "ping_state": {
                            "avl_inPercent": 97.481
                        },
                        "id": 269
                    },
                    {
                        "name": "Hamburg-rtr",
                        "ipaddress": "10.100.55.254",
                        "ping_state": {
                            "avl_inPercent": 97.6203
                        },
                        "id": 276
                    },
                    {
                        "name": "Budapest-rtr",
                        "ipaddress": "10.100.56.254",
                        "ping_state": {
                            "avl_inPercent": 91.905
                        },
                        "id": 284
                    },
                    {
                        "name": "Warsaw-rtr",
                        "ipaddress": "10.100.57.254",
                        "ping_state": {
                            "avl_inPercent": 97.7061
                        },
                        "id": 292
                    },
                    {
                        "name": "Istanbul-rtr",
                        "ipaddress": "10.100.61.254",
                        "ping_state": {
                            "avl_inPercent": 96.1347
                        },
                        "id": 313
                    },
                    {
                        "name": "Helsinki-rtr",
                        "ipaddress": "10.100.62.254",
                        "ping_state": {
                            "avl_inPercent": 96.4435
                        },
                        "id": 320
                    },
                    {
                        "name": "Lisbon-rtr",
                        "ipaddress": "10.100.64.254",
                        "ping_state": {
                            "avl_inPercent": 98.4008
                        },
                        "id": 331
                    },
                    {
                        "name": "Copenhagen-rtr",
                        "ipaddress": "10.100.66.254",
                        "ping_state": {
                            "avl_inPercent": 96.6578
                        },
                        "id": 341
                    },
                    {
                        "name": "Zurich-rtr",
                        "ipaddress": "10.100.67.254",
                        "ping_state": {
                            "avl_inPercent": 97.0897
                        },
                        "id": 346
                    },
                    {
                        "name": "Auckland-rtr",
                        "ipaddress": "10.100.68.254",
                        "ping_state": {
                            "avl_inPercent": 97.4721
                        },
                        "id": 350
                    },
                    {
                        "name": "Wellington-rtr",
                        "ipaddress": "10.100.69.254",
                        "ping_state": {
                            "avl_inPercent": 96.656
                        },
                        "id": 353
                    },
                    {
                        "name": "Shanghai-rtr",
                        "ipaddress": "10.100.71.254",
                        "ping_state": {
                            "avl_inPercent": 97.1329
                        },
                        "id": 358
                    },
                    {
                        "name": "Taipei-rtr",
                        "ipaddress": "10.100.72.254",
                        "ping_state": {
                            "avl_inPercent": 95.4515
                        },
                        "id": 361
                    },
                    {
                        "name": "Tokyo-rtr",
                        "ipaddress": "10.100.73.254",
                        "ping_state": {
                            "avl_inPercent": 96.988
                        },
                        "id": 364
                    },
                    {
                        "name": "Singapore-rtr",
                        "ipaddress": "10.100.75.254",
                        "ping_state": {
                            "avl_inPercent": 96.3195
                        },
                        "id": 370
                    },
                    {
                        "name": "Jakarta-rtr",
                        "ipaddress": "10.100.76.254",
                        "ping_state": {
                            "avl_inPercent": 96.5654
                        },
                        "id": 373
                    },
                    {
                        "name": "Manila-rtr",
                        "ipaddress": "10.100.77.254",
                        "ping_state": {
                            "avl_inPercent": 95.6723
                        },
                        "id": 378
                    },
                    {
                        "name": "KualaLumpur-rtr",
                        "ipaddress": "10.100.78.254",
                        "ping_state": {
                            "avl_inPercent": 96.1833
                        },
                        "id": 381
                    },
                    {
                        "name": "Delhi-rtr",
                        "ipaddress": "10.100.80.254",
                        "ping_state": {
                            "avl_inPercent": 97.6462
                        },
                        "id": 387
                    },
                    {
                        "name": "Mumbai-rtr",
                        "ipaddress": "10.100.81.254",
                        "ping_state": {
                            "avl_inPercent": 96.5621
                        },
                        "id": 390
                    },
                    {
                        "name": "Bangalore-rtr",
                        "ipaddress": "10.100.82.254",
                        "ping_state": {
                            "avl_inPercent": 93.9592
                        },
                        "id": 393
                    },
                    {
                        "name": "Chennai-rtr",
                        "ipaddress": "10.100.84.254",
                        "ping_state": {
                            "avl_inPercent": 94.9474
                        },
                        "id": 399
                    },
                    {
                        "name": "Brisbane-rtr",
                        "ipaddress": "10.100.86.254",
                        "ping_state": {
                            "avl_inPercent": 95.2075
                        },
                        "id": 405
                    },
                    {
                        "name": "Melbourne-rtr",
                        "ipaddress": "10.100.87.254",
                        "ping_state": {
                            "avl_inPercent": 96.4931
                        },
                        "id": 408
                    },
                    {
                        "name": "Perth-rtr",
                        "ipaddress": "10.100.88.254",
                        "ping_state": {
                            "avl_inPercent": 95.4568
                        },
                        "id": 411
                    },
                    {
                        "name": "Cairo-rtr",
                        "ipaddress": "10.100.90.254",
                        "ping_state": {
                            "avl_inPercent": 95.8718
                        },
                        "id": 417
                    },
                    {
                        "name": "Johannesburg-rtr",
                        "ipaddress": "10.100.91.254",
                        "ping_state": {
                            "avl_inPercent": 93.7854
                        },
                        "id": 420
                    },
                    {
                        "name": "PortElizabeth-rtr",
                        "ipaddress": "10.100.93.254",
                        "ping_state": {
                            "avl_inPercent": 94.4832
                        },
                        "id": 426
                    },
                    {
                        "name": "Pretoria-rtr",
                        "ipaddress": "10.100.94.254",
                        "ping_state": {
                            "avl_inPercent": 95.6376
                        },
                        "id": 432
                    },
                    {
                        "name": "LosAngeles-rtr",
                        "ipaddress": "10.100.45.254",
                        "ping_state": {
                            "avl_inPercent": 97.3842
                        },
                        "id": 21115
                    },
                    {
                        "name": "Athens-rtr",
                        "ipaddress": "10.100.59.254",
                        "ping_state": {
                            "avl_inPercent": 94.7204
                        },
                        "id": 21118
                    },
                    {
                        "name": "Dublin-rtr",
                        "ipaddress": "10.100.65.254",
                        "ping_state": {
                            "avl_inPercent": 96.4443
                        },
                        "id": 21121
                    },
                    {
                        "name": "Beijing-rtr",
                        "ipaddress": "10.100.70.254",
                        "ping_state": {
                            "avl_inPercent": 96.2173
                        },
                        "id": 21122
                    },
                    {
                        "name": "Houston-rtr",
                        "ipaddress": "10.100.47.254",
                        "ping_state": {
                            "avl_inPercent": 97.7115
                        },
                        "id": 26477
                    },
                    {
                        "name": "London-rtr",
                        "ipaddress": "10.100.49.254",
                        "ping_state": {
                            "avl_inPercent": 97.5155
                        },
                        "id": 26478
                    },
                    {
                        "name": "CapeTown-rtr",
                        "ipaddress": "10.100.92.254",
                        "ping_state": {
                            "avl_inPercent": 95.6713
                        },
                        "id": 26480
                    },
                    {
                        "name": "Kolkata-rtr",
                        "ipaddress": "10.100.83.254",
                        "ping_state": {
                            "avl_inPercent": 95.9105
                        },
                        "id": 54838
                    },
                    {
                        "name": "Adelaide-rtr",
                        "ipaddress": "10.100.89.254",
                        "ping_state": {
                            "avl_inPercent": 96.9231
                        },
                        "id": 55175
                    },
                    {
                        "name": "Berlin-rtr",
                        "ipaddress": "10.119.50.254",
                        "ping_state": {
                            "avl_inPercent": 96.1095
                        },
                        "id": 90353
                    },
                    {
                        "name": "Madrid-rtr",
                        "ipaddress": "10.119.51.254",
                        "ping_state": {
                            "avl_inPercent": 94.8712
                        },
                        "id": 90357
                    },
                    {
                        "name": "Vienna-rtr",
                        "ipaddress": "10.119.58.254",
                        "ping_state": {
                            "avl_inPercent": 96.621
                        },
                        "id": 90419
                    },
                    {
                        "name": "Stockholm-rtr",
                        "ipaddress": "10.119.63.254",
                        "ping_state": {
                            "avl_inPercent": 94.0744
                        },
                        "id": 90448
                    },
                    {
                        "name": "Bangkok-rtr",
                        "ipaddress": "10.119.79.254",
                        "ping_state": {
                            "avl_inPercent": 94.4871
                        },
                        "id": 90506
                    },
                    {
                        "name": "Phoenix-rtr",
                        "ipaddress": "10.100.48.254",
                        "ping_state": {
                            "avl_inPercent": 93.6085
                        },
                        "id": 158201
                    },
                    {
                        "name": "Seoul-rtr",
                        "ipaddress": "10.100.74.254",
                        "ping_state": {
                            "avl_inPercent": 93.8363
                        },
                        "id": 209909
                    },
                    {
                        "name": "Sydney-rtr",
                        "ipaddress": "10.100.85.254",
                        "ping_state": {
                            "avl_inPercent": 96.3044
                        },
                        "id": 209912
                    }
                ]
            }
        ]
    }
}
[top]

Example: Deleting Multiple Devices via IP Address

Delete multiple devices in a single call by filter the device list by ipaddress.

We will delete devices with ipaddress = 10.100.59.251, 10.100.59.251.

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X DELETE \
	"https://your.statseeker.server/api/v2.1/cdt_device/cdt_device/" 
	-d '{"fields":{"ipaddress":{"field":"ipaddress","filter":{"query":"IN(\"<IP ADDRESS 1>",\"<IP ADDRESS 2>\")"}}}}'
	

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.delete(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.delete(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_device'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"fields":{"ipaddress":{"field":"ipaddress","filter":{"query":"IN(\"<IP ADDRESS 1>\",\"<IP ADDRESS 2>\")"}}}})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :delete,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker at least v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :delete,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_device'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"fields":{"ipaddress":{"field":"ipaddress","filter":{"query":"IN(\'<IP ADDRESS 1>\',\'<IP ADDRESS 2>\')"}}}}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"



{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623649404
   }
}
[top]

Interface (cdt_port)

The cdt_port resource allows you to interact with the network interfaces being monitored by Statseeker.

The cdt_port object
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G, U The poll state of the entity

  • on
  • off
InBroadcastPkts Rx Bcast Pkts integer G Number of received broadcast packets
Timeseries Data: Stats, Formats & Options
InBroadcastPps Rx Bcast Pps float G Number of received broadcast packets per second
Timeseries Data: Stats, Formats & Options
InDiscards Rx Discards integer G Number of received discards
Timeseries Data: Stats, Formats & Options
InErrors Rx Errors integer G Number of received errors
Timeseries Data: Stats, Formats & Options
InMulticastPkts Rx Mcast Pkts integer G Number of received multicast packets
Timeseries Data: Stats, Formats & Options
InMulticastPps Rx Mcast Pps float G Number of received multicast packets per second
Timeseries Data: Stats, Formats & Options
InOctets Rx Bytes integer G Number of received bytes
Timeseries Data: Stats, Formats & Options
InOutBroadcastPkts Total Bcast Pkts integer G Combined Rx and Tx broadcast packets
Timeseries Data: Stats, Formats & Options
InOutDiscards Total Discards integer G Combined Rx and Tx Discards
Timeseries Data: Stats, Formats & Options
InOutErrors Total Errors integer G Combined Rx and Tx Errors
Timeseries Data: Stats, Formats & Options
InOutMulticastPkts Total Mcast Pkts integer G Combined Rx and Tx multicast packets
Timeseries Data: Stats, Formats & Options
InOutOctets Total Bytes integer G Combined Rx and Tx Bytes
Timeseries Data: Stats, Formats & Options
InOutSpeed Total Speed integer G Combined Rx and Tx Speed
InOutUcastPkts Total Ucast Pkts integer G Combined Rx and Tx unicast packets
Timeseries Data: Stats, Formats & Options
InUcastPkts Rx Ucast Pkts integer G Number of received unicast packets
Timeseries Data: Stats, Formats & Options
InUcastPps Rx Ucast Pps float G Number of received unicast packets per second
Timeseries Data: Stats, Formats & Options
OutBroadcastPkts Tx Bcast Pkts integer G Number of transmitted broadcast packets
Timeseries Data: Stats, Formats & Options
OutBroadcastPps Tx Bcast Pps float G Number of transmitted broadcast packets per second
Timeseries Data: Stats, Formats & Options
OutDiscards Tx Discards integer G Number of transmitted discards
Timeseries Data: Stats, Formats & Options
OutErrors Tx Errors integer G Number of transmitted errors
Timeseries Data: Stats, Formats & Options
OutMulticastPkts Tx Mcast Pkts integer G Number of transmitted multicast packets
Timeseries Data: Stats, Formats & Options
OutMulticastPps Tx Mcast Pps float G Number of transmitted multicast packets per second
Timeseries Data: Stats, Formats & Options
OutOctets Tx Bytes integer G Number of transmitted bytes
Timeseries Data: Stats, Formats & Options
OutUcastPkts Tx Ucast Pkts integer G Number of transmitted unicast packets
Timeseries Data: Stats, Formats & Options
OutUcastPps Tx Ucast Pps float G Number of transmitted unicast packets per second
Timeseries Data: Stats, Formats & Options
RxBps Rx Bps float G Received bits per second
Timeseries Data: Stats, Formats & Options
RxDiscardsPercent Rx Discards Percent float G Rx discards percentage
Timeseries Data: Stats, Formats & Options
RxErrorPercent Rx Errors Percent float G Rx errors percentage
Timeseries Data: Stats, Formats & Options
RxTxDiscardsPercent Total Discards Percent float G Total discards percentage
Timeseries Data: Stats, Formats & Options
RxTxErrorPercent Total Errors Percent float G Total errors percentage
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G Rx Utilization
Timeseries Data: Stats, Formats & Options
TxBps Tx Bps float G Transmitted bits per second
Timeseries Data: Stats, Formats & Options
TxDiscardsPercent Tx Discards Percent float G Tx discards percentage
Timeseries Data: Stats, Formats & Options
TxErrorPercent Tx Errors Percent float G Tx errors percentage
Timeseries Data: Stats, Formats & Options
TxUtil Tx Util float G Tx Utilization
Timeseries Data: Stats, Formats & Options
if90day if90day integer G, U Status of port usage over 90 days, one of:

  • 0
  • 1
ifAdminStatus ifAdminStatus string G, U The desired state of the interface, one of:

  • up
  • down
  • testing

Can be combined with an event format for event-based analytics, see Event Formats.

ifAlias Alias string G, U Interface Alias (ifAlias)
ifDescr Description string G, U Interface Description (ifDescr)
ifDuplex ifDuplex string G, U Interface Duplex, one of:

  • auto
  • half
  • full
  • unknown
ifInSpeed Rx Speed integer G, U Interface Input Speed (Statseeker custom attribute)
ifIndex ifIndex string G, U Interface Index (IF-MIB.ifIndex)
ifName ifName string G, U Interface Name (IF-MIB.ifName)
ifNonUnicast NUcast Polling string G, U NonUnicast Polling status of the port, one of:

  • on
  • off
  • global
ifOperStatus ifOperStatus string G, U Current operational status of port, one of:

  • dormant
  • down
  • lowerLayerDown
  • notPresent
  • testing
  • unknown
  • up

Can be combined with an event format for event-based analytics, see Event Formats.

ifOutSpeed Tx Speed integer G, U Interface Output Speed (Statseeker custom attribute)
ifPhysAddress PhysAddress string G, U Interface MAC Address (ifPhysAddress)
ifPoll ifPoll string G, U Polling status of the port, one of:

  • on
  • off
ifSpeed Speed integer G, U Interface Speed (based on ifSpeed or ifHighSpeed)
ifTitle Title string G, U Interface Title (Statseeker custom attribute – ifTitle)
ifType Type string G, U Interface Type, one of:

  • a12MppSwitch
  • aal2
  • aal5
  • actelisMetaLOOP
  • adsl
  • adsl2
  • adsl2plus
  • aflane8023
  • aflane8025
  • arap
  • arcnet
  • arcnetPlus
  • async
  • atm
  • atmbond
  • atmDxi
  • atmFuni
  • atmIma
  • atmLogical
  • atmRadio
  • atmSubInterface
  • atmVciEndPt
  • atmVirtual
  • aviciOpticalEther
  • basicISDN
  • bgppolicyaccounting
  • bridge
  • bsc
  • cblVectaStar
  • cctEmul
  • ces
  • channel
  • ciscoISLvlan
  • cnr
  • coffee
  • compositeLink
  • dcn
  • ddnX25
  • digitalPowerline
  • digitalWrapperOverheadChannel
  • dlsw
  • docsCableDownstream
  • docsCableMaclayer
  • docsCableMCmtsDownstream
  • docsCableUpstream
  • docsCableUpstreamChannel
  • ds0
  • ds0Bundle
  • ds1
  • ds1FDL
  • ds3
  • dtm
  • dvbAsiIn
  • dvbAsiOut
  • dvbRccDownstream
  • dvbRccMacLayer
  • dvbRccUpstream
  • e1
  • econet
  • eon
  • eplrs
  • escon
  • ethernet3Mbit
  • ethernetCsmacd
  • fast
  • fastEther
  • fastEtherFX
  • fcipLink
  • fddi
  • fibreChannel
  • frameRelay
  • frameRelayInterconnect
  • frameRelayMPI
  • frameRelayService
  • frDlciEndPt
  • frf16MfrBundle
  • frForward
  • g703at2mb
  • g703at64k
  • gfp
  • gigabitEthernet
  • gr303IDT
  • gr303RDT
  • gtp
  • h323Gatekeeper
  • h323Proxy
  • hdh1822
  • hdlc
  • hdsl2
  • hiperlan2
  • hippi
  • hippiInterface
  • homepna
  • hostPad
  • hssi
  • hyperchannel
  • ibm370parChan
  • idsl
  • ieee1394
  • ieee80211
  • ieee80212
  • ieee80216WMAN
  • ieee8023adLag
  • if-gsn
  • imt
  • infiniband
  • interleave
  • ip
  • ipForward
  • ipOverAtm
  • ipOverCdlc
  • ipOverClaw
  • ipSwitch
  • isdn
  • isdns
  • isdnu
  • iso88022llc
  • iso88023Csmacd
  • iso88024TokenBus
  • iso88025CRFPInt
  • iso88025Dtr
  • iso88025Fiber
  • iso88025TokenRing
  • iso88026Man
  • isup
  • l2vlan
  • l3ipvlan
  • l3ipxvlan
  • lapb
  • lapd
  • lapf
  • linegroup
  • lmp
  • localTalk
  • macSecControlledIF
  • macSecUncontrolledIF
  • mediaMailOverIp
  • mfSigLink
  • miox25
  • mocaVersion1
  • modem
  • mpc
  • mpegTransport
  • mpls
  • mplsTunnel
  • msdsl
  • mvl
  • myrinet
  • nfas
  • nsip
  • opticalChannel
  • opticalChannelGroup
  • opticalTransport
  • other
  • para
  • pdnEtherLoop1
  • pdnEtherLoop2
  • plc
  • pon155
  • pon622
  • pos
  • ppp
  • pppMultilinkBundle
  • primaryISDN
  • propAtm
  • propBWAp2Mp
  • propCnls
  • propDocsWirelessDownstream
  • propDocsWirelessMaclayer
  • propDocsWirelessUpstream
  • propMultiplexor
  • propPointToPointSerial
  • propVirtual
  • propWirelessP2P
  • proteon10Mbit
  • proteon80Mbit
  • q2931
  • qam
  • qllc
  • radioMAC
  • radsl
  • reachDSL
  • regular1822
  • rfc1483
  • rfc877x25
  • rpr
  • rs232
  • rsrb
  • sdlc
  • sdsl
  • shdsl
  • sip
  • sipSig
  • sipTg
  • sixToFour
  • slip
  • smdsDxi
  • smdsIcip
  • softwareLoopback
  • sonet
  • sonetOverheadChannel
  • sonetPath
  • sonetVT
  • srp
  • ss7SigLink
  • stackToStack
  • starLan
  • tdlc
  • teLink
  • termPad
  • tr008
  • trasnpHdlc
  • tunnel
  • ultra
  • usb
  • v11
  • v35
  • v36
  • v37
  • vdsl
  • virtualIpAddress
  • virtualTg
  • voiceDID
  • voiceEM
  • voiceEMFGD
  • voiceEncap
  • voiceFGDEANA
  • voiceFGDOS
  • voiceFXO
  • voiceFXS
  • voiceOverAtm
  • voiceOverCable
  • voiceOverFrameRelay
  • voiceOverIp
  • x213
  • x25huntGroup
  • x25mlp
  • x25ple
Links

This resource has links to the following:

Links

This resource has links to the following:

[top]

Example: Turning Off an Interface

In this example we will use the device and interface name to identify the interface and then update the polling status on the selected interface.

  • Start with a device name and an interface name, Use these to get the interface ID
  • Use the interface ID to update the polling status of the interface
cURLPythonRubyResponse

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
    -X GET \
	"https://your.statseeker.server/api/v2.1/cdt_port/?fields=name,cdt_device.name&name_filter=IS(%27<INTERFACE NAME>%27)&cdt_device.name_filter=IS(%27<DEVICE NAME>%27)&indent=3&links=none"
	
	
curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
    -X PUT \
	"https://your.statseeker.server/api/v2.1/cdt_port/<INTERFACE ID>/?indent=3"
    -d '{"data":[{%27poll%27:%27off%27}]}'
	

# import requests for handling connection and encoding
import requests
import json

def do_request(server, query, user, pword, reqType, data):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = getattr(requests,reqType)(url, headers=headers,  data=data, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = getattr(requests,reqType)(url, headers=headers, auth=(user, pword), data=data, verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_port'
# specify fields to be returned
query += '/?fields=name,cdt_device.name'
# Filters
query += '&name_filter=IS("<INTERFACE NAME>")&cdt_device.name_filter=IS("<DEVICE NAME>")'
# optional response formatting
query += '&indent=3&links=none'
# set request type
reqType = 'get'
data=''

# Run the request
resp = do_request(server, query, user, pword, reqType, data)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
    portId=str(resp.json()['data']['objects'][0]['data'][0]['id'])
    print("Interface ID: " + portId)
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# build next query
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_port/' + portId
# optional response formatting
query += '/?indent=3&links=none'
# update poll status to turn off polling
data = json.dumps({"data":[{"poll":"off"}]})
# set request type
reqType = 'put'
# Run the request
resp = do_request(server, query, user, pword, reqType, data)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqType, reqData)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => reqType,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqType, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword, reqType, reqData)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => reqType,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqType, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_port'
# specify fields to be returned
$query += '/?fields=name,cdt_device.name'
# Filters
$query += '&name_filter=IS("<INTERFACE NAME>")&cdt_device.name_filter=IS("<DEVICE NAME>")'
# optional response formatting
$query += '&indent=3&links=none'
$reqData = ''
# Set request type
$reqType = 'get'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqType, $reqData)
puts "#{resp.to_str}"
rData = JSON.parse(resp)
$p = rData['data']['objects'][0]['data'][0]['id']

# output interface ID to screen
puts "#{'interfaceID: ' + $p.to_s}"

# build next query
# API root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_port/' + $p.to_s
# specify fields to be returned
$query += '/?indent=3&links=none'
# update poll status to turn off polling
$reqData = '{"data":[{"poll":"off"}]}'
# set request type
$reqType = 'put'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqType, $reqData)
puts "#{resp.to_str}"


#This response includes some logging (preceding the response data object) which is only relevant to the Python and Ruby implementations
200
{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623655171,
      "objects":[
         {
            "type":"cdt_port",
            "sequence":5,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":1,
            "data":[
               {
                  "name":"<INTERFACE NAME>",
                  "cdt_device.name":"<DEVICE NAME>",
                  "id":<INTERFACE ID>"
               }
            ]
         }
      ]
   }
}
"Interface ID":<INTERFACE ID>"
200
{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623655172
   }
}

[top]

Example: Requesting Timeseries Data from all Interfaces on a Device

Request:

  • Identifying data: the name and ID of the interface
  • Timeseries data: total inbound/outbound discard percentage for the reporting period, minimum, average, and 95th percentile values for inbound/outbound utilization
  • Time filter of ‘start of the day until now’
  • Sort results on the average inbound utilization, descending
  • Filter the results to show only those interfaces on a specific device
cURLPythonRubyResponse

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
    -X GET \
	"https://your.statseeker.server/api/v2.1/cdt_port/?fields=deviceid,id,name,RxTxDiscardsPercent,TxUtil,RxUtil&RxUtil_sort=1,desc,avg&deviceid_filter=IS(%22<DEVICE ID>%22)&RxUtil_formats=95th,avg,min&TxUtil_formats=95th,avg,min&RxTxDiscardsPercent_formats=total&timefilter=range=start_of_today%20to%20now"
	
	
	

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_port'
# specify fields to be returned
query += '/?fields=deviceid,id,name,RxTxDiscardsPercent,TxUtil,RxUtil'
# specify data formats
query += '&formats=95th,avg,min&RxTxDiscardsPercent_formats=total'
# specify filters
query += '&deviceid_filter=IS("<DEVICE ID>")&timefilter=range=start_of_today to now'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_port'
# specify fields to be returned
$query += '/?fields=deviceid,id,name,RxTxDiscardsPercent,TxUtil,RxUtil'
# specify data formats
$query += '&formats=95th,avg,min&RxTxDiscardsPercent_formats=total'
# Filters
$query += '&timefilter=range=start_of_today to now&deviceid_filter=IS('<DEVICE ID>')'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"


{

    'version':'2.1',
    'revision':'11',
    'info':'The Statseeker RESTful API',
    'data':{
        'success':True,
        'errmsg':'ok',
        'time':1623714662,
        'objects':[
            {
                'type':'cdt_port',
                'sequence':11,
                'status':{
                    'success':True,
                    'errcode':0
                },
                'data_total':5,
                'data':[
                    {
                        'deviceid':<DEVICE ID>,
                        'id':5267,
                        'name':'Gi0/1',
                        'RxTxDiscardsPercent':{
                            'total':0
                        },
                        'TxUtil':{
                            'min':1.40207,
                            'avg':1.88639,
                            '95th':2.19703
                        },
                        'RxUtil':{
                            'min':1.27934,
                            'avg':1.87145,
                            '95th':2.11322
                        }
                    },
                    {
                        'deviceid':<DEVICE ID>,
                        'id':5268,
                        'name':'Gi0/2',
                        'RxTxDiscardsPercent':{
                            'total':0
                        },
                        'TxUtil':{
                            'min':1.20236,
                            'avg':1.9108,
                            '95th':2.26653
                        },
                        'RxUtil':{
                            'min':1.52055,
                            'avg':1.8971,
                            '95th':2.14601
                        }
                    },
                    {
                        'deviceid':<DEVICE ID>,
                        'id':5269,
                        'name':'Gi0/3',
                        'RxTxDiscardsPercent':{
                            'total':0.00919672
                        },
                        'TxUtil':{
                            'min':9.02538,
                            'avg':32.583,
                            '95th':71.7206
                        },
                        'RxUtil':{
                            'min':9.19671,
                            'avg':45.9247,
                            '95th':71.0976
                        }
                    },
                    {
                        'deviceid':<DEVICE ID>,
                        'id':5270,
                        'name':'Gi0/4',
                        'RxTxDiscardsPercent':{
                            'total':0
                        },
                        'TxUtil':{
                            'min':1.19819,
                            'avg':25.2168,
                            '95th':37.0137
                        },
                        'RxUtil':{
                            'min':0.948108,
                            'avg':23.3934,
                            '95th':37.0401
                        }
                    },
                    {
                        'deviceid':<DEVICE ID>,
                        'id':5271,
                        'name':'Gi0/5',
                        'RxTxDiscardsPercent':{
                            'total':0
                        },
                        'TxUtil':{
                            'min':0.833396,
                            'avg':0.933941,
                            '95th':0.950772
                        },
                        'RxUtil':{
                            'min':0.833468,
                            'avg':0.933937,
                            '95th':0.950873
                        }
                    }
                ]
            }
        ]
    }

}
[top]

Example: Return the 10 Most Congested Interfaces (inbound) over the Last 30mins
cURLPythonRubyResponse

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
    -X GET \
    'https://your.statseeker.server/api/v2.1/cdt_port/?fields=deviceid,id,name,RxUtil&RxUtil_formats=vals,avg&RxUtil_timefilter=range=now%20-%2030m%20to%20now%20-%201m&RxUtil_sort=1,desc,avg&limit=10&indent=3'	

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_port'
# specify fields to be returned
query += '/?fields=deviceid,id,name,RxUtil'
# specify data formats
query += '&RxUtil_formats=vals,avg'
# Filters and sorting
query += '&RxUtil_timefilter=range=now - 30m to now - 1m&limit=10&RxUtil_sort=1,desc,avg'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_port'
# specify fields to be returned
$query += '/?fields=deviceid,id,name,RxUtil'
# specify data formats
$query += '&RxUtil_formats=vals,avg'
# Filters and sorting
$query += '&RxUtil_timefilter=range=now - 30m to now - 1m&limit=10&RxUtil_sort=1,desc,avg'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623715763,
      "objects":[
         {
            "type":"cdt_port",
            "sequence":11,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":21178,
            "data":[
               {
                  "deviceid":666,
                  "id":25349,
                  "name":"int.673",
                  "RxUtil":{
                     "vals":[
                        58.412,
                        59.2569,
                        62.7188,
                        62.8199,
                        60.9338,
                        61.2049,
                        62.5076,
                        64.7656,
                        68.891,
                        74.0913,
                        76.311,
                        79.5807,
                        82.8285,
                        89.1304,
                        93.4463,
                        94.0603,
                        97.8606,
                        102.481,
                        108.23,
                        108.733,
                        109.634,
                        111.784,
                        110.537,
                        118.258,
                        120.432,
                        121.998,
                        124.984,
                        131.161,
                        129.887
                     ],
                     "avg":91.2737
                  }
               },
               {
                  "deviceid":576,
                  "id":14508,
                  "name":"Gi2/6",
                  "RxUtil":{
                     "vals":[
                        14.7061,
                        84.3344,
                        91.9828,
                        93.1667,
                        94.9071,
                        95.082,
                        94.8615,
                        91.9828,
                        94.6667,
                        95,
                        95.1452,
                        94.8721,
                        93.4828,
                        93.3333,
                        96.3333,
                        95.2404,
                        91.9404,
                        93.1525,
                        93.3333,
                        91.8333,
                        94.8118,
                        96.3663,
                        93.6552,
                        91.8333,
                        91.6667,
                        94.8118,
                        94.8721,
                        93.4828,
                        93.3333
                     ],
                     "avg":90.8341
                  }
               },
               {
                  "deviceid":607,
                  "id":19079,
                  "name":"Gi5/1",
                  "RxUtil":{
                     "vals":[
                        32.9511,
                        82.6984,
                        94.9561,
                        93.7022,
                        92.1038,
                        93.1148,
                        95.8307,
                        92.4708,
                        94.5127,
                        90.6501,
                        91.9098,
                        95.467,
                        95.2381,
                        95,
                        95.0683,
                        92.6169,
                        95.4101,
                        95.1675,
                        93.6635,
                        93.4426,
                        94.8462,
                        94.8999,
                        94.8992,
                        92.2081,
                        94.4444,
                        93.8757,
                        95.8758,
                        18.9708,
                        2.16111
                     ],
                     "avg":85.7985
                  }
               },
               {
                  "deviceid":560,
                  "id":12370,
                  "name":"Gi4/24",
                  "RxUtil":{
                     "vals":[
                        93.6138,
                        96.0178,
                        93.7018,
                        94.878,
                        95.082,
                        95.0123,
                        94.928,
                        94.9887,
                        95,
                        91.9887,
                        94.7371,
                        94.8776,
                        96.4521,
                        95.2669,
                        94.9375,
                        82.538,
                        13.7182,
                        1.89558,
                        null,
                        null,
                        null,
                        null,
                        null,
                        null,
                        null,
                        null,
                        null,
                        null,
                        null
                     ],
                     "avg":84.4241
                  }
               },
               {
                  "deviceid":572,
                  "id":14061,
                  "name":"Gi1/16",
                  "RxUtil":{
                     "vals":[
                        94.9785,
                        94.8721,
                        91.9828,
                        93.1667,
                        94.9071,
                        95.082,
                        94.8615,
                        91.9828,
                        94.6667,
                        95,
                        95.1452,
                        94.8721,
                        94.9828,
                        93.5,
                        93.2316,
                        93.521,
                        91.7614,
                        93.1525,
                        94.8333,
                        92,
                        94.8118,
                        96.3663,
                        93.6552,
                        60.9933,
                        7.39,
                        1.83817,
                        1.91872,
                        1.8731,
                        1.86667
                     ],
                     "avg":77.2143
                  }
               },
               {
                  "deviceid":591,
                  "id":17044,
                  "name":"Gi6/20",
                  "RxUtil":{
                     "vals":[
                        1.87849,
                        36.1878,
                        87.6018,
                        93.6762,
                        94.8087,
                        95.082,
                        96.2094,
                        93.8999,
                        94.7404,
                        93.517,
                        93.6706,
                        95.8482,
                        95.2143,
                        95.0697,
                        95.0137,
                        92.5529,
                        95.5319,
                        95.1779,
                        93.5706,
                        93.3333,
                        94.9524,
                        94.9097,
                        96.3131,
                        95.2415,
                        93.5833,
                        22.1281,
                        3.58259,
                        1.87595,
                        1.895
                     ],
                     "avg":77.1402
                  }
               },
               {
                  "deviceid":92491,
                  "id":93714,
                  "name":"Gi5/21",
                  "RxUtil":{
                     "vals":[
                        75.9317,
                        76.1367,
                        75.4496,
                        74.7143,
                        74.1968,
                        75.9783,
                        76.6457,
                        76.8767,
                        76.9577,
                        76.8083,
                        76.3996,
                        76.9991,
                        77.3082,
                        76.5974,
                        75.1579,
                        74.208,
                        75.7776,
                        74.1712,
                        75.5847,
                        76.9485,
                        73.8196,
                        73.5756,
                        74.4403,
                        73.1962,
                        73.1154,
                        70.7376,
                        71.3308,
                        74.8943,
                        76.6727
                     ],
                     "avg":75.1942
                  }
               },
               {
                  "deviceid":468,
                  "id":7245,
                  "name":"Gi0/4",
                  "RxUtil":{
                     "vals":[
                        74.404,
                        74.1828,
                        76.5702,
                        77.0775,
                        77.3333,
                        75.5785,
                        73.5372,
                        74.079,
                        74.8937,
                        73.9347,
                        72.175,
                        73.2957,
                        72.9874,
                        76.0928,
                        76.1607,
                        74.4128,
                        74.838,
                        75.9916,
                        77.3333,
                        77.2873,
                        74.482,
                        72.616,
                        74.6077,
                        73.5125,
                        71.4153,
                        70.4813,
                        76.5989,
                        77.155,
                        74.8029
                     ],
                     "avg":74.753
                  }
               },
               {
                  "deviceid":542,
                  "id":11260,
                  "name":"Gi2/20",
                  "RxUtil":{
                     "vals":[
                        95.1452,
                        94.9481,
                        93.4181,
                        94.8958,
                        93.6339,
                        94.7923,
                        93.3563,
                        91.9333,
                        94.6271,
                        93.428,
                        94.9672,
                        94.8721,
                        94.9828,
                        93.5984,
                        94.7434,
                        95.1367,
                        93.3778,
                        93.3103,
                        96.3333,
                        93.6667,
                        94.9785,
                        94.9481,
                        62.6062,
                        7.5439,
                        1.87197,
                        1.89782,
                        1.86734,
                        1.83621,
                        1.89333
                     ],
                     "avg":74.2969
                  }
               },
               {
                  "deviceid":603,
                  "id":18345,
                  "name":"Gi3/11",
                  "RxUtil":{
                     "vals":[
                        75.2432,
                        76.9031,
                        74.3828,
                        73.5258,
                        73.8093,
                        74.4585,
                        75.7062,
                        73.6734,
                        74.6045,
                        74.9261,
                        73.7239,
                        74.2233,
                        75.8226,
                        75.2778,
                        74.8531,
                        76.0055,
                        74.3657,
                        75.7361,
                        73.3104,
                        70.7072,
                        72.137,
                        71.5355,
                        75.3817,
                        72.7648,
                        72.9251,
                        73.4308,
                        72.6468,
                        73.2978,
                        72.2705
                     ],
                     "avg":74.0568
                  }
               }
            ]
         }
      ]
   }
}
[top]

Example: Return the 10 Busiest Interfaces, According to their 90th Percentile Values, over the Last Hour

We are returning the deviceid and interface name to identify the interface.

cURLPythonRubyResponse

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
    -X GET \
	"https://your.statseeker.server/api/v2.1/cdt_port/?fields=cdt_device.name,name,RxUtil,InOctets&timefilter=range=now%20-%201h%20to%20now&RxUtil_formats=avg,max&InOctets_formats=percentile&InOctets_stats=%7B%22percentile%22:90%7D&InOctets_sort=1,desc,percentile&limit=10&indent=3&links=none"

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker at least v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker not v5.5.4 or higher), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_port'
# specify fields to be returned
query += '?fields=cdt_device.name,name,RxUtil,InOctets'
# specify data formats
query += '&RxUtil_formats=avg,max&InOctets_formats=percentile&InOctets_stats={%22percentile%22:90}'
# Filters and sorting
query += '&timefilter=range=now -1h to now&InOctets_sort=1,desc,percentile&limit=10'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker not v5.5.4 or higher
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker at least v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_port'
# specify fields to be returned
$query += '/?fields=cdt_device.name,name,RxUtil,InOctets'
# specify data formats
$query += '&RxUtil_formats=avg,max&InOctets_formats=percentile&InOctets_stats={"percentile":90}'
# Filters and sorting
$query += '&timefilter=range=now -1h to now&InOctets_sort=1,desc,percentile&limit=10'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623720470,
      "objects":[
         {
            "type":"cdt_port",
            "sequence":11,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":21178,
            "data":[
               {
                  "cdt_device.name":"R-GMM-AGG-07",
                  "name":"Po15",
                  "RxUtil":{
                     "max":15.4582,
                     "avg":13.5477
                  },
                  "InOctets":{
                     "percentile":112727000000.0
                  },
                  "id":28487
               },
               {
                  "cdt_device.name":"R-GMM-AGG-07",
                  "name":"Tu2924",
                  "RxUtil":{
                     "max":7.72051,
                     "avg":6.92405
                  },
                  "InOctets":{
                     "percentile":57139800000.0
                  },
                  "id":28512
               },
               {
                  "cdt_device.name":"R-GMM-AGG-07",
                  "name":"Tu3937",
                  "RxUtil":{
                     "max":7.71764,
                     "avg":6.82324
                  },
                  "InOctets":{
                     "percentile":54429300000.0
                  },
                  "id":28563
               },
               {
                  "cdt_device.name":"R-GMM-AGG-07",
                  "name":"Tu2942",
                  "RxUtil":{
                     "max":7.61665,
                     "avg":5.65903
                  },
                  "InOctets":{
                     "percentile":53692000000.0
                  },
                  "id":28528
               },
               {
                  "cdt_device.name":"R-GMM-AGG-07",
                  "name":"Tu2912",
                  "RxUtil":{
                     "max":4.5065,
                     "avg":3.86295
                  },
                  "InOctets":{
                     "percentile":32249500000.0
                  },
                  "id":28504
               },
               {
                  "cdt_device.name":"CDT-IP-Interface-Stats",
                  "name":"Ethernet3/30",
                  "RxUtil":{
                     "max":38.799,
                     "avg":35.7174
                  },
                  "InOctets":{
                     "percentile":28524500000.0
                  },
                  "id":25042
               },
               {
                  "cdt_device.name":"CDT-IP-Interface-Stats",
                  "name":"Ethernet3/27",
                  "RxUtil":{
                     "max":38.9375,
                     "avg":34.1723
                  },
                  "InOctets":{
                     "percentile":28171200000.0
                  },
                  "id":25038
               },
               {
                  "cdt_device.name":"R-GMM-AGG-07",
                  "name":"Tu3936",
                  "RxUtil":{
                     "max":3.8409,
                     "avg":3.41211
                  },
                  "InOctets":{
                     "percentile":27906200000.0
                  },
                  "id":28562
               },
               {
                  "cdt_device.name":"CDT-IP-Interface-Stats",
                  "name":"Ethernet3/18",
                  "RxUtil":{
                     "max":38.4306,
                     "avg":35.0934
                  },
                  "InOctets":{
                     "percentile":27854000000.0
                  },
                  "id":25028
               },
               {
                  "cdt_device.name":"CDT-IP-Interface-Stats",
                  "name":"Ethernet3/11",
                  "RxUtil":{
                     "max":35.2323,
                     "avg":28.6036
                  },
                  "InOctets":{
                     "percentile":25326800000.0
                  },
                  "id":25021
               }
            ]
         }
      ]
   }
}
[top]

Example: Return the Inbound Traffic 90th Percentile for the Last Hour on a specific Interface

cURLPythonRubyResponse

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
    -X GET \
    "https://your.statseeker.server/api/v2.1/cdt_port/<INTERFACE ID>/RxUtil?timefilter=range=%20now%20-%201h%20to%20now&formats=percentile&stats=%7B%22percentile%22:90%7D&links=none&indent=3"
	

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker <  v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_port/<INTERFACE ID>/RxUtil'
# specify data formats
query += '/?formats=percentile&stats={"percentile":90}'
# Filters
query += '&timefilter=range=now -1h to now'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')


# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker >= v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_port/<INTERFACE ID>/RxUtil'
# specify data formats
$query += '/?formats=percentile&stats={"percentile":90}'
# Filters
$query += '&timefilter=range=now -1h to now'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{

    'version':'2.1',
    'revision':'11',
    'info':'The Statseeker RESTful API',
    'data':{
        'success':True,
        'errmsg':'ok',
        'time':1623730579,
        'objects':[
            {
                'type':'cdt_port',
                'sequence':11,
                'status':{
                    'success':True,
                    'errcode':0
                },
                'data_total':1,
                'data':[
                    {
                        'RxUtil':{
                            'percentile':96.375
                        },
                        'id':<INTERFACE ID>
                    }
                ]
            }
        ]
    }

}
[top]

Example: Return traffic rate metrics for an interface, during business hours on a specific date

We are:

  • Filtering to a specified interface on a specified device
  • Restricting the response to between 6am – 6pm, on March 5th 2020
cURLPythonRubyResponse

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
    -X GET \
	'https://your.statseeker.server/api/v2.1/cdt_port?fields=name,deviceid,cdt_device.name,ifAlias,ifDescr,RxBps&name_filter=IS("<INTERFACE NAME>")&cdt_device.name_filter=IS("<DEVICE NAME>")&formats=95th,median,avg&timefilter=range=2020-03-05 to 2020-03-06;time=08:00 to 18:00&indent=3&links=none'	
	

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (Statseeker <  v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/cdt_port'
# specify fields to be returned
query += '/?fields=name,deviceid,cdt_device.name,ifAlias,ifDescr,RxBps'
# specify data formats
query += '&formats=95th,median,avg'
# Filters
query += '&name_filter=IS(%22<INTERFACE NAME>%22)&cdt_device.name_filter=IS(%22<DEVICE NAME>%22)&timefilter=range=2020-03-05 to 2020-03-06;time=08:00 to 18:00'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker >= v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/cdt_port'
# specify fields to be returned
$query += '/?fields=name,deviceid,cdt_device.name,ifAlias,ifDescr,RxBps'
# specify data formats
$query += '&formats=95th,median,avg'
# Filters
$query += '&name_filter=IS("<INTERFACE NAME>")&cdt_device.name_filter=IS("<DEVICE NAME>")&timefilter=range=2020-03-05 to 2020-03-06;time=08:00 to 18:00'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1615501619,
        "objects": [
            {
                "type": "cdt_port",
                "sequence": 1,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 1,
                "data": [
                    {
                        "name": "<INTERFACE NAME>",
                        "deviceid": 26478,
                        "cdt_device.name": "<DEVICE NAME>",
                        "ifAlias": "Link to SanJose-core",
                        "ifDescr": "GigabitEthernet0/1",
                        "RxBps": {
                            "avg": 19653900.0,
                            "median": 19410600.0,
                            "95th": 23579900.0
                        }
						"id": 26486,
                    }
                ]
            }
        ]
    }
}
[top]

Group

The group resource allows you to create and populate the groups used by Statseeker for reporting, and for authorization when restricting visibility and access to functionality for users within Statseeker.

The group object
Field ID Field Title Type Get, Add, Update Description
entities Entities object G, U The entities that are assigned to this group

Formats Description
count Number of entities assigned to the group
exc_count Number of entities assigned to the group (excluding child entities not explicitly assigned)
exc_hexstr Hex bitstring representation of assigned entities (excluding child entities not explicitly assigned)
exc_list Array of entity ids assigned to the group (excluding child entities not explicitly assigned)
hexstr Hex bitstring representation of assigned entities
list Array of entity ids assigned to the group
objects Array of object names that have entities assigned to the group
id ID integer G ID of the group
name Name string G, A (required), U Name of the group


Group Mode

The Group object requires a mode be specified when performing PUT requests to make changes to the group’s members (entities). The mode specifies what the API should do with the entities when making changes.

Mode Description
clear Remove the specified entities from the group
set Remove all existing entities and then add the specified entities to the group
add Add the specified entities to the group

[top]

Example: Create a Group

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X POST \
	"https://your.statseeker.server/api/v2.1/group/?indent=3" \
	-d '{"data":[{"name":"<GROUP NAME>"}]}'

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.post(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (or Statseeker < v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.post(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/group'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"data":[{"name":"<GROUP NAME>"}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :post,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker >= v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :post,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"data":[{"name":"<GROUP NAME>"}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"

{
   "version":"2.1",
   "revision":"11",
   "info":"The Statseeker RESTful API",
   "data":{
      "success":true,
      "errmsg":"ok",
      "time":1623731624,
      "objects":[
         {
            "type":"group",
            "sequence":8,
            "status":{
               "success":true,
               "errcode":0
            },
            "data_total":1,
            "data":[
               {
                  "name":"<GROUP NAME>",
                  "id":94551
               }
            ]
         }
      ]
   }
}
[top]

Example: Populate a Group

When populating a group you use the /entities field endpoint and must specify a mode instructing the API on how to populate the group.

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X PUT \
	"https://your.statseeker.server/api/v2.1/group/<GROUP ID>/entities/?indent=3" \
	-d '{"value":[286,287,288,289,290,291,292,293],"mode":"add"}'

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.put(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (or Statseeker < v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.put(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += 'group/<GROUP ID>/entities'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"value":[286,287,288,289,290,291,292,293],"mode":"add"})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :put,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker >= v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :put,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group/<GROUP ID>/entities'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"value":[286,287,288,289,290,291,292,293],"mode":"add"}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"

{
   "info":"The Statseeker RESTful API",
   "data":{
      "errmsg":"ok",
      "success":true,
      "time":1496200162
   },
   "links":[
      {
         "link":"/api/v2.1/group/<GROUP ID>/entities?&indent=3",
         "rel":"self"
      },
      {
         "link":"/api/v2.1",
         "rel":"base"
      },
      {
         "link":"/api/v2.1/group/<GROUP ID>",
         "rel":"collection"
      }
   ],
   "api_version":"2.1"
}
[top]

Example: Deleting a Group

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X DELETE \
	"https://your.statseeker.server/api/v2.1/group/<GROUP ID>/?indent=3&links=none" 

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.delete(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (or Statseeker < v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.delete(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += 'group/<GROUP ID>'
# optional response formatting
query += '/?indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :delete,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker >= v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :delete,
			:url => url,
			:headers => headers,
			:verify_ssl => false
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group/<GROUP ID>'
# optional response formatting
$query += '/?indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496200297
  },
  "api_version": "2.1"
}
[top]

Example: Which Groups contain a specific entity (device, interface, user, etc.)

Return details on all groups containing a specified device.

Note: the id is returned in the response of any request which returns the device. Simply send a GET to the /api/v2.1/cdt_device resource-level endpoint (filtering by the device name) to retrieve the id.
cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	"https://your.statseeker.server/api/v2.1/group/?fields=id,name,entities&entities_formats=count&entities_filter==<DEVICE ID>&entities_filter_format=list

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (or Statseeker < v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/group'
# specify fields to be returned
query += '/?fields=id,name,entities'
# specify data formats
query += '&entities_formats=count'
# Filters
query += '&entities_filter==<DEVICE ID>&entities_filter_format=list'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}') 

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker >= v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/group'
# specify fields to be returned
$query += '/?fields=id,name,entities'
# specify data formats
$query += '&entities_formats=count'
# Filters
$query += '&entities_filter==<DEVICE ID>&entities_filter_format=list'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
    "version": "2.1",
    "revision": "11",
    "info": "The Statseeker RESTful API",
    "data": {
        "success": true,
        "errmsg": "ok",
        "time": 1615841935,
        "objects": [
            {
                "type": "group",
                "sequence": 9,
                "status": {
                    "success": true,
                    "errcode": 0
                },
                "data_total": 5,
                "data": [
                    {
                        "id": 156472,
                        "name": "10.100.*.*",
                        "entities": {
                            "count": 51173
                        }
                    },
                    {
                        "id": 156893,
                        "name": "US Hardware",
                        "entities": {
                            "count": 12044
                        }
                    },
                    {
                        "id": 233023,
                        "name": "Switches",
                        "entities": {
                            "count": 58583
                        }
                    },
                    {
                        "id": 233024,
                        "name": "Chicago",
                        "entities": {
                            "count": 2347
                        }
                    },
                    {
                        "id": 233025,
                        "name": "Chicago Switches",
                        "entities": {
                            "count": 1985
                        }
                    }
                ]
            }
        ]
    }
}
[top]

Discovery Configuration

The discover_config resource allows you to configure Statseeker’s discovery process.

The discover_config Object
An array of Discover Configuration objects associated to IP Address Ranges. Each configuration in the array contains the following fields:

Field ID Field Title Type Get, Add, Update Description
communities Community Strings object G, U Comma separated SNMPv1 and SNMPv2 community strings
id ID integer G Discover config identifier/key
iftype Interface Types object G, U Comma separated list of interface types to include
ip_range_configurations Per IP Address Range Configuration object G, U An array of Discover Configuration objects associated to IP Address Ranges. Each configuration in the array contains the following fields:

Field ID Type Description
communities string Comma separated SNMPv1 and SNMPv2 community strings
enabled boolean Set the range configuration to be enabled/disabled
excludes string Comma separated sysdescr strings for entities to exclude from the configuration
iftypes string Comma separated iftypes strings for entities to include in the configuration
includes string Comma separated sysdescr strings for entities to include in the configuration
ip_range_text string Include range string specifying the IP range to be covered by the configuration
title string Name for the configuration rule

These configurations are in addition to the global discovery settings for the IP range specified in ranges. This allows you to apply specific include/exclude rules based on sysDescr and iftype to select IP ranges, and to restrict which community strings are sent to a given IP.

Note: community strings, and include/exclude rules, added in this way are in addition to the global rules, they do not replace the global rules. All exclude rules take precedence over any include rule.
ping_count Ping Run Count integer G, U Number of passes for the ping discover
ping_skip Ping Skip integer G, U Number of ipaddress to skip between each ping
ranges Ranges object G, U Comma separated discover ranges (using include/exclude syntax)
sysdescr SysDescr object G, U Comma separated SysDescr values to decide which devices to discover
ping_rate Ping Rate integer G, U Number of pings to send per second


Example: Updating the IP Ranges to be used during Discovery

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X PUT \
	"https://your.statseeker.server/api/v2.1/discover_config/1?indent=3" \
	-d "{"data":[{"ranges":["include 10.100.0.0/16","exclude 10.100.[50-100].*","include 10.101.0.0/16","include 10.116.0.0/16"]}]}"

# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword, reqData):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.put(url, headers=headers, verify=False, data=reqData)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (or Statseeker < v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.put(url, headers=headers, auth=(user, pword), verify=False, data=reqData)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/discover_config/1'
# optional response formatting
query += '/?indent=3&links=none'
# data
reqData = json.dumps({"data":[{"ranges":["include 10.100.0.0/16","exclude 10.100.[50-100].*","include 10.101.0.0/16","include 10.116.0.0/16"]}]})
# Run the request
resp = do_request(server, query, user, pword, reqData)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword, reqData)
	headers = {
		:content_type => "application/json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :put,
		:url => url,
		:headers => headers,
		:verify_ssl => false,
		:payload => reqData
	)
end

def do_request(server, query, user, pword, reqData)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword, reqData)
    else		
        # Authentication successful. Statseeker >= v5.5.4
		headers = {
		:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
			:method => :put,
			:url => url,
			:headers => headers,
			:verify_ssl => false,
			:payload => reqData
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword, reqData)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/discover_config/1'
# optional response formatting
$query += '/?indent=3&links=none'
# configure payload
$reqData = '{"data":[{"ranges":["include 10.100.0.0/16","exclude 10.100.[50-100].*","include 10.101.0.0/16","include 10.116.0.0/16"]}]}'
# Run the request
resp = do_request($server, $query, $user, $pword, $reqData)
puts "#{resp.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496200675
  },
  "api_version": "2.1"
}
[top]

Syslog

The syslog resource provides access to the syslog messages collected by Statseeker. The contents of these records can be reported on and used to trigger alerts.

The syslog Object
Field ID Field Title Type Get, Add, Update Description
entity Entity string G The name of the entity that owns this message
entityid Entity ID integer G, A (required) The ID of the entity that owns this message
id ID integer G Message Identifier
text Message Text string G, A (required) The message text
time Time integer G Message Time
type Type string G, A (required) Message Type
Options
  • lastx – Display the last x records, rather than using a timefilter
Links

This resource has links to the following:

[top]

Example: Retrieving details, from Syslog Records, on devices that ‘went down’ in the previous 24hrs

In this example we will retrieve details on all Syslog messages that contain a specified string, in the previous 24h hours.

cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	-u user:pword "https://your.statseeker.server/api/v2.1/syslog/?indent=3&links=none&fields=entity,entityid,text,type,time&text_filter=LIKE(%22<FILTER STRING>%22)&time_timefilter=range%20=%20now%20-%201d%20to%20now"


# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (or Statseeker < v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/syslog'
# specify fields to be returned
query += '/?fields=entity,entityid,text,type,time'
# Filters
query += '&text_filter=LIKE("<FILTER STRING>")&time_timefilter=range = now - 1d to now'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker >= v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/syslog'
# specify fields to be returned
$query += '/?fields=entity,entityid,text,type,time'
# Filters
$query += '&text_filter=LIKE("<FILTER STRING>")&time_timefilter=range = now - 1d to now'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts '#{resp.to_str}'

{
	"info": "The Statseeker RESTful API",
	"data": {
		"objects": [{
			"status": {
				"errcode": 0,
				"success": true
			},
			"data": [{
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/10, changed state to down",
				"entity": "LosAngeles-swt1",
				"time": 1490240152,
				"entityid": 174,
				"type": "syslog",
				"id": 126619
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/7, changed state to down",
				"entity": "Helsinki-swt1",
				"time": 1490245557,
				"entityid": 313,
				"type": "syslog",
				"id": 126626
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet1/0/12, changed state to down",
				"entity": "CapeTown-swt2",
				"time": 1490246759,
				"entityid": 412,
				"type": "syslog",
				"id": 126628
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/18, changed state to down",
				"entity": "Mumbai-swt2",
				"time": 1490251556,
				"entityid": 379,
				"type": "syslog",
				"id": 126631
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/19, changed state to down",
				"entity": "Unknown (10.100.52.25)",
				"time": 1490270147,
				"entityid": 0,
				"type": "syslog",
				"id": 126641
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/24, changed state to down",
				"entity": "Budapest-swt4",
				"time": 1490271059,
				"entityid": 271,
				"type": "syslog",
				"id": 126642
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/18, changed state to down",
				"entity": "Phoenix-swt4",
				"time": 1490271643,
				"entityid": 201,
				"type": "syslog",
				"id": 126643
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/7, changed state to down",
				"entity": "Bangkok-swt1",
				"time": 1490279033,
				"entityid": 374,
				"type": "syslog",
				"id": 126647
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/20, changed state to down",
				"entity": "Unknown (10.100.52.25)",
				"time": 1490286824,
				"entityid": 0,
				"type": "syslog",
				"id": 126652
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet2/0/16, changed state to down",
				"entity": "Chicago-rtr",
				"time": 1490294444,
				"entityid": 185,
				"type": "syslog",
				"id": 126657
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/8, changed state to down",
				"entity": "Tokyo-swt1",
				"time": 1490301348,
				"entityid": 355,
				"type": "syslog",
				"id": 126661
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/8, changed state to down",
				"entity": "LosAngeles-rtr",
				"time": 1490305548,
				"entityid": 175,
				"type": "syslog",
				"id": 126664
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/18, changed state to down",
				"entity": "Helsinki-swt3",
				"time": 1490307644,
				"entityid": 311,
				"type": "syslog",
				"id": 126667
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/14, changed state to down",
				"entity": "Athens-rtr",
				"time": 1490316041,
				"entityid": 299,
				"type": "syslog",
				"id": 126671
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/28, changed state to down",
				"entity": "Melbourne-swt2",
				"time": 1490316942,
				"entityid": 397,
				"type": "syslog",
				"id": 126672
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/11, changed state to down",
				"entity": "Chicago-swt2",
				"time": 1490317855,
				"entityid": 183,
				"type": "syslog",
				"id": 126673
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet3/0/5, changed state to down",
				"entity": "Copenhagen-swt3",
				"time": 1490318756,
				"entityid": 331,
				"type": "syslog",
				"id": 126674
			}],
			"type": "syslog",
			"data_total": 17
		}],
		"errmsg": "ok",
		"success": true,
		"time": 1490325593
	},
	"api_version": "2.1"
}
[top]

Device and Interface Event Records (event_record)

The event_record resource provides access to the device and interface events recorded by Statseeker. The contents of these records can be reported on and used to trigger alerts.

The event_record Object
Field ID Field Title Type Get, Add, Update Description
delta Delta integer G The number of seconds since the last record of the same event
device Device string G The name of the device that owns the entity
deviceid Device ID integer G The ID of the device that owns the entity
entity Entity string G The name of the entity that owns the event
entityid Entity ID integer G, A The ID of the entity that owns the entity
entityTypeName Entity Type Name string G The name of the type of entity that owns the event
entityTypeTitle Entity Type Title string G The title of the type of entity that owns the event
event Event string G, A The event text associated to the record
eventid Event ID integer G, A (required) The event id associated to the record
id ID string G Event Record Identifier
note Note string G, U The note associated with the record
state State string G, A (required) The state text associated to the record
stateid State ID integer G, A The state id associated to the record
time Time integer G, A Epoch time that the record was created
Options
  • lastx – Display the last x records, rather than using a timefilter
Links

This resource has links to the following:

[top]

Example: Retrieving details, from Event Records, of interfaces that recovered from a ‘down’ state in the previous 3hrs

The delta value, found in each record in the response, details the duration that the interface was in a down state.

Note: a similar process can be used with the threshold_record resource to retrieve data on events triggered by breaches of configured thresholds.


cURLPythonRubyResponse

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer <MY_TOKEN>" \
	-X GET \
	-u user:pword "https://your.statseeker.server/api/v2.1/event_record/?indent=3&links=none&fields=event,eventid,device,deviceid,state,delta,time&state_filter=IS(%22up%22)&event_filter=IS(%22IF-MIB.ifOperStatus%22)&time_timefilter=range%20=%20now%20-%203h%20to%20now"


# import requests for handling connection and encoding
import requests
import json
def do_request(server, query, user, pword):
    # Run auth request
    headers = { 'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded' }
    url = f'https://{server}/ss-auth'
    authData = {'user': user, 'password': pword}
    resp = requests.post(url, headers=headers, data=authData, verify=False)
    headers['Content-Type'] = 'application/json'
    url = f'https://{server}/{query}'
    if resp.status_code == 200:
        # Authentication successful, Statseeker >= v5.5.4
        myToken = resp.json()
        headers['Authorization'] = f'Bearer {myToken["access_token"]}'
        resp = requests.get(url, headers=headers, verify=False)
    if resp.status_code != 200:
        # Either Authentication was unsuccessful (or Statseeker < v5.5.4), or API set to use basic auth
		# Try basic auth
        resp = requests.get(url, headers=headers, auth=(user, pword), verify=False)
    return resp

# Statseeker Server IP
server = 'your.statseeker.server'
# credentials
user = 'api_user'
pword = 'user_password'
# API root endpoint
query = 'api/v2.1'
# specify target endpoint
query += '/event_record'
# specify fields to be returned
query += '/?fields=event,eventid,device,deviceid,state,delta,time'
# Filters
query += '&state_filter=IS("up")&event_filter=IS("IF-MIB.ifOperStatus")&time_timefilter=range = now - 3h to now'
# optional response formatting
query += '&indent=3&links=none'
# Run the request
resp = do_request(server, query, user, pword)
if resp.status_code == 200:
    print(resp.status_code)
    print(resp.json())
else:
    print(f'Error: {resp.status_code} {resp.reason}')

# install with: $ gem install rest-client
require "rest_client"
require "json"
require "base64"

def try_basic(server, query, user, pword)
	headers = {
		:content_type => "json"
	}
	url = "https://" + server + "/" + query
	headers["Authorization"] = "Basic " + Base64.encode64("#{user}:#{pword}")
	return RestClient::Request.execute(
		:method => :get,
		:url => url,
		:headers => headers,
		:verify_ssl => false
	)
end

def do_request(server, query, user, pword)
    # Run auth request
    headers = {
        :content_type => "application/x-www-form-urlencoded"
    }
    url = "https://" + server + "/ss-auth"
    authData = {
       :user => user,
       :password => pword
    }
    begin
        resp = RestClient::Request.execute(
            :method => :post,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
            :payload => authData
        )
    rescue RestClient::Unauthorized
		# bad credentials or Statseeker < v5.5.4
        try_basic(server, query, user, pword)
    else
        # Authentication successful. Statseeker >= v5.5.4
        headers = {
			:content_type => "application/json"
		}	
        url = "https://" + server + "/" + query
        rdata = JSON.parse(resp)
        headers["Authorization"] = "Bearer " + rdata.fetch("access_token")
        return RestClient::Request.execute(
            :method => :get,
            :url => url,
            :headers => headers,
            :verify_ssl => false,
        )
    end
	rescue RestClient::Unauthorized
		# Statseeker = v5.5.4 but configured for basic auth
        try_basic(server, query, user, pword)
end
# Statseeker Server IP
$server = 'your.statseeker.server'
# api user credentials
$user = 'api_user'
$pword = 'user_password'
# api root endpoint
$query = 'api/v2.1'
# specify target endpoint
$query += '/event_record'
# specify fields to be returned
$query += '/?fields=event,eventid,device,deviceid,state,delta,time'
# Filters
$query += '&state_filter=IS("up")&event_filter=IS("IF-MIB.ifOperStatus")&time_timefilter=range = now - 3h to now'
# optional response formatting
$query += '&indent=3&links=none'
# Run the request
resp = do_request($server, $query, $user, $pword)
puts "#{resp.to_str}"

{
	"info": "The Statseeker RESTful API",
	"data": {
		"objects": [{
			"status": {
				"errcode": 0,
				"success": true
			},
			"data": [{
				"eventid": 17,
				"time": 1490328180,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 185,
				"delta": 23520,
				"device": "Chicago-rtr",
				"id": "58D49A74-1-1"
			}, {
				"eventid": 81,
				"time": 1490324821,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 284,
				"delta": 3960,
				"device": "Warsaw-rtr",
				"id": "58D48D55-1-1"
			}, {
				"eventid": 81,
				"time": 1490327161,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 284,
				"delta": 480,
				"device": "Warsaw-rtr",
				"id": "58D49679-1-1"
			}, {
				"eventid": 97,
				"time": 1490329921,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 293,
				"delta": 3540,
				"device": "Athens-srv1",
				"id": "58D4A141-1-1"
			}, {
				"eventid": 97,
				"time": 1490332501,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 293,
				"delta": 1080,
				"device": "Athens-srv1",
				"id": "58D4AB55-1-1"
			}, {
				"eventid": 129,
				"time": 1490326021,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 334,
				"delta": 4260,
				"device": "Copenhagen-rtr",
				"id": "58D49205-1-1"
			}, {
				"eventid": 145,
				"time": 1490324821,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 350,
				"delta": 6900,
				"device": "Shanghai-rtr",
				"id": "58D48D55-2-1"
			}, {
				"eventid": 145,
				"time": 1490328421,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 350,
				"delta": 2040,
				"device": "Shanghai-rtr",
				"id": "58D49B65-1-1"
			}, {
				"eventid": 177,
				"time": 1490329802,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 378,
				"delta": 19741,
				"device": "Delhi-rtr",
				"id": "58D4A0CA-1-1"
			}, {
				"eventid": 209,
				"time": 1490332022,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 390,
				"delta": 840,
				"device": "Chennai-rtr",
				"id": "58D4A976-1-1"
			}, {
				"eventid": 209,
				"time": 1490332142,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 390,
				"delta": 60,
				"device": "Chennai-rtr",
				"id": "58D4A9EE-1-1"
			}, {
				"eventid": 209,
				"time": 1490332502,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 390,
				"delta": 120,
				"device": "Chennai-rtr",
				"id": "58D4AB56-1-1"
			}, {
				"eventid": 225,
				"time": 1490325842,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 414,
				"delta": 840,
				"device": "CapeTown-rtr",
				"id": "58D49152-1-1"
			}, {
				"eventid": 225,
				"time": 1490328002,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 414,
				"delta": 1080,
				"device": "CapeTown-rtr",
				"id": "58D499C2-1-1"
			}, {
				"eventid": 241,
				"time": 1490323442,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 417,
				"delta": 300,
				"device": "PortElizabeth-rtr",
				"id": "58D487F2-1-1"
			}, {
				"eventid": 241,
				"time": 1490327942,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 417,
				"delta": 3900,
				"device": "PortElizabeth-rtr",
				"id": "58D49986-1-1"
			}, {
				"eventid": 241,
				"time": 1490329982,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 417,
				"delta": 1440,
				"device": "PortElizabeth-rtr",
				"id": "58D4A17E-1-1"
			}, {
				"eventid": 257,
				"time": 1490326322,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 423,
				"delta": 6060,
				"device": "Pretoria-rtr",
				"id": "58D49332-1-1"
			}, {
				"eventid": 257,
				"time": 1490330462,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 423,
				"delta": 2280,
				"device": "Pretoria-rtr",
				"id": "58D4A35E-2-1"
			}, {
				"eventid": 257,
				"time": 1490331122,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 423,
				"delta": 360,
				"device": "Pretoria-rtr",
				"id": "58D4A5F2-1-1"
			}],
			"type": "event_record",
			"data_total": 20
		}],
		"errmsg": "ok",
		"success": true,
		"time": 1490333357
	},
	"api_version": "2.0"
}
[top]

Resource Reference


ACI Application Profile

Description

The custom data entities for the aci_application table

Table

cdt_aci_application

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aci_tenant ACI Tenant string G A policy owner in the virtual fabric. A tenant can be either a private or a shared entity. For example, you can create a tenant with contexts and bridge domains shared by other tenant. A shared type of tenant is typically named common, default, or infra.
health Health integer G Health of ACI Application Profile
title Title string G ACI Application Profile Name
Links

This resource has links to the following:

[reference]  [top]

ACI Bridging Domain

Description

The custom data entities for the aci_bridge_domain table

Table

cdt_aci_bridge_domain

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aci_tenant ACI Tenant string G A policy owner in the virtual fabric. A tenant can be either a private or a shared entity. For example, you can create a tenant with contexts and bridge domains shared by other tenant. A shared type of tenant is typically named common, default, or infra.
broadcast_ip Multicast Group IP Address string G Outer multicast group IP address.
health Health integer G Health
Timeseries Data: Stats, Formats & Options
mac MAC string G MAC Address
title Title string G Bridging Domain Name
type Type string G Bridging Domain Type
Links

This resource has links to the following:

[reference]  [top]

ACI Client Endpoint

Description

The custom data entities for the aci_cep table

Table

cdt_aci_cep

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aci_epg EPG string G A set of requirements for the application-level EPG instance. The policy regulates connectivity and visibility among the end points within the scope of the policy.
ip IP Address string G IP Address of Client Endpoint
mac MAC Address string G The MAC Address
title Title string G Name of Client Endpoint
vlan VLAN string G The VXLAN or VLAN
Links

This resource has links to the following:

[reference]  [top]

ACI Endpoint Groups

Description

The custom data entities for the aci_epg table

Table

cdt_aci_epg

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aci_application ACI Application Profile string G The application profile is a set of requirements that an application instance has on the virtualizable fabric. The policy regulates connectivity and visibility among endpoints within the scope of the policy.
config_state Configuration State string G The configuration state of the endpoint group
Can be combined with an event format for event-based analytics, see Event Formats.
health Health integer G Health of the EPG
Timeseries Data: Stats, Formats & Options
title Title string G Name of the Endpoint Group
Links

This resource has links to the following:

[reference]  [top]

ACI Fault

Description

The custom data entities for the aci_fault table

Table

cdt_aci_fault

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ack Acknowledged string G Acknowledged
cause Cause string G Fault Cause
changeSet Change string G Change Set
code Code string G Fault Code
created Created time G Fault Creation Time
delegated Delegated string G Delegated
descr Description string G Description
domain Domain string G Domain
highestSeverity High Severity string G Highest Severity
lastTransition Last Transition time G Last Transition
occur Occurences integer G Number of Occurences
Timeseries Data: Stats, Formats & Options
origSeverity Original Severity string G Original Severity
prevSeverity Previous Severity string G Previous Severity
rule Rule string G Rule
severity Severity string G Severity
subject Subject string G Subject
type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

ACI Fault Summary

Description

The custom data entities for the aci_fault_summary table

Table

cdt_aci_fault_summary

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ack_delegated_faults Acknowledged Delegated Faults integer G Number of Acknowledged Delegated Faults
Timeseries Data: Stats, Formats & Options
ack_faults Acknowledged Faults integer G Number of Acknowledged Faults
Timeseries Data: Stats, Formats & Options
delegated_faults Delegated Faults integer G Number of Delegated Faults
Timeseries Data: Stats, Formats & Options
faults Faults integer G Number of Faults
Timeseries Data: Stats, Formats & Options
severity Severity string G Severity
title Title string G Title
type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

ACI Node

Description

The custom data entities for the aci_node table

Table

cdt_aci_node

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aci_pod ACI Pod string G ACI Pod
admin_state Admin State string G ACI Node Administrative State
Can be combined with an event format for event-based analytics, see Event Formats.
fabric_domain ACI Fabric Domain string G ACI Fabric Domain
fabric_state ACI Fabric State string G ACI Fabric State
Can be combined with an event format for event-based analytics, see Event Formats.
health Health integer G Health
Timeseries Data: Stats, Formats & Options
ip IP Address string G ACI Node Management IP Address
model Model string G Model
serial Serial string G Serial
state State string G ACI Node State
Can be combined with an event format for event-based analytics, see Event Formats.
title Title string G ACI Node Name
type Type string G ACI Node Type
vendor vendor string G vendor
Links

This resource has links to the following:

[reference]  [top]

ACI Pod

Description

The custom data entities for the aci_pod table

Table

cdt_aci_pod

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
health Health integer G Health
Timeseries Data: Stats, Formats & Options
title Title string G ACI Pod
Links

This resource has links to the following:

[reference]  [top]

ACI Subnet

Description

The custom data entities for the aci_subnet table

Table

cdt_aci_subnet

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aci_bridge_domain ACI Bridging Domain string G ACI Bridging Domain
alias Alias string G Subnet Alias
ip IP Address Range string G IP Address Range
title Title string G Subnet Name
Links

This resource has links to the following:

[reference]  [top]

ACI Tenant

Description

The custom data entities for the aci_tenant table

Table

cdt_aci_tenant

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
health Health integer G Health
Timeseries Data: Stats, Formats & Options
title Title string G ACI Tenant Name
Links

This resource has links to the following:

[reference]  [top]

ACI Private Network

Description

The custom data entities for the aci_vrf table

Table

cdt_aci_vrf

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aci_tenant ACI Tenant string G aci_tenant
health Health integer G health
Timeseries Data: Stats, Formats & Options
title Title string G Name for the Network Context
Links

This resource has links to the following:

[reference]  [top]

Apcon Interface

Description

The custom data entities for the apcon_port table

Table

cdt_apcon_port

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
InBroadcastPkts Rx Bcast Pkts integer G Broadcast packets received.
Timeseries Data: Stats, Formats & Options
InMulticastPkts Rx Mcast Pkts integer G Multicast packets received.
Timeseries Data: Stats, Formats & Options
InOctets Rx Bytes integer G Receive byte count.
Timeseries Data: Stats, Formats & Options
InUcastPkts Rx Ucast Pkts integer G Unicast packets received.
Timeseries Data: Stats, Formats & Options
OutBroadcastPkts Tx Bcast Pkts integer G Broadcast packets transmitted.
Timeseries Data: Stats, Formats & Options
OutMulticastPkts Tx Mcast Pkts integer G Multicast packets transmitted.
Timeseries Data: Stats, Formats & Options
OutOctets Tx Bytes integer G Transmit byte count.
Timeseries Data: Stats, Formats & Options
OutUcastPkts Tx Ucast Pkts integer G Unicast packets transmitted.
Timeseries Data: Stats, Formats & Options
RxBps Rx Bps integer G Receive bits per second.
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G Receive Utilization
Timeseries Data: Stats, Formats & Options
Speed Speed integer G, U Port Speed.
TxBps Tx Bps integer G Transmit bits per second.
Timeseries Data: Stats, Formats & Options
TxUtil Tx Util float G Transmit Utilization
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco APPNAV

Description

The custom data entities for the appnav_cisco table

Table

cdt_appnav_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cAppNavACACGName Controller Group string G, U This object indicates the name of the AppNav controller group to which given AppNav controller belongs.
cAppNavACCurrentCMState Controller Member State string G, U This object indicates the current cluster membership state of the given AppNav controller, one of:

  • alive – the AppNav controller or service node is in contact of the AppNav cluster
  • dead – contact to the given AppNav controller or service node from the AppNav cluster is lost
  • excluded – the AppNav controller/service node is not a part of the AppNav cluster
  • inactive – the given AppNav controller is added to config but is inactive because of zombies
  • na – the given AppNav controller/service node has no status information available when service context is in the admin disabled state
  • partial – the given AppNav controller/service node is partially part of the AppNav cluster
  • zombie – the AppNav controller is removed from config but is still alive


Can be combined with an event format for event-based analytics, see Event Formats.

cAppNavACIpAddr Controller IP string G, U This object indicates the IP address of the AppNav controller
cAppNavACIpAddrType Controller IP Type string G This object indicates the address type of the cAppNavACIpAddr. The cAppNavACEntries are only valid for address type of IPv4 and IPv6.
cAppNavACServContextName Controller Service Context string G, U This object indicates the name of the service context to which given AppNav controller belongs.
cAppNavSNCurrentCMState Node Member State string G, U This object indicates the current cluster membership state of the given service node, one of:

  • alive – the AppNav controller or service node is in contact of the AppNav cluster
  • dead – contact to the given AppNav controller or service node from the AppNav cluster is lost
  • excluded – the AppNav controller/service node is not a part of the AppNav cluster
  • inactive – the given AppNav controller is added to config but is inactive because of zombies
  • na – the given AppNav controller/service node has no status information available when service context is in the admin disabled state
  • partial – the given AppNav controller/service node is partially part of the AppNav cluster
  • zombie – the AppNav controller is removed from config but is still alive


Can be combined with an event format for event-based analytics, see Event Formats.

cAppNavSNIpAddr Node IP string G, U This object indicates the IP address of the given service node.
cAppNavSNIpAddrType Node IP Type string G, U This object indicates the address type of cacSnIpAddr. cacSNEntries are only valid for address type of IPv4 and IPv6.
cAppNavSNSNGName Node Group string G, U This object indicates the name of the service node group to which given service node belongs.
cAppNavSNServContextName Node Context string G, U This object indicates the name of the service context to which given service node belongs.
Links

This resource has links to the following:

[reference]  [top]

BGP Peer

Description

The custom data entities for the bgp_peer table

Table

cdt_bgp_peer

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AdminStatus Admin Status string G, U The desired state of the BGP connection.
Can be combined with an event format for event-based analytics, see Event Formats.

  • Start
  • Stop
ConnectRetryInterval ConnectRetry Interval integer G, U Time interval for the ConnectRetry timer.
FsmEstablishedTime FSM Established Time integer G This timer indicates how long this peer has been in the established state or how long since this peer was last in the established state.
Timeseries Data: Stats, Formats & Options
FsmEstablishedTransitions FSM Established Transitions integer G The total number of times the BGP FSM transitioned into the established state for this peer.
Timeseries Data: Stats, Formats & Options
HoldTime Hold Time integer G, U Time interval for the Hold Timer established with the peer.
KeepAlive Keep Alive integer G, U Time interval for the KeepAlive timer established with the peer.
LocalAddr Local IP string G, U The local IP address of this entry’s BGP connection.
LocalPort Local Port integer G, U The local port for the TCP connection between the BGP peers.
MinASOriginationInterval Min AS Origination Interval integer G, U Time interval for the MinASOriginationInterval timer.
MinRouteAdvertisementInterval Min Route Advertisement Interval integer G, U Time interval for the MinRouteAdvertisementInterval timer.
NegotiatedVersion Negotiated Version integer G, U The negotiated version of BGP running between the two peers.
PeerIdentifier Peer Identifier string G, U
RemoteAddr Remote IP string G, U The remote IP address of this entry’s BGP peer.
RemoteAs Remote Autonomous System Number string G, U The remote autonomous system number received in the BGP OPEN message.
RemotePort Remote Port integer G, U The remote port for the TCP connection between the BGP peers.
RxTotalMessages Rx Messages integer G The total number of messages received from the remote peer on this connection.
Timeseries Data: Stats, Formats & Options
RxUpdateElapsedTime Rx Update Elapsed Time integer G Elapsed time since the last BGP UPDATE message was received from the peer.
Timeseries Data: Stats, Formats & Options
RxUpdates Rx Updates integer G The number of BGP UPDATE messages received on this connection.
Timeseries Data: Stats, Formats & Options
State State string G, U The BGP peer connection state, one of:

  • active
  • connect
  • established
  • idle
  • opensent
  • openconfirm

Can be combined with an event format for event-based analytics, see Event Formats.

TxTotalMessages Tx Messages integer G The total number of messages transmitted to the remote peer on this connection.
Timeseries Data: Stats, Formats & Options
TxUpdates Tx Updates integer G The number of BGP UPDATE messages transmitted on this connection.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

BGP Peer Address Family Prefix – Cisco

Description

The custom data entities for the bgp_peer_addr_family_prefix_cisco table

Table

cdt_bgp_peer_addr_family_prefix_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AcceptedPrefixes Accepted Prefixes integer G Number of accepted route prefixes for an address family on this connection.
Timeseries Data: Stats, Formats & Options
AddrFamilyAfi AFI Index string G Address family identifier (e.g. IPv4, IPv6).
AddrFamilyName Address family name string G, U Implementation specific address family name.
AddrFamilySafi SAFI Index string G Subsequent address family identifier (e.g. unicast, multicast).
AdvertisedPrefixes Advertised Prefixes integer G Incremented when a route prefix is advertised for an address family on this connection
Timeseries Data: Stats, Formats & Options
DeniedPrefixes Denied Prefixes integer G Incremented when a route prefix for an address family on this connection is denied.
Timeseries Data: Stats, Formats & Options
PrefixAdminLimit Admin Limit integer G, U Max number of route prefixes accepted for an address family on this connection.
PrefixClearThreshold Clear Threshold integer G, U Prefix threshold value (%) to clear warning message for an address family on this connection.
PrefixThreshold Prefix Threshold integer G, U Prefix threshold value (%) to generate warning message for an address family on this connection.
RemoteAddr Remote IP string G The remote IP address of this entry’s BGP peer.
SuppressedPrefixes Suppressed Prefixes integer G Incremented when a route prefix is suppressed from being sent for an address family on this connection.
Timeseries Data: Stats, Formats & Options
WithdrawnPrefixes Withdrawn Prefixes integer G Incremented when a route prefix is withdrawn for an address family on this connection
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

BGP Peer – Cisco

Description

The custom data entities for the bgp_peer_cisco table

Table

cdt_bgp_peer_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AdminStatus Admin Status string G The desired state of the BGP connection.
Can be combined with an event format for event-based analytics, see Event Formats.

  • Start
  • Stop
ConnectRetryInterval ConnectRetry Interval integer G Time interval for the ConnectRetry timer.
FsmEstablishedTime FSM Established Time integer G This timer indicates how long this peer has been in the established state or how long since this peer was last in the established state.
Timeseries Data: Stats, Formats & Options
FsmEstablishedTransitions FSM Established Transitions integer G The total number of times the BGP FSM transitioned into the established state for this peer.
Timeseries Data: Stats, Formats & Options
HoldTime Hold Time integer G Time interval for the Hold Timer established with the peer.
KeepAlive Keep Alive integer G Time interval for the KeepAlive timer established with the peer.
LocalAddr Local IP string G The local IP address of this entry’s BGP connection.
LocalPort Local Port integer G The local port for the TCP connection between the BGP peers.
MinASOriginationInterval Min AS Origination Interval integer G Time interval for the MinASOriginationInterval timer.
MinRouteAdvertisementInterval Min Route Advertisement Interval integer G Time interval for the MinRouteAdvertisementInterval timer.
NegotiatedVersion Negotiated Version integer G The negotiated version of BGP running between the two peers.
PeerIdentifier Peer Identifier string G
RemoteAddr Remote IP string G The remote IP address of this entry’s BGP peer.
RemoteAs Remote Autonomous System Number string G The remote autonomous system number received in the BGP OPEN message.
RemotePort Remote Port integer G The remote port for the TCP connection between the BGP peers.
RxTotalMessages Rx Messages integer G The total number of messages received from the remote peer on this connection.
Timeseries Data: Stats, Formats & Options
RxUpdateElapsedTime Rx Update Elapsed Time integer G Elapsed time since the last BGP UPDATE message was received from the peer.
Timeseries Data: Stats, Formats & Options
RxUpdates Rx Updates integer G The number of BGP UPDATE messages received on this connection.
Timeseries Data: Stats, Formats & Options
State State string G The BGP peer connection state

  • active
  • connect
  • established
  • idle
  • opensent
  • openconfirm

Can be combined with an event format for event-based analytics, see Event Formats.

TxTotalMessages Tx Messages integer G The total number of messages transmitted to the remote peer on this connection.
Timeseries Data: Stats, Formats & Options
TxUpdates Tx Updates integer G The number of BGP UPDATE messages transmitted on this connection.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

BGP Peer – Juniper

Description

The custom data entities for the bgp_peer_juniper table

Table

cdt_bgp_peer_juniper

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AdminStatus Admin Status string G The desired state of the BGP connection.
Can be combined with an event format for event-based analytics, see Event Formats.

  • Start
  • Stop
ConnectRetryInterval ConnectRetry Interval integer G Time interval for the ConnectRetry timer.
FsmEstablishedTime FSM Established Time integer G This timer indicates how long this peer has been in the established state or how long since this peer was last in the established state.
Timeseries Data: Stats, Formats & Options
FsmEstablishedTransitions FSM Established Transitions integer G The total number of times the BGP FSM transitioned into the established state for this peer.
Timeseries Data: Stats, Formats & Options
HoldTime Hold Time integer G Time interval for the Hold Timer established with the peer.
KeepAlive Keep Alive integer G Time interval for the KeepAlive timer established with the peer.
LocalAddr Local IP string G The local IP address of this entry’s BGP connection.
LocalPort Local Port integer G The local port for the TCP connection between the BGP peers.
MinASOriginationInterval Min AS Origination Interval integer G Time interval for the MinASOriginationInterval timer.
MinRouteAdvertisementInterval Min Route Advertisement Interval integer G Time interval for the MinRouteAdvertisementInterval timer.
NegotiatedVersion Negotiated Version integer G The negotiated version of BGP running between the two peers.
PeerIdentifier Peer Identifier string G
RemoteAddr Remote IP string G The remote IP address of this entry’s BGP peer.
RemoteAs Remote Autonomous System Number string G The remote autonomous system number received in the BGP OPEN message.
RemotePort Remote Port integer G The remote port for the TCP connection between the BGP peers.
RxTotalMessages Rx Messages integer G The total number of messages received from the remote peer on this connection.
Timeseries Data: Stats, Formats & Options
RxUpdateElapsedTime Rx Update Elapsed Time integer G Elapsed time since the last BGP UPDATE message was received from the peer.
Timeseries Data: Stats, Formats & Options
RxUpdates Rx Updates integer G The number of BGP UPDATE messages received on this connection.
Timeseries Data: Stats, Formats & Options
State State string G The BGP peer connection state

  • active
  • connect
  • established
  • idle
  • opensent
  • openconfirm

Can be combined with an event format for event-based analytics, see Event Formats.

TxTotalMessages Tx Messages integer G The total number of messages transmitted to the remote peer on this connection.
Timeseries Data: Stats, Formats & Options
TxUpdates Tx Updates integer G The number of BGP UPDATE messages transmitted on this connection.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Checkpoint Firewall

Description

The custom data entities for the checkpoint_firewall table

Table

cdt_checkpoint_firewall

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Accepted Accepted Pkts integer G The number of accepted packets.
Timeseries Data: Stats, Formats & Options
Dropped Dropped Pkts integer G The number of dropped packets.
Timeseries Data: Stats, Formats & Options
InstallTime Install Time string G, U The time that the filter was installed.
Logged Logged Pkts integer G The number of logged packets.
Timeseries Data: Stats, Formats & Options
Rejected Rejected Pkts integer G The number of rejected packets.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Checkpoint VPN Sessions

Description

The custom data entities for the checkpoint_vpn_sessions table

Table

cdt_checkpoint_vpn_sessions

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ActiveHwUserTunnels Active Hw User Tunnels integer G IPsec high-watermark active tunnels with remote access users
Timeseries Data: Stats, Formats & Options
RxError Rx Errors integer G Decryption Errors
Timeseries Data: Stats, Formats & Options
RxPackets Rx Packets integer G Decrypted packets
Timeseries Data: Stats, Formats & Options
TxError Tx Errors integer G Encryption Errors
Timeseries Data: Stats, Formats & Options
TxPackets Tx Packets integer G Encrypted packets
Timeseries Data: Stats, Formats & Options
activeHwTunnels Active Hw Tunnels integer G IPsec high-watermark active tunnels
Timeseries Data: Stats, Formats & Options
activeTunnels Active IPsec Tunnels integer G IPsec current active tunnels
Timeseries Data: Stats, Formats & Options
activeTunnelsLimit Active Tunnels Limit integer G, U IPsec active tunnels limit
activeUserTunnels Active User Tunnels integer G IPsec current active tunnels with remote access users
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco Active DS0

Description

The custom data entities for the cisco_activeDS0 table

Table

cdt_cisco_activeDS0

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
curActiveDS0s Active DS0s integer G The number of DS0s that are currently in use.
Timeseries Data: Stats, Formats & Options
maxActiveDS0s Max Active DS0s integer G The high water mark for number of DS0s active simultaneously.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco Call Stats

Description

The custom data entities for the cisco_call_stats table

Table

cdt_cisco_call_stats

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
MaxConnections Max Connections integer G This object represents the licensed call capacity for a voice gateway.
RxCalls Rx Calls integer G This object represents the total number of inbound active media calls through this IP interface.
Timeseries Data: Stats, Formats & Options
TotalActiveConnections Total Active Connections integer G This object represents the total number of active call legs in the voice gateway.
Timeseries Data: Stats, Formats & Options
TxCalls Tx Calls integer G This object represents the total number of outbound active media calls through this IP interface.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Config – ClassMap

Description

The custom data entities for the cisco_cb_qos_class_map_config table

Table

cdt_cisco_cb_qos_class_map_config

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
description Description string G, U Description of the PolicyMap.
matchType Match Type string G, U Match all vs Match any in a given class, one of:

  • None
  • MatchAll
  • MatchAny
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Data – Class

Description

The custom data entities for the cisco_cb_qos_class_map_data table

Table

cdt_cisco_cb_qos_class_map_data

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
direction Direction string G Direction of the top level policy
drop Dropped Bytes integer G The 64 bits counter of dropped bytes per class as the result of all features that can produce drops (e.g., police, random detect, etc.).
Timeseries Data: Stats, Formats & Options
dropBitRate Drop BitRate float G The bit rate of the drops per class as the result of all features that can produce drops (e.g., police, random detect, etc.).
Timeseries Data: Stats, Formats & Options
dropPercent Dropped Percent float G Percentage of bytes dropped
Timeseries Data: Stats, Formats & Options
postPolicy Post Policy Byte integer G The 64 bits count of outbound octets after executing QoS policies.
Timeseries Data: Stats, Formats & Options
postPolicyBitRate Post Policy BitRate float G The bit rate of the traffic after executing QoS policies.
Timeseries Data: Stats, Formats & Options
prePolicy Pre Policy Byte integer G The 64 bits count of inbound octets prior to executing any QoS policies.
Timeseries Data: Stats, Formats & Options
prePolicyBitRate Pre Policy BitRate float G The bit rate of the traffic prior to executing any QoS policies.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Config – Policy/Class

Description

The custom data entities for the cisco_cb_qos_config_policy_class table

Table

cdt_cisco_cb_qos_config_policy_class

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Data – Match

Description

The custom data entities for the cisco_cb_qos_match_data table

Table

cdt_cisco_cb_qos_match_data

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
bitRate BitRate float G The bit rate of the traffic prior to executing any QoS policies.
Timeseries Data: Stats, Formats & Options
bytes Bytes integer G Bytes
Timeseries Data: Stats, Formats & Options
packets Packets integer G Packets
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Config – Match

Description

The custom data entities for the cisco_cb_qos_match_map_config table

Table

cdt_cisco_cb_qos_match_map_config

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
statement Statement string G The match statement
type Type string G Match vs Match Not in a given class
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Config – PolicyMap

Description

The custom data entities for the cisco_cb_qos_policy_map_config table

Table

cdt_cisco_cb_qos_policy_map_config

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
description Description string G, U Description of the PolicyMap.
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Data – Queue

Description

The custom data entities for the cisco_cb_qos_queue_data table

Table

cdt_cisco_cb_qos_queue_data

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
discard Discard integer G The count of octets, associated with this class, that were dropped by queuing
Timeseries Data: Stats, Formats & Options
percentUsed Used Percent float G The percent of the Queue Depth used
Timeseries Data: Stats, Formats & Options
size Size integer G The maximum depth of the queue.
Timeseries Data: Stats, Formats & Options
used Used integer G The current depth of the queue
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco CB QoS Config – Queue

Description

The custom data entities for the cisco_cb_qos_queue_map_config table

Table

cdt_cisco_cb_qos_queue_map_config

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
aggregateQueueLimit Aggregate Queue Limit string G Maximum allowed queue size for all the individual queues associated with this class. When the queue size exceed this value, the packets will be dropped.
aggregateQueueSize Aggregate Queue Size integer G Maximum number of packets that can be held in all the individual queues associated with this class before packets are dropped.
bandwidth Bandwidth string G The bandwidth configuration value
dynamicQueueNumber Dynamic Queue Number integer G Number of dynamic queues supported when flow-based fair-queue is in use.
flowEnabled Flow Enabled string G Indicate if flow-based fair-queue is enabled for this class, one of:

  • true
  • false
individualQueueSize Individual Queue Size integer G Maximum number of packets that can be held in an individual Flow-based fair-queue associated with this class before it drops packets (once the AggregateQSize has been reached). This field only makes sense in the context of Flow-based fair-queuing.
priorityBurstSize Priority Burst Size integer G In the priority queue, this is the number of bytes allowed in a single burst. This parameter only makes sense if Priority is enabled
priorityEnabled Priority Enabled string G Indicate if low latency queuing (priority) is enabled for this class, one of:

  • true
  • false
Links

This resource has links to the following:

[reference]  [top]

Cisco Discovery Protocol Cache

Description

The custom data entities for the cisco_cdp_cache table

Table

cdt_cisco_cdp_cache

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cdpCacheAddressIP Remote Device IP string G
cdpCacheAddressName Remote Device string G
cdpCacheDeviceId Remote Device ID string G, U
cdpCacheDevicePort Remote Interface string G, U
cdpCacheIfIndex Local ifIndex string G Interface Index (IF-MIB.ifIndex) of the local interface
cdpCachePlatform Remote Device Platform string G, U
Links

This resource has links to the following:

[reference]  [top]

Cisco EIGRP

Description

The custom data entities for the cisco_eigrp table

Table

cdt_cisco_eigrp

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AcksRcvd Acks Received integer G Acks Received
Timeseries Data: Stats, Formats & Options
AcksSent Acks Sent integer G Acks Sent
Timeseries Data: Stats, Formats & Options
AsNumber AS Number integer G The Autonomous System number which is unique integer per VPN
AsRouterId Router Id string G The router-id configured or automatically selected for the EIGRP AS. Each EIGRP routing process has a unique router-id selected from each autonomous system configured. The format is governed by object cEigrpAsRouterIdType.
AsRouterIdType Router Type string G, U The format of the router-id configured or automatically selected for the EIGRP AS.
HellosRcvd Hellos Received integer G Hellos Received
Timeseries Data: Stats, Formats & Options
HellosSent Hellos Sent integer G The total number Hello packets that have been sent to all EIGRP neighbors formed on all interfaces whose IP addresses fall under networks configured for the EIGRP AS.
Timeseries Data: Stats, Formats & Options
NbrCount Neighbor Count integer G The total number of live EIGRP neighbors formed on all interfaces whose IP addresses fall under networks configured in the EIGRP AS.
Timeseries Data: Stats, Formats & Options
QueriesRcvd Queries Received integer G The total number alternate route query packets that have been received from all EIGRP neighbors formed on all interfaces whose IP addresses fall under networks configured for the EIGRP AS.
Timeseries Data: Stats, Formats & Options
QueriesSent Queries Sent integer G The total number alternate route query packets that have been sent to all EIGRP neighbors formed on all interfaces whose IP addresses fall under networks configured for the EIGRP AS.
Timeseries Data: Stats, Formats & Options
RepliesRcvd Replies Received integer G Replies Received
Timeseries Data: Stats, Formats & Options
RepliesSent Replies Sent integer G Replies Sent
Timeseries Data: Stats, Formats & Options
TopoRoutes Routes integer G The total number of EIGRP derived routes currently existing in the topology table for the AS.
Timeseries Data: Stats, Formats & Options
UpdatesRcvd Updates Received integer G Updates Received
Timeseries Data: Stats, Formats & Options
UpdatesSent Updates Sent integer G Updates Sent
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco EIGRP Peer

Description

The custom data entities for the cisco_eigrp_peer table

Table

cdt_cisco_eigrp_peer

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
HoldTime Hold Time integer G The count-down timer indicating how much time must pass without receiving a hello packet from this EIGRP peer before this router declares the peer down. A peer declared as down is removed from the table and is no longer visible.
Timeseries Data: Stats, Formats & Options
LastSeq Last Seq integer G All transmitted EIGRP packets have a sequence number assigned. This is the sequence number of the last EIGRP packet sent to this peer.
Timeseries Data: Stats, Formats & Options
PeerAddrType Peer Address Type string G, U The format of the remote source IP address used by the peer to establish the EIGRP adjacency with this router.
PeerIfIndex Peer Interface Index integer G, U The ifIndex of the interface on this router through which this peer can be reached.
PktsEnqueued Packets Enqueued integer G The number of any EIGRP packets currently enqueued waiting to be sent to this peer.
Timeseries Data: Stats, Formats & Options
RemotePeerDevice Remote Peer string G Remote Peer
Retrans Retransmits integer G Retransmits
Timeseries Data: Stats, Formats & Options
Retries Retries integer G Retries
Timeseries Data: Stats, Formats & Options
Rto Retransmission Timeout integer G The computed retransmission timeout for the peer. This value is computed over time as packets are sent to the peer and acknowledgements are received from it, and is the amount of time to wait before resending a packet from the retransmission queue to the peer when an expected acknowledgement has not been received.
Timeseries Data: Stats, Formats & Options
Srtt SRTT integer G The computed smooth round trip time for packets to and from the peer.
Timeseries Data: Stats, Formats & Options
Version Eigrp Version string G, U Eigrp Version
portLink portLink string G, U portLink
Links

This resource has links to the following:

[reference]  [top]

Cisco TCAM Entries

Description

The custom data entities for the cisco_fib_tcam table

Table

cdt_cisco_fib_tcam

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ciscoTcamProtocolType TCAM Protocol string G The Layer 3 protocol utilizing FIB TCAM resource, one of

  • ipv4
  • mpls
  • eom
  • ipv6
  • ipv4Multicast
  • ipv6Multicast
  • l2VpnPeer
  • l2VpnIpv4Multicast
  • fcoe
  • mplsVpn
  • fcMpls
  • ipv6LocalLink
  • allProtocols
entPhysicalName Component Name string G
tcamFree Physical Free integer G Amount of Physical TCAM entries free
Timeseries Data: Stats, Formats & Options
tcamFreePercent Physical Free Percent float G Amount of Physical TCAM entries free as a percentage
Timeseries Data: Stats, Formats & Options
tcamLogicalFree Logical Free integer G Amount of Logical TCAM entries free
Timeseries Data: Stats, Formats & Options
tcamLogicalFreePercent Logical Free Percent float G Amount of TCAM entries free as a percentage
Timeseries Data: Stats, Formats & Options
tcamLogicalSize Logical Total integer G Amount of Logical TCAM entries
Timeseries Data: Stats, Formats & Options
tcamLogicalUsed Logical Used integer G Amount of Logical TCAM entries used
Timeseries Data: Stats, Formats & Options
tcamLogicalUsedPercent Logical Used Percent float G Amount of Logical TCAM entries used as a percentage
Timeseries Data: Stats, Formats & Options
tcamSize Physical Total integer G Amount of Physical TCAM entries
Timeseries Data: Stats, Formats & Options
tcamUsed Physical Used integer G tsg
Timeseries Data: Stats, Formats & Options
tcamUsedPercent Physical Used Percent float G Amount of Physical TCAM entries used as a percentage
Timeseries Data: Stats, Formats & Options
tcamWidth TCAM Width string G, U Indicates the entry width type for the protocol
Links

This resource has links to the following:

[reference]  [top]

Cisco Firewall Connections

Description

The custom data entities for the cisco_firewall_connections table

Table

cdt_cisco_firewall_connections

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cfwConnectionService Service string G Connection service
cfwConnectionStatCount Count integer G This is an integer that contains the value of the resource statistic.
Timeseries Data: Stats, Formats & Options
cfwConnectionStatDescription Description string G, U A detailed textual description of this statistic.
cfwConnectionStatValue Value integer G This is an integer that contains the value of the resource statistic.
Timeseries Data: Stats, Formats & Options
cfwConnectionType Type string G Connection type, one of:

  • Other
  • Total Open
  • Current Open
  • Current Closing
  • Current Half-Open
  • Current In Use
  • High
  • Unknown Type
Links

This resource has links to the following:

[reference]  [top]

Cisco IF Extension

Description

The custom data entities for the cisco_if_extension table

Table

cdt_cisco_if_extension

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cieIfInAbortErrs In Abort Errs integer G Number of input packets which were dropped because the receiver aborted. Examples of this could be when an abort sequence aborted the input frame or when there is a collision in an ethernet segment.
Timeseries Data: Stats, Formats & Options
cieIfInFramingErrs In Framing Errs integer G The number of input packets on a physical interface which were misaligned or had framing errors. This happens when the format of the incoming packet on a physical interface is incorrect.
Timeseries Data: Stats, Formats & Options
cieIfInGiantsErrs In Giants Errs integer G The number of input packets on a particular physical interface which were dropped as they were larger than the ifMtu (largest permitted size of a packet which can be sent/received on an interface).
Timeseries Data: Stats, Formats & Options
cieIfInIgnored In Ignored integer G The number of input packets which were simply ignored by this physical interface due to insufficient resources to handle the incoming packets. For example, this could indicate that the input receive buffers are not available or that the receiver lost a packet.
Timeseries Data: Stats, Formats & Options
cieIfInOverrunErrs In Overrun Errs integer G The number of input packets which arrived on a particular physical interface which were too quick for the hardware to receive and hence the receiver ran out of buffers.
Timeseries Data: Stats, Formats & Options
cieIfInRuntsErrs In Runts Errs integer G The number of packets input on a particular physical interface which were dropped as they were smaller than the minimum allowable physical media limit.
Timeseries Data: Stats, Formats & Options
cieIfInputQueueDrops Input Queue Drops integer G The number of input packets which were dropped. Some reasons why this object could be incremented are: o Input queue is full. o Errors at the receiver hardware while receiving the packet.
Timeseries Data: Stats, Formats & Options
cieIfOutputQueueDrops Output Queue Drops integer G This object indicates the number of output packets dropped by the interface even though no error had been detected to prevent them being transmitted. The packet could be dropped for many reasons, which could range from the interface being down to errors in the format of the packet.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco VPN Global Tunnels

Description

The custom data entities for the cisco_ipsec_global table

Table

cdt_cisco_ipsec_global

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ActiveTunnels Active Tunnels integer G The total number of currently active IPsec Phase-1 Tunnels.
Timeseries Data: Stats, Formats & Options
InDropPkts RxDropPkts integer G The total number of packets dropped during receive processing by all currently and previously active IPsec Phase-1 Tunnels
Timeseries Data: Stats, Formats & Options
InOctets RxBytes integer G The total number of octets received by all currently and previously active IPsec Phase-1 IKE Tunnels.
Timeseries Data: Stats, Formats & Options
InPkts RxPkts integer G The total number of packets received by all currently and previously active IPsec Phase-1 IKE Tunnels.
Timeseries Data: Stats, Formats & Options
OutDropPkts TxDropPkts integer G The total number of packets dropped during send processing by all currently and previously active IPsec Phase-1 Tunnels
Timeseries Data: Stats, Formats & Options
OutOctets TxBytes integer G The total number of octets sent by all currently and previously active IPsec Phase-1 IKE Tunnels.
Timeseries Data: Stats, Formats & Options
OutPkts TxPkts integer G The total number of packets sent by all currently and previously active IPsec Phase-1 IKE Tunnels.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco VPN Tunnels

Description

The custom data entities for the cisco_ipsec_tun table

Table

cdt_cisco_ipsec_tun

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ActiveTime Active Time integer G The length of time the IPsec Phase-1 IKE tunnel has been active in seconds.
Timeseries Data: Stats, Formats & Options
InDropPkts RxDropPkts integer G The total number of packets dropped by this IPsec Phase-1 IKE Tunnel during receive processing.
Timeseries Data: Stats, Formats & Options
InOctets RxBytes integer G The total number of octets received by this IPsec Phase-1 IKE Tunnel.
Timeseries Data: Stats, Formats & Options
InPkts RxPkts integer G The total number of packets received by this IPsec Phase-1 IKE Tunnel.
Timeseries Data: Stats, Formats & Options
LifeTime Life Time integer G The negotiated LifeTime the IPsec Phase-1 IKE tunnel in seconds.
Timeseries Data: Stats, Formats & Options
LocalAddr Local IP string G Local IP of the Tunnel
LocalName Local DNS Name string G, U DNS name of the local IP, or NULL if not known.
LocalType Tunnel Type string G, U Local Peer Identity Type, one of:

  • ipAddrPeer
  • namePeer
LocalValue Tunnel Local Value string G, U Local Peer Identity Value
OutDropPkts TxDropPkts integer G The total number of packets dropped by this IPsec Phase-1 IKE Tunnel during send processing
Timeseries Data: Stats, Formats & Options
OutOctets TxBytes integer G The total number of octets sent by this IPsec Phase-1 IKE Tunnel.
Timeseries Data: Stats, Formats & Options
OutPkts TxPkts integer G The total number of packets sent by this IPsec Phase-1 IKE Tunnel.
Timeseries Data: Stats, Formats & Options
RemoteAddr Remote IP string G Remote IP of the Tunnel
RemoteName Remote DNS Name string G, U DNS name of the Remote IP, or NULL if not known.
RemoteType Tunnel Type string G, U Remote Peer Identity Type
RemoteValue Tunnel Remote Value string G, U Remote Peer Identity Value
Status Tun Status string G Tunnel Status, one of:

  • initializePhase1
  • awaitXauth
  • awaitCommit
  • active
  • destroy
  • rekey
Links

This resource has links to the following:

[reference]  [top]

Cisco IPSLA

Description

The custom data entities for the cisco_ipsla table

Table

cdt_cisco_ipsla

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AdminFrequency Frequency integer G, U Specifies the duration between initiating each RTT operation
AdminOwner Owner string G, U Identifies the entity that created this table row
AdminProtocol Protocol string G, U Specifies the protocol to be used to perform the RTT operation, one of:

  • apolloEcho
  • apolloEchoAppl
  • appleTalkEcho
  • appleTalkEchoAppl
  • decNetEcho
  • decNetEchoAppl
  • dhcpAppl
  • dlswAppl
  • dnsAppl
  • ethernetJitterAppl
  • ethernetPingAppl
  • ftpAppl
  • httpsAppl
  • icmpJitterAppl
  • ipIcmpEcho
  • ipTcpConn
  • ipUdpEchoAppl
  • ipxEcho
  • ipxEchoAppl
  • isoClnsEcho
  • isoClnsEchoAppl
  • jitterAppl
  • mcastJitterAppl
  • mplsLspPingAppl
  • netbiosEchoAppl
  • notApplicable
  • rtpAppl
  • snaLU0EchoAppl
  • snaLU2EchoAppl
  • snaLU62Echo
  • snaLU62EchoAppl
  • snaRUEcho
  • videoAppl
  • vinesEcho
  • vinesEchoAppl
  • voipAppl
  • xnsEcho
  • xnsEchoAppl
  • y17311dm
  • y1731dmm
  • y1731lmm
  • y1731slm
AdminRttType RTT Type string G, U Admin Round Trip Time Type, one of:

  • dhcp
  • dlsw
  • dns
  • echo
  • ethernetJitter
  • ethernetPing
  • fileIO
  • ftp
  • https
  • icmpjitter
  • jitter
  • lspGroup
  • lspPing
  • lspPingPseudowire
  • lspTrace
  • mcastJitter
  • pathEcho
  • rtp
  • script
  • tcpConnect
  • udpEcho
  • video
  • voip
  • y1731Delay
  • y1731Loss
AdminStatus Admin Status string G, U The status of the conceptual RTT control row, one of:

  • active
  • createAndGo
  • createAndWait
  • destroy
  • notInService
  • notReady
AdminTag Tag string G, U A string which is used by a managing application to identify the RTT target
AdminThreshold Threshold integer G, U This object defines an administrative threshold limit
AdminTimeout Timeout integer G, U Specifies the duration to wait for a RTT operation completion
CompletionStatus Completion Status string G, U The completion status of the conceptual RTT control row, one of:

  • applicationSpecific – the application generating the operation had a specific error
  • busy – the operation did not occur because a previous operation is still outstanding
  • disconnected – the operation did not occur because the connection to the target was lost
  • dnsQueryError – DNS Query error
  • dnsServerTimeout – NS Server Timeout
  • dropped – the operation did not occur due to lack of internal resource
  • enableAbort – Control enable request abort
  • enableAuthFail – Control enable request fail due to authentication fail
  • enableFail – Control enable request fail
  • enableFormatError – Control enable request fail due to format error
  • enableInternalError – Control enable request internal error
  • enableNoConnect – Control enable request fail due to no connection to the target
  • enableOk – Control enable request OK
  • enablePortInUse – Control enable request fail due to port in use
  • enableVersionFail – Control enable request version fail
  • error – socket failures or some other errors not relevant to the actual probe
  • httpError – HTTP Response StatusCode is not OK (200), or permanent redirect(301), temporary redirect (302)
  • httpTransactionTimeout – HTTP Transaction Timeout
  • mplsLspEchoTxError – MPLS echo request transmission failure
  • mplsLspMalformedReq – MPLS echo request was malformed, pointed out by the reply router
  • mplsLspReachButNotFEC – MPLS echo request processed by the downstream router but not the target
  • mplsLspUnreachable – MPLS Target FEC not reachable or unsupported mpls echo reply code
  • notConnected – the operation did not occur because no connection (session) exists with the target
  • ok – a valid completion occurred and timed successfully
  • other – the operation is not started or completed or this object is not applicable for the probe type
  • overThreshold – a valid completion was received but the completion time exceeded a threshold value
  • sequenceError – a completed operation did not contain the correct sequence id, no completion time recorded
  • statsRetrieveAbort – Stats retrieve request abort
  • statsRetrieveAuthFail – Stats retrieve request fail due to authentication fail
  • statsRetrieveFail – Stats retrieve request fail
  • statsRetrieveFormatError – Stats retrieve request fail due to format error
  • statsRetrieveInternalError – Stats retrieve request internal error
  • statsRetrieveNoConnect – Stats retrieve request fail due to no connection to the target
  • statsRetrieveOk – Stats retrieve request OK
  • statsRetrievePortInUse – Stats retrieve request fail due to port in use
  • statsRetrieveVersionFail – Stats retrieve request version fail
  • tcpConnectTimeout – TCP Connect Timeout
  • timeout – an operation timed out, no completion time recorded
  • verifyError – a completed operation was received, but the data it contained did not match the expected data, no completion time recorded


Can be combined with an event format for event-based analytics, see Event Formats.

JitterAvgDSJ Jitter – Dst to Src integer G The average of positive and negative jitter values from destination to source.
Timeseries Data: Stats, Formats & Options
JitterAvgSDJ Jitter – Src to Dst integer G The average of positive and negative jitter values from source to destination.
Timeseries Data: Stats, Formats & Options
JitterMaxNegDS Jitter – Neg Dst to Src Max integer G The maximum of all absolute negative jitter values from packets sent from destination to source
Timeseries Data: Stats, Formats & Options
JitterMaxNegSD Jitter – Neg Src to Dst Max integer G The maximum of all absolute negative jitter values from packets sent from source to destination.
Timeseries Data: Stats, Formats & Options
JitterMaxPosDS Jitter – Pos Dst to Src Max integer G The maximum of all positive jitter values from packets sent from destination to source
Timeseries Data: Stats, Formats & Options
JitterMaxPosSD Jitter – Pos Src to Dst Max integer G The maximum of all positive jitter values from packets sent from source to destination.
Timeseries Data: Stats, Formats & Options
JitterMinNegDS Jitter – Neg Dst to Src Min integer G The minimum of all absolute negative jitter values from packets sent from destination to source
Timeseries Data: Stats, Formats & Options
JitterMinNegSD Jitter – Neg Src to Dst Min integer G The minimum of all absolute negative jitter values from packets sent from source to destination.
Timeseries Data: Stats, Formats & Options
JitterMinPosDS Jitter – Pos Dst to Src Min integer G The maximum of all positive jitter values from packets sent from destination to source
Timeseries Data: Stats, Formats & Options
JitterMinPosSD Jitter – Pos Src to Dst Min integer G The maximum of all positive jitter values from packets sent from source to destination.
Timeseries Data: Stats, Formats & Options
JitterRTTAvg Latency – RTT Avg integer G The average latency from of the measured RTT’s
Timeseries Data: Stats, Formats & Options
JitterRTTMax Latency – RTT Max integer G The maximum of RTT’s that were successfully measured.
Timeseries Data: Stats, Formats & Options
JitterRTTMin Latency – RTT Min integer G The minimum of RTT’s that were successfully measured.
Timeseries Data: Stats, Formats & Options
LatencyAvgDS Latency – Dst to Src integer G The average latency from source to destination.
Timeseries Data: Stats, Formats & Options
LatencyAvgSD Latency – Src to Dest integer G The average latency from source to destination.
Timeseries Data: Stats, Formats & Options
LatestRttOperCompletionTime Latest RTT Completion Time integer G The completion time of the latest RTT operation successfully completed
Timeseries Data: Stats, Formats & Options
TargetAddress Target Address string G The target address of the ipsla probe.
rttMonEchoAdminNumPackets Num RTT’s integer G This value represents the number of packets that need to be transmitted. This value is currently used for Jitter probe. This object is applicable to jitter probe only.
Timeseries Data: Stats, Formats & Options
rttMonLatestJitterOperICPIF ICPIF integer G ICPIF
Timeseries Data: Stats, Formats & Options
rttMonLatestJitterOperMOS MOS integer G MOS
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco NBAR

Description

The custom data entities for the cisco_nbar table

Table

cdt_cisco_nbar

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Interface Interface Name string G, U Interface Name
ProtocolName Protocol Name string G, U Protocol Name
RxBps Rx Bps integer G Tx Bits Per second (Calculated from Bytes)
Timeseries Data: Stats, Formats & Options
RxBytes Rx Bytes integer G The byte count of inbound octets as determined by Protocol Discovery.
Timeseries Data: Stats, Formats & Options
RxPkts Rx Pkts integer G The packet count of inbound packets as determined by Protocol Discovery.
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G The Rx Utilization of this protocol.
Timeseries Data: Stats, Formats & Options
TxBps Tx Bps integer G Tx Bits Per second (Calculated from Bytes)
Timeseries Data: Stats, Formats & Options
TxBytes Tx Bytes integer G The byte count of outbound octets as determined by Protocol Discovery.
Timeseries Data: Stats, Formats & Options
TxPkts Tx Pkts integer G The packet count of outbound packets as determined by Protocol Discovery.
Timeseries Data: Stats, Formats & Options
TxUtil Tx Util float G The Tx Utilization of this protocol.
Timeseries Data: Stats, Formats & Options
Type Type string G Application Monitor Type
Links

This resource has links to the following:

[reference]  [top]

Cisco VPN Sessions

Description

The custom data entities for the cisco_vpn_sessions table

Table

cdt_cisco_vpn_sessions

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
IPSecSessions Established IPSec Sessions integer G The number of IPSec sessions established.
Timeseries Data: Stats, Formats & Options
L2LSessions Established L2L Sessions integer G The number of LAN to LAN sessions established.
Timeseries Data: Stats, Formats & Options
LBSessions Established LB Sessions integer G The number of load balancing sessions established.
Timeseries Data: Stats, Formats & Options
MaxGroupsSuport Maximum Supported Groups integer G, U Maximum number of remote access groups supported.
MaxSessionsSuport Maximum Supported Sessions integer G, U Maximum number of remote access sessions supported.
MaxUsersSuport Maximum Supported Users integer G, U Maximum number of remote access users supported.
SVCSessions Established SVC Sessions integer G The number of secure VPN client sessions sessions established.
Timeseries Data: Stats, Formats & Options
WebvpnSessions Established Webvpn Sessions integer G The number of secure VPN client sessions sessions established.
Timeseries Data: Stats, Formats & Options
activeEmailSessions Active Email Sessions integer G The number of active Email proxy sessions.
Timeseries Data: Stats, Formats & Options
activeGroups Active Groups integer G The number of user groups whose members have active sessions.
Timeseries Data: Stats, Formats & Options
activeIPSecSessions Active IPSec Sessions integer G The number of active IPSec sessions.
Timeseries Data: Stats, Formats & Options
activeL2LSessions Active L2L Sessions integer G The number of active LAN to LAN sessions.
Timeseries Data: Stats, Formats & Options
activeLBSessions Active LB Sessions integer G The number of active load balancing sessions.
Timeseries Data: Stats, Formats & Options
activeSVCSessions Active SVC Sessions integer G The number of active secure VPN client sessions.
Timeseries Data: Stats, Formats & Options
activeSessions Active Sessions integer G Number of active remote access sessions.
Timeseries Data: Stats, Formats & Options
activeUsers Active Users integer G The number of users who have active sessions.
Timeseries Data: Stats, Formats & Options
activeWebvpnSessions Active Webvpn Sessions integer G The number of secure VPN client sessions.
Timeseries Data: Stats, Formats & Options
emailSessions Established Email Sessions integer G The number of Email proxy sessions established.
Timeseries Data: Stats, Formats & Options
maxSvcSessions Max Concurrent SVC Sessions integer G Maximum number of concurrent SVC sessions since system up.
Timeseries Data: Stats, Formats & Options
prevSessions Previous Sessions integer G The number of remote access sessions which were previously active but which where since terminated.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco WAN 3G

Description

The custom data entities for the cisco_wan_3g table

Table

cdt_cisco_wan_3g

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
GsmCountry GSM Country string G, U GSM Country
GsmEcIo GSM Ec/Io integer G GSM Ec/Io
Timeseries Data: Stats, Formats & Options
GsmNetwork GSM Network string G, U GSM Network
GsmRSSI GSM RSSI integer G GSM RSSI
Timeseries Data: Stats, Formats & Options
IMEI IMEI string G International Mobile Equipment Identifier
ModemTemp Modem Temperature integer G The modem temperature in degrees celsius
Timeseries Data: Stats, Formats & Options
NearbyCells Nearby Cells integer G The current total number of nearby cells in the c3gGsmNearbyCellTable.
Timeseries Data: Stats, Formats & Options
RetriesRemaining Retries Remaining integer G Indicates the number of attempts remaining in case the SIM is locked. If the number of retries becomes zero, the SIM is blocked and becomes unusable.
Timeseries Data: Stats, Formats & Options
RxBytes Rx Bytes integer G Rx Bytes
Timeseries Data: Stats, Formats & Options
TxBytes Tx Bytes integer G Tx Bytes
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco WAN 3G Nearby Cells

Description

The custom data entities for the cisco_wan_3g_nearby_cells table

Table

cdt_cisco_wan_3g_nearby_cells

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
EcIoMeasurement EcIo Measurement integer G EcIo Measurement
Timeseries Data: Stats, Formats & Options
PrimaryScramblingCode Primary Scrambling Code integer G Primary Scrambling Code
Timeseries Data: Stats, Formats & Options
RSCP RSCP integer G Received Signal Code Power (RSCP).
Timeseries Data: Stats, Formats & Options
wan3gIndex Cisco WAN 3G Index string G Index to parent cisco_wan_3g entity.
Links

This resource has links to the following:

[reference]  [top]

Cisco WAN 4G

Description

The custom data entities for the cisco_wan_4g table

Table

cdt_cisco_wan_4g

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
operatingBand Operating Band integer G Operating Band
Timeseries Data: Stats, Formats & Options
rsrp Reference Signal Receive Power (RSRP) integer G Reference Signal Receive Power (RSRP)
Timeseries Data: Stats, Formats & Options
rsrq Reference Signal Receive Quality (RSRQ) integer G Reference Signal Receive Quality (RSRQ)
Timeseries Data: Stats, Formats & Options
sinr Signal-to-Interference plus Noise Ratio (SINR) integer G Signal-to-Interference plus Noise Ratio (SINR)
Timeseries Data: Stats, Formats & Options
snr Signal to Noise Ratio(SNR) integer G Signal to Noise Ratio(SNR)
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Citrix Netscaler AAA Stats

Description

The custom data entities for the citrix_netscaler_vpn_stats table

Table

cdt_citrix_netscaler_vpn_stats

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AuthFail Auth Fail Count integer G Count of authentication failures
Timeseries Data: Stats, Formats & Options
AuthNonHttpFail Non-HTTP Fail Count integer G Count of non HTTP connections that failed authorization
Timeseries Data: Stats, Formats & Options
AuthNonHttpSuccess Non-HTTP Success Count integer G Count of non HTTP connections that succeeded authorization
Timeseries Data: Stats, Formats & Options
AuthOnlyHttpFail HTTP Fail Count integer G Count of HTTP connections that failed authorization
Timeseries Data: Stats, Formats & Options
AuthOnlyHttpSuccess HTTP Success Count integer G Count of HTTP connections that succeeded authorization
Timeseries Data: Stats, Formats & Options
AuthSuccess Auth Success Count integer G Count of authentication successes
Timeseries Data: Stats, Formats & Options
CurICAOnlyConn ICA Only Connections integer G Count of current ICA only connections
Timeseries Data: Stats, Formats & Options
CurICASessions ICA Only Sessions integer G Count of current ICA only sessions
Timeseries Data: Stats, Formats & Options
CurSessions AAA Currrent Sessions integer G Count of all AAA current sessions
Timeseries Data: Stats, Formats & Options
CurTMSessions AAATM Only Sessions integer G Count of current AAATM only sessions
Timeseries Data: Stats, Formats & Options
TotSessionTimeout AAA Total Sessions Timed Out integer G Count of all AAA sessions that have timed out
Timeseries Data: Stats, Formats & Options
TotSessions AAA Total Sessions integer G Count of all AAA sessions
Timeseries Data: Stats, Formats & Options
TotTMSessions AAATM Total Sessions integer G Count of all AAATM sessions
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Riverbed WAN Accelerator

Description

The custom data entities for the connections_riverbed table

Table

cdt_connections_riverbed

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
LANRxOptBps LANRxOpt Bps float G Total optimized bytes across all application ports, in the WAN to LAN direction since the last restart of service, as measured on the LAN side.
Timeseries Data: Stats, Formats & Options
LANRxTotal LANRxTotal Bytes integer G Rx Optimized + Rx Passthrough Bytes over LAN
Timeseries Data: Stats, Formats & Options
LANRxTotalBps LANRxTotalBps float G Rx Optimized + Rx Passthrough Bytes over LAN
Timeseries Data: Stats, Formats & Options
LANTotal LAN Total Bytes integer G LAN Rx + Tx Total Bytes
Timeseries Data: Stats, Formats & Options
LANTotalBps LAN Total Bps float G LAN Rx + Tx Total Bytes
Timeseries Data: Stats, Formats & Options
LANTxOptBps LANTxOpt Bps float G Total optimized bytes across all application ports, in the LAN to WAN direction since the last restart of service, as measured on the LAN side
Timeseries Data: Stats, Formats & Options
LANTxTotal LANTxTotal Bytes integer G Tx Optimized + Tx Passthrough Bytes over LAN
Timeseries Data: Stats, Formats & Options
LANTxTotalBps LANTxTotal Bps float G Tx Optimized + Tx Passthrough Bytes over LAN
Timeseries Data: Stats, Formats & Options
PassThroughRxBps PassThrough WAN to LAN Bps float G Passthrough Bps in WAN to LAN direction.
Timeseries Data: Stats, Formats & Options
PassThroughTxBps PassThrough LAN to WAN Bps float G Passthrough Bps in LAN to WAN direction.
Timeseries Data: Stats, Formats & Options
TotalLANOptBps LAN Optimized Total float G LAN Optimized Total Bps
Timeseries Data: Stats, Formats & Options
TotalPassThroughBps PassThrough Total Bps float G Passthrough Bps in LAN to WAN direction.
Timeseries Data: Stats, Formats & Options
TotalWANOptBps Total WAN Optimized Bps float G WAN Optimized Total Bps
Timeseries Data: Stats, Formats & Options
WANOptTotal WAN Optimized Total Bytes integer G Bytes WAN Optimized Total
Timeseries Data: Stats, Formats & Options
WANRxOptBps WANRxOpt Bps float G Total optimized bytes across all application ports, in the WAN to LAN direction since the last restart of service, as measured on the WAN side.
Timeseries Data: Stats, Formats & Options
WANRxTotal WANRxTotal Bytes integer G Rx Optimized + Rx Passthrough Bytes over WAN
Timeseries Data: Stats, Formats & Options
WANRxTotalBps WANRxTotal Bps float G Rx Optimized + Rx Passthrough Bytes over WAN
Timeseries Data: Stats, Formats & Options
WANTotal WAN Total Bytes integer G WANRx + Tx Total Bytes
Timeseries Data: Stats, Formats & Options
WANTotalBps WAN Total Bps float G WAN Rx + Tx Total Bps
Timeseries Data: Stats, Formats & Options
WANTxOptBps WANTxOpt Bps float G Total optimized bytes across all application ports, in the LAN to WAN direction since the last restart of service, as measured on the WAN side.
Timeseries Data: Stats, Formats & Options
WANTxTotal WANTxTotal Bytes integer G Tx Optimized + Tx Passthrough Bytes over WAN
Timeseries Data: Stats, Formats & Options
WANTxTotalBps WANTxTotal Bps float G Tx Optimized + Tx Passthrough Bytes over WAN
Timeseries Data: Stats, Formats & Options
activeConnections Connections Active integer G Current number of active (optimized) connections
Timeseries Data: Stats, Formats & Options
bpsReduction Reduction Bps integer G Bps Reduction
Timeseries Data: Stats, Formats & Options
bwAggHCOutWan WANTxOpt Bytes integer G Total optimized bytes across all application ports, in the LAN to WAN direction since the last restart of service, as measured on the WAN side
Timeseries Data: Stats, Formats & Options
bwHCAggInLan LANRxOpt Bytes integer G Total optimized bytes across all application ports, in the WAN to LAN direction since the last restart of service, as measured on the LAN side
Timeseries Data: Stats, Formats & Options
bwHCAggInWan WANRxOpt Bytes integer G Total optimized bytes across all application ports, in the WAN to LAN direction since the last restart of service, as measured on the WAN side
Timeseries Data: Stats, Formats & Options
bwHCAggOutLan LANTxOpt Bytes integer G Total optimized bytes across all application ports, in the LAN to WAN direction since the last restart of service, as measured on the LAN side
Timeseries Data: Stats, Formats & Options
bwPassThroughIn Bytes PassThrough WAN to LAN integer G Passthrough bytes in WAN to LAN direction
Timeseries Data: Stats, Formats & Options
bwPassThroughOut Bytes PassThrough LAN to WAN integer G Passthrough bytes in LAN to WAN direction
Timeseries Data: Stats, Formats & Options
bwPassThroughTotal Passthrough Total Bytes integer G Total passthrough bytes
Timeseries Data: Stats, Formats & Options
bytesReduction Reduction Bytes integer G Bytes Reduction
Timeseries Data: Stats, Formats & Options
establishedConnections Connections Established integer G Current number of established (optimized) connections
Timeseries Data: Stats, Formats & Options
halfClosedConnections Connections Half Closed integer G Current total number of half-closed (optimized) connections
Timeseries Data: Stats, Formats & Options
halfOpenedConnections Connections Half Opened integer G Current total number of half-opened (optimized) connections
Timeseries Data: Stats, Formats & Options
health Health string G, U Current health of the system, one of:

  • Admission
  • Control
  • Critical
  • Degraded
  • Healthy


Can be combined with an event format for event-based analytics, see Event Formats.

optimizedConnections Connections Optimized integer G Current total number of optimized connections
Timeseries Data: Stats, Formats & Options
passthroughConnections Connections Passthrough integer G Current total number of pass-through connections
Timeseries Data: Stats, Formats & Options
percentConnections Connections Used Percent float G Percentage of total connections in use.
Timeseries Data: Stats, Formats & Options
shMaxBandwidth Max Bandwidth integer G Maximum possible bandwidth for this appliance
Timeseries Data: Stats, Formats & Options
shMaxConnections Connections Max Optimized integer G Maximum possible connections through this appliance
Timeseries Data: Stats, Formats & Options
totalConnections Connections Total Current integer G Total number of connections
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

CPU

Description

The custom data entities for the cpu table

Table

cdt_cpu

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Alcatel

Description

The custom data entities for the cpu_alcatel table

Table

cdt_cpu_alcatel

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Alcatel – AOS7

Description

The custom data entities for the cpu_alcatel_aos7 table

Table

cdt_cpu_alcatel_aos7

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Alteon

Description

The custom data entities for the cpu_alteon table

Table

cdt_cpu_alteon

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Aruba

Description

The custom data entities for the cpu_aruba table

Table

cdt_cpu_aruba

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Avaya RC

Description

The custom data entities for the cpu_avaya_rc table

Table

cdt_cpu_avaya_rc

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Avaya S5

Description

The custom data entities for the cpu_avaya_s5 table

Table

cdt_cpu_avaya_s5

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Cisco

Description

The custom data entities for the cpu_cisco table

Table

cdt_cpu_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Cisco ASA

Description

The custom data entities for the cpu_cisco_asa table

Table

cdt_cpu_cisco_asa

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Cisco Nexus

Description

The custom data entities for the cpu_cisco_nexus table

Table

cdt_cpu_cisco_nexus

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Cisco SAN

Description

The custom data entities for the cpu_cisco_san table

Table

cdt_cpu_cisco_san

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Dell

Description

The custom data entities for the cpu_dell table

Table

cdt_cpu_dell

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
agentSwitchCpuProcessTotalUtilizationSixty CPU Load integer G Total CPU utilization over a period of 60 seconds.
Timeseries Data: Stats, Formats & Options
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Dell F10 S

Description

The custom data entities for the cpu_dell_F10_S table

Table

cdt_cpu_dell_F10_S

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Dell DNOS

Description

The custom data entities for the cpu_dell_dnos table

Table

cdt_cpu_dell_dnos

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Dell X Series

Description

The custom data entities for the cpu_dell_x table

Table

cdt_cpu_dell_x

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
rlCpuUtilDuringLastMinute CPU Load integer G Total CPU utilization over a period of 60 seconds.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

CPU – Extreme

Description

The custom data entities for the cpu_extreme table

Table

cdt_cpu_extreme

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Extreme VSP

Description

The custom data entities for the cpu_extreme_vsp table

Table

cdt_cpu_extreme_vsp

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Fortinet Fortigate

Description

The custom data entities for the cpu_fortinet_fortigate table

Table

cdt_cpu_fortinet_fortigate

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Foundry

Description

The custom data entities for the cpu_foundry table

Table

cdt_cpu_foundry

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Foundry MLX

Description

The custom data entities for the cpu_foundry_mlx table

Table

cdt_cpu_foundry_mlx

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Juniper

Description

The custom data entities for the cpu_juniper table

Table

cdt_cpu_juniper

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G, U Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Juniper Pulse

Description

The custom data entities for the cpu_juniper_pulse table

Table

cdt_cpu_juniper_pulse

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – NetScaler

Description

The custom data entities for the cpu_netscaler table

Table

cdt_cpu_netscaler

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Netscreen

Description

The custom data entities for the cpu_netscreen table

Table

cdt_cpu_netscreen

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Nokia

Description

The custom data entities for the cpu_nokia table

Table

cdt_cpu_nokia

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

CPU – Server

Description

The custom data entities for the cpu_server table

Table

cdt_cpu_server

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cpuDescr Description string G Description
cpuLoad Load Percentage float G Load Percentage
Timeseries Data: Stats, Formats & Options
cpuType Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

Dell DNOS System Information

Description

The custom data entities for the dell_inventory table

Table

cdt_dell_inventory

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
dellNetStackUnitModelId Model string G, U The Dell Networking OS Model number for this unit.
description Description string G, U Inventory Description
model Model string G, U Inventory Model
serial Serial Number string G, U Serial Number
softwareRev Software Revision string G, U Software Revision
vendor Vendor string G Inventory Vendor
Links

This resource has links to the following:

[reference]  [top]

Device

Description

The custom data entities for the device table

Table

cdt_device

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G, U The poll state of the entity

  • on
  • off
auth_method SNMPv3 Authentication Method string G, U, A Authentication method for SNMPv3 devices, one of:

  • md5
  • sha
auth_pass SNMPv3 Authentication Password string G, U, A Authentication password for SNMPv3 devices
auth_user SNMPv3 Authentication Username string G, U, A Authentication user for SNMPv3 devices
community Community string G, U, A The community string status of the device
context SNMPv3 Context string G, U, A Context for SNMPv3 devices
custom_data_details Custom Data Details string G, U A JSON string object indicating which custom entities have been found during a discovery
discover_getNext Use GetNext string G, U Walk this device using SNMP getNext instead of getBulk, one of:

  • 0
  • 1
discover_minimal Use Minimal Walk string G, U Walk this device using a minimal set of oids, one of:

  • 0
  • 1
discover_snmpv1 Use SNMPv1 string G, U Walk this device using SNMPv1, one of:

  • 0
  • 1
hostname Hostname string G, U, A The hostname of the device
ipaddress IP Address string G, U, A (required) The IP address of the device
latitude Latitude float G, U The user defined latitude of the device’s location
longitude Longitude float G, U The user defined longitude of the device’s location
manual_name User Defined Name string G, U The user defined name of the device
memorySize Memory Size integer G The amount of physical read-write memory contained by the entity
mis MAC/IP/Switch Collection State string G, U Include this device in the MIS report calculations, one of

  • on
  • off
ping_dup Ping Duplicate integer G Number of duplicate ping responses received
Timeseries Data: Stats, Formats & Options
ping_lost1 Ping Lost 1 integer G Number of times that a single ping request is lost
Timeseries Data: Stats, Formats & Options
ping_lost2 Ping Lost 2 integer G Number of times that two ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_lost3 Ping Lost 3 integer G Number of times that three ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_lost4 Ping Lost 4 integer G Number of times that four ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_outage Ping Outage integer G, U Number of seconds to wait before a device is considered to be down
ping_poll Ping Poll string G, U, A The ping polling status of the device, one of:

  • on
  • off
ping_rtt Ping RTT integer G The current ping state of the device
Timeseries Data: Stats, Formats & Options
ping_rtt_ms Ping RTT(High Precision) float G The current ping state of the device in ms to 3 decimal places
Timeseries Data: Stats, Formats & Options
ping_state Ping State string G, U The current ping state of the device, one of:

  • up
  • down

Can be combined with an event format for event-based analytics, see Event Formats.

priv_method SNMPv3 Privacy Method string G, U, A Privacy method for SNMPv3 devices, one of:

  • aes
  • aes192
  • aes256
  • des
  • des3
priv_pass SNMPv3 Privacy Password string G, U, A Privacy password for SNMPv3 devices
retired Retired string G The device has been Retired, one of:

  • on
  • off
snmpEngineID SNMP Engine ID string G, U An SNMP engine’s administratively-unique identifier
snmp_maxoid SNMP Max OID integer G, U Maximum number of oids to poll in a single request
snmp_poll SNMP Poll string G, U, A The SNMP polling status of the device, one of:

  • on
  • off
snmp_version SNMP Version integer G, U, A The SNMP version of the device, one of:

  • 1
  • 2
  • 3
sysContact Contact string G, U The textual identification of the contact person for the entity
sysDescr System Description string G, U A textual description of the entity
sysLocation Location string G, U The physical location of the entity
sysName System Name string G, U An administratively-assigned name for the entity
sysObjectID Object ID string G, U The vendor’s authoritative identification of the network management subsystem contained in the entity
sysServices Services integer G, U A value which indicates the set of services that the entity may potentially offer
vendor Vendor string G The vendor name for the device
Links

This resource has links to the following:

[reference]  [top]

[reference]  [top]

APIC

Description

The custom data entities for the device_apic table

Table

cdt_device_apic

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
auth_method SNMPv3 Authentication Method string G Authentication method for SNMPv3 devices, one of:

  • md5
  • sha
auth_pass SNMPv3 Authentication Password string G Authentication password for SNMPv3 devices
auth_user SNMPv3 Authentication Username string G Authentication user for SNMPv3 devices
community Community string G The community string status of the device
context SNMPv3 Context string G Context for SNMPv3 devices
custom_data_details Custom Data Details string G A JSON string object indicating which custom entities have been found during a discovery
discover_getNext Use GetNext string G Walk this device using SNMP getNext instead of getBulk, one of:

  • 0
  • 1
discover_minimal Use Minimal Walk string G Walk this device using a minimal set of oids, one of:

  • 0
  • 1
discover_snmpv1 Use SNMPv1 string G Walk this device using SNMPv1, one of:

  • 0
  • 1
health Health integer G Health
Timeseries Data: Stats, Formats & Options
hostname Hostname string G The hostname of the device
ipaddress IP Address string G The IP address of the device
latitude Latitude float G The user defined latitude of the device’s location
longitude Longitude float G The user defined longitude of the device’s location
manual_name User Defined Name string G The user defined name of the device
memorySize Memory Size integer G The amount of physical read-write memory contained by the entity
mis MAC/IP/Switch Collection State string G Include this device in the MIS report calculations, one of

  • on
  • off
noApplications Application Profiles integer G Number of Application Profiles
Timeseries Data: Stats, Formats & Options
noBridgeDomains Bridging Domains integer G Number of Bridging Domains
Timeseries Data: Stats, Formats & Options
noCEPs Client Endpoints integer G Number of Client Endpoints
Timeseries Data: Stats, Formats & Options
noControllers Controllers integer G Number of Controllers
Timeseries Data: Stats, Formats & Options
noEPGs Endpoint Groups integer G Number of Endpoint Groups
Timeseries Data: Stats, Formats & Options
noLeaves Leaves integer G Number of Leaves
Timeseries Data: Stats, Formats & Options
noNodes Nodes integer G Number of Nodes
Timeseries Data: Stats, Formats & Options
noPods Pods integer G Number of Pods
Timeseries Data: Stats, Formats & Options
noSpines Spines integer G Number of Spines
Timeseries Data: Stats, Formats & Options
noTenants Tenants integer G Number of Tenants
Timeseries Data: Stats, Formats & Options
noVRFs VRFs integer G Number of VRFs
Timeseries Data: Stats, Formats & Options
ping_dup Ping Duplicate integer G Number of duplicate ping responses received
Timeseries Data: Stats, Formats & Options
ping_lost1 Ping Lost 1 integer G Number of times that a single ping request is lost
Timeseries Data: Stats, Formats & Options
ping_lost2 Ping Lost 2 integer G Number of times that two ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_lost3 Ping Lost 3 integer G Number of times that three ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_lost4 Ping Lost 4 integer G Number of times that four ping requests in a row have been lost
Timeseries Data: Stats, Formats & Options
ping_outage Ping Outage integer G Number of seconds to wait before a device is considered to be down
ping_poll Ping Poll string G The ping polling status of the device, one of:

  • on
  • off
ping_rtt Ping RTT integer G The current ping state of the device
Timeseries Data: Stats, Formats & Options
ping_rtt_ms Ping RTT(High Precision) float G The current ping state of the device in ms to 3 decimal places
Timeseries Data: Stats, Formats & Options
ping_state Ping State string G The current ping state of the device, one of:

  • up
  • down

Can be combined with an event format for event-based analytics, see Event Formats.

priv_method SNMPv3 Privacy Method string G Privacy method for SNMPv3 devices, one of:

  • aes
  • aes192
  • aes256
  • des
  • des3
priv_pass SNMPv3 Privacy Password string G Privacy password for SNMPv3 devices
retired Retired string G The device has been Retired, one of:

  • on
  • off
snmpEngineID SNMP Engine ID string G An SNMP engine’s administratively-unique identifier
snmp_maxoid SNMP Max OID integer G Maximum number of oids to poll in a single request
snmp_poll SNMP Poll string G The SNMP polling status of the device, one of:

  • on
  • off
snmp_version SNMP Version integer G The SNMP version of the device, one of:

  • 1
  • 2
  • 3
sysContact Contact string G The textual identification of the contact person for the entity
sysDescr System Description string G A textual description of the entity
sysLocation Location string G The physical location of the entity
sysName System Name string G An administratively-assigned name for the entity
sysObjectID Object ID string G The vendor’s authoritative identification of the network management subsystem contained in the entity
sysServices Services integer G A value which indicates the set of services that the entity may potentially offer
vendor Vendor string G The vendor name for the device
[reference]  [top]

Environment Monitors

Description

The custom data entities for the env_mon table

Table

cdt_env_mon

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

APC Internal Environment Monitor

Description

The custom data entities for the env_mon_apc_internal table

Table

cdt_env_mon_apc_internal

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G, U Status, one of:

  • connected
  • disconnected
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G, U Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Enviromux Environmental Monitoring – External – DewPoint

Description

The custom data entities for the env_mon_enviromux_external_dewpoint table

Table

cdt_env_mon_enviromux_external_dewpoint

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Enviromux Environmental Monitoring – External – Humidity

Description

The custom data entities for the env_mon_enviromux_external_humidity table

Table

cdt_env_mon_enviromux_external_humidity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Enviromux Environmental Monitoring – External – Temperature

Description

The custom data entities for the env_mon_enviromux_external_temperature table

Table

cdt_env_mon_enviromux_external_temperature

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Enviromux Environmental Monitoring – Internal – DewPoint

Description

The custom data entities for the env_mon_enviromux_internal_dewpoint table

Table

cdt_env_mon_enviromux_internal_dewpoint

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Enviromux Environmental Monitoring – Internal – Humidty

Description

The custom data entities for the env_mon_enviromux_internal_humidity table

Table

cdt_env_mon_enviromux_internal_humidity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Enviromux Environmental Monitoring – Internal – Temperature

Description

The custom data entities for the env_mon_enviromux_internal_temperature table

Table

cdt_env_mon_enviromux_internal_temperature

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer G Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Geist Internal Environment Monitor

Description

The custom data entities for the env_mon_geist_internal table

Table

cdt_env_mon_geist_internal

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G Status
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

Interseptor Environment Monitor

Description

The custom data entities for the env_mon_interseptor table

Table

cdt_env_mon_interseptor

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DewPoint Environment Dew Point integer Environment Dew Point
Timeseries Data: Stats, Formats & Options
Humidity Environment Humidity integer G Environment Humidity
Timeseries Data: Stats, Formats & Options
Status Status string G, U Status, one of:

  • unknown
  • disabled
  • eMD-HT
  • eMD-T
Temperature Environment Temperature integer G Environment Temperature
Timeseries Data: Stats, Formats & Options
TemperatureUnit Environment Temperature Units string G, U Environment Temperature Units
Type Type string G Type
Links

This resource has links to the following:

[reference]  [top]

F5 APM Sessions

Description

The custom data entities for the f5_apm_sessions table

Table

cdt_f5_apm_sessions

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
curConns Active SSL/VPN Connections integer G The total current SSL/VPN connections in the system
Timeseries Data: Stats, Formats & Options
currentActiveSessions Active Sessions integer G The total active user sessions in the system
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

F5 Firewall Connections

Description

The custom data entities for the f5_firewall_connections table

Table

cdt_f5_firewall_connections

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
clientCurConns Current Client Connections integer G The current connections from client side.
Timeseries Data: Stats, Formats & Options
clientMaxConns Max Client Connections integer G The maximum connections from client side.
Timeseries Data: Stats, Formats & Options
clientSSLAvgConns SSL Avg Connections per second integer G The average total SSL connections from client-side to the system in the last five minutes.
Timeseries Data: Stats, Formats & Options
clientSSLCurConns SSL Current Connections integer G The current number of concurrent connections with established SSL sessions being maintained by the filter.
Timeseries Data: Stats, Formats & Options
clientTotConns Total Client Connections integer G The total connections from client side.
Timeseries Data: Stats, Formats & Options
connectionMemoryErrors Connection Errors – Memory Full integer G The errors of that connection could not be created because memory was not available.
Timeseries Data: Stats, Formats & Options
currPvaAssistConn Current PVA Assisted Connections integer G The current number of the connections that are partially accelerated.
Timeseries Data: Stats, Formats & Options
maintenanceModeDeny Connection Errors – Maintenance integer G The connection requests rejected because the virtual server was in maintenance mode.
Timeseries Data: Stats, Formats & Options
maxConnVirtualPathDeny Connection Errors – Over Limit integer G The connection requests rejected because they exceeded the connection limit for a virtual server (IP:port).
Timeseries Data: Stats, Formats & Options
pvaClientCurConns Current PVA Client Connections integer G The current connections from PVA client side.
Timeseries Data: Stats, Formats & Options
pvaClientMaxConns Max PVA Client Connections integer G The maximum connections from PVA client side.
Timeseries Data: Stats, Formats & Options
pvaClientTotConns Total PVA Client Connections integer G The total connections from PVA client side.
Timeseries Data: Stats, Formats & Options
pvaServerCurConns Current PVA Server Connections integer G The current connections from PVA server side.
Timeseries Data: Stats, Formats & Options
pvaServerMaxConns Max PVA Server Connections integer G The maximum connections from PVA server side.
Timeseries Data: Stats, Formats & Options
pvaServerTotConns Total PVA Server Connections integer G The total connections from PVA server side.
Timeseries Data: Stats, Formats & Options
serverCurConns Current Server Connections integer G The current connections from server side.
Timeseries Data: Stats, Formats & Options
serverMaxConns Max Server Connections integer G The maximum connections from server side.
Timeseries Data: Stats, Formats & Options
serverTotConns Total Server Connections integer G The total connections from server side.
Timeseries Data: Stats, Formats & Options
totPvaAssistConn Total PVA Assisted Connections integer G The total number of the connections that are partially accelerated.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

F5 Load Balancer LTM Pool

Description

The custom data entities for the f5_loadbalancer_ltm_pool table

Table

cdt_f5_loadbalancer_ltm_pool

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
activeMembers Active Members integer G The number of the current active members in the specified pool.
Timeseries Data: Stats, Formats & Options
availState Availability Color string G The availability of the specified pool indicated in color.
Can be combined with an event format for event-based analytics, see Event Formats.
bytesIn Rx Bytes integer G The number of bytes received by the specified pool from server-side.
Timeseries Data: Stats, Formats & Options
bytesOut Tx Bytes integer G The number of bytes sent to server-side from the specified pool.
Timeseries Data: Stats, Formats & Options
curConns Current Client Connections integer G The current connections from server-side to the specified pool.
Timeseries Data: Stats, Formats & Options
maxConns Max Client Connections integer G The maximum connections from server-side to the specified pool.
Timeseries Data: Stats, Formats & Options
pktsIn Rx Pkts integer G The number of packets received by the specified pool from server-side.
Timeseries Data: Stats, Formats & Options
pktsOut Tx Pkts integer G The number of packets sent to server-side from the specified pool.
Timeseries Data: Stats, Formats & Options
poolName Pool Name string G, U The Name of the pool
totConns Total Client Connections integer G The total connections from server-side to the specified pool.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

F5 Load Balancer LTM Pool Member

Description

The custom data entities for the f5_loadbalancer_ltm_pool_member table

Table

cdt_f5_loadbalancer_ltm_pool_member

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
availState Availability Color string G The availability of the specified pool member indicated in color.
Can be combined with an event format for event-based analytics, see Event Formats.
bytesIn Rx Bytes integer G The number of bytes received by the specified pool from server-side.
Timeseries Data: Stats, Formats & Options
bytesOut Tx Bytes integer G The number of bytes sent to server-side from the specified pool.
Timeseries Data: Stats, Formats & Options
curConns Current Client Connections integer G The current connections from server-side to the specified pool.
Timeseries Data: Stats, Formats & Options
enabledState Enabled State string G The activity status of the specified pool member, as specified by the user.
Can be combined with an event format for event-based analytics, see Event Formats.
ipaddress IP Address string G The IP address of a pool member in the specified pool.
maxConns Max Client Connections integer G The maximum connections from server-side to the specified pool.
Timeseries Data: Stats, Formats & Options
nodeName Node Name string G The Name of the Node.
pktsIn Rx Pkts integer G The number of packets received by the specified pool from server-side.
Timeseries Data: Stats, Formats & Options
pktsOut Tx Pkts integer G The number of packets sent to server-side from the specified pool.
Timeseries Data: Stats, Formats & Options
poolName Pool Name string G The Name of the Pool.
portNumber Port Number integer G The port number of the specified pool member.
totConns Total Client Connections integer G The total connections from server-side to the specified pool.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

F5 Load Balancer LTM Virtual Server

Description

The custom data entities for the f5_loadbalancer_ltm_virtual_server table

Table

cdt_f5_loadbalancer_ltm_virtual_server

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
availState Availability Color string G The availability of the specified virtual server indicated in color.
Can be combined with an event format for event-based analytics, see Event Formats.
bytesIn Rx Bytes integer G The number of bytes received by the specified virtual server from client-side.
Timeseries Data: Stats, Formats & Options
bytesOut Tx Bytes integer G The number of bytes sent to client-side from the specified virtual server.
Timeseries Data: Stats, Formats & Options
csMaxConnDur Max Connection Time integer G The maximum connection duration in milliseconds among all connections through the specified virtual server.
Timeseries Data: Stats, Formats & Options
csMeanConnDur Average Connection Time integer G The average connection duration in milliseconds for all connections through the specified virtual server.
Timeseries Data: Stats, Formats & Options
csMinConnDur Minimum Connection Time integer G The minimum connection duration in milliseconds among all connections through the specified virtual server.
Timeseries Data: Stats, Formats & Options
curConns Current Client Connections integer G The current connections from client-side to the specified virtual server.
Timeseries Data: Stats, Formats & Options
currentConnsPerSec Connections/Sec integer G The number of current connections per second to the specified virtual server.
Timeseries Data: Stats, Formats & Options
defaultPool Default Pool string G, U The name of a default pool used by the specified virtual server.
enabledState Enabled State string G The activity status of the specified virtual server, as specified by the user.
Can be combined with an event format for event-based analytics, see Event Formats.
ipNetmask IP Netmask string G The wildcard netmask of the specified virtual server. It is interpreted within the context of an ltmVitualServWildmaskType value.
ipProtocol IP protocol integer G, U The IP protocol (see RFC 1340) used by the specified virtual server.
ipaddress IP Address string G The IP address of the specified virtual server.
maxConns Max Client Connections integer G The maximum connections from client-side to the specified virtual server.
Timeseries Data: Stats, Formats & Options
pktsIn Rx Pkts integer G The number of packets received by the specified virtual server from client-side.
Timeseries Data: Stats, Formats & Options
pktsOut Tx Pkts integer G The number of packets sent to client-side from the specified virtual server.
Timeseries Data: Stats, Formats & Options
portNumber Port Number integer G, U The port number of the specified virtual server.
totConns Total Client Connections integer G The total connections from client-side to the specified virtual server.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Fan

Description

The custom data entities for the fan_sensor table

Table

cdt_fan_sensor

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
rpm RPM integer G shaft revolutions per minute
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Fan – Cisco

Description

The custom data entities for the fan_sensor_cisco table

Table

cdt_fan_sensor_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
rpm RPM integer G shaft revolutions per minute
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Fan – Entity

Description

The custom data entities for the fan_sensor_entity table

Table

cdt_fan_sensor_entity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
rpm RPM integer G shaft revolutions per minute
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

File System

Description

The custom data entities for the filesystem table

Table

cdt_filesystem

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
storageAllocationUnits DEPRECATED Allocation Units integer G DEPRECATED
storageDesc Description string G Eg: Mount point, fs type
storageFree Free The amount of storage free in Bytes.
Timeseries Data: Stats, Formats & Options
storageFreePercent Free Percent The amount of storage free as a percentage.
Timeseries Data: Stats, Formats & Options
storageSize Size integer G The size of the storage in Bytes.
Timeseries Data: Stats, Formats & Options
storageType Vendor string G Vendor
storageUsed Used The amount of storage used in Bytes.
Timeseries Data: Stats, Formats & Options
storageUsedPercent Used Percent The amount of storage used as a percentage.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

File System – Host Resources

Description

The custom data entities for the filesystem_hostres table

Table

cdt_filesystem_hostres

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
storageAllocationUnits DEPRECATED Allocation Units integer G DEPRECATED
storageDesc Description string G, U Eg: Mount point, fs type
storageFree Free The amount of storage free in Bytes.
Timeseries Data: Stats, Formats & Options
storageFreePercent Free Percent The amount of storage free as a percentage.
Timeseries Data: Stats, Formats & Options
storageSize Size integer G The size of the storage in Bytes.
Timeseries Data: Stats, Formats & Options
storageType Vendor string G Vendor
storageUsed Used The amount of storage used in Bytes.
Timeseries Data: Stats, Formats & Options
storageUsedPercent Used Percent The amount of storage used as a percentage.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

File System – SNMP Informant

Description

The custom data entities for the filesystem_informant table

Table

cdt_filesystem_informant

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
storageAllocationUnits DEPRECATED Allocation Units integer G DEPRECATED
storageDesc Description string G, U Eg: Mount point, fs type
storageFree Free The amount of storage free in Bytes.
Timeseries Data: Stats, Formats & Options
storageFreePercent Free Percent The amount of storage free as a percentage.
Timeseries Data: Stats, Formats & Options
storageSize Size integer G The size of the storage in Bytes.
Timeseries Data: Stats, Formats & Options
storageType Vendor string G Vendor
storageUsed Used The amount of storage used in Bytes.
Timeseries Data: Stats, Formats & Options
storageUsedPercent Used Percent The amount of storage used as a percentage.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Fortinet Fortigate VPN Stats

Description

The custom data entities for the fortigate_vpn_stats table

Table

cdt_fortigate_vpn_stats

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
fgVpnSslState SSL-VPN Enabled string G, U SSL-VPN Enabled
fgVpnSslStatsActiveTunnels Active SSL Tunnels integer G The current number of active SSL tunnels in the virtual domain
Timeseries Data: Stats, Formats & Options
fgVpnSslStatsActiveWebSessions Active Web Sessions integer G The current number of active SSL web sessions in the virtual domain
Timeseries Data: Stats, Formats & Options
fgVpnSslStatsLoginUsers Active Users integer G The current number of users logged in through SSL-VPN tunnels in the virtual domain
Timeseries Data: Stats, Formats & Options
fgVpnSslStatsMaxTunnels Max SSL Tunnels integer G The maximum number of active SSL tunnels at any one time in the virtual domain
Timeseries Data: Stats, Formats & Options
fgVpnSslStatsMaxUsers Max Users integer G The maximum number of total users that can be logged in at any one time on the virtual domain.
Timeseries Data: Stats, Formats & Options
fgVpnSslStatsMaxWebSessions Max Web Sessions integer G The maximum number of active SSL web sessions at any one time in the virtual domain
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Frame Relay

Description

The custom data entities for the framerelay table

Table

cdt_framerelay

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Discards Discards integer G The number of inbound frames dropped because of format errors, or because the VC is inactive
Timeseries Data: Stats, Formats & Options
Dlci Data Link Connection ID string G The Data Link Connection Identifier for this virtual circuit
InSpeed Rx Speed integer G Interface Input Speed (Statseeker custom attribute)
OutSpeed Tx Speed integer G Interface Output Speed (Statseeker custom attribute)
ReceivedBECNs Rx BECNs integer G Number of frames received from the network indicating backward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedDEs Rx DEs integer G Number of frames received from the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFECNs Rx FECNs integer G Number of frames received from the network indicating forward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFrames Rx Frames integer G Number of frames received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
ReceivedOctets Rx Bytes integer G Number of octets received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G The Rx Utilization
Timeseries Data: Stats, Formats & Options
SentDEs Tx DEs integer G Number of frames sent to the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
SentFrames Tx Frames integer G The number of frames sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
SentOctets Tx Bytes integer G The number of octets sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
State State string G, U Indicates whether the particular virtual circuit is operational, one of:

  • active
  • inactive
  • invalid


Can be combined with an event format for event-based analytics, see Event Formats.

TxUtil Tx Util float G The Tx Utilization
Timeseries Data: Stats, Formats & Options
ifPoll Interface Poll string G, U Polling state of the interface, one of:

  • on
  • off
subifIndex Interface Index string G Index of the connected interface
Links

This resource has links to the following:

[reference]  [top]

Frame Relay – Cisco

Description

The custom data entities for the framerelay_cisco table

Table

cdt_framerelay_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Discards Discards integer G The number of inbound frames dropped because of format errors, or because the VC is inactive
Timeseries Data: Stats, Formats & Options
Dlci Data Link Connection ID string G The Data Link Connection Identifier for this virtual circuit
InSpeed Rx Speed integer G Interface Input Speed (Statseeker custom attribute)
OutSpeed Tx Speed integer G Interface Output Speed (Statseeker custom attribute)
ReceivedBECNs Rx BECNs integer G Number of frames received from the network indicating backward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedDEs Rx DEs integer G Number of frames received from the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFECNs Rx FECNs integer G Number of frames received from the network indicating forward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFrames Rx Frames integer G Number of frames received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
ReceivedOctets Rx Bytes integer G Number of octets received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G The Rx Utilization
Timeseries Data: Stats, Formats & Options
SentDEs Tx DEs integer G Number of frames sent to the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
SentFrames Tx Frames integer G The number of frames sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
SentOctets Tx Bytes integer G The number of octets sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
State State string G, U Indicates whether the particular virtual circuit is operational, one of:

  • active
  • inactive
  • invalid


Can be combined with an event format for event-based analytics, see Event Formats.

TxUtil Tx Util float G The Tx Utilization
Timeseries Data: Stats, Formats & Options
ifPoll Interface Poll string G, U Polling state of the interface, one of:

  • on
  • off
subifIndex Interface Index string G Index of the connected interface
Links

This resource has links to the following:

[reference]  [top]

Frame Relay – Juniper

Description

The custom data entities for the framerelay_juniper table

Table

cdt_framerelay_juniper

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Discards Discards integer G The number of inbound frames dropped because of format errors, or because the VC is inactive
Timeseries Data: Stats, Formats & Options
Dlci Data Link Connection ID string G The Data Link Connection Identifier for this virtual circuit
InSpeed Rx Speed integer G Interface Input Speed (Statseeker custom attribute)
OutSpeed Tx Speed integer G Interface Output Speed (Statseeker custom attribute)
ReceivedBECNs Rx BECNs integer G Number of frames received from the network indicating backward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedDEs Rx DEs integer G Number of frames received from the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFECNs Rx FECNs integer G Number of frames received from the network indicating forward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFrames Rx Frames integer G Number of frames received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
ReceivedOctets Rx Bytes integer G Number of octets received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G The Rx Utilization
Timeseries Data: Stats, Formats & Options
SentDEs Tx DEs integer G Number of frames sent to the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
SentFrames Tx Frames integer G The number of frames sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
SentOctets Tx Bytes integer G The number of octets sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
State State string G, U Indicates whether the particular virtual circuit is operational, one of:

  • active
  • inactive
  • invalid


Can be combined with an event format for event-based analytics, see Event Formats.

TxUtil Tx Util float G The Tx Utilization
Timeseries Data: Stats, Formats & Options
ifPoll Interface Poll string G, U Polling state of the interface, one of:

  • on
  • off
subifIndex Interface Index string G Index of the connected interface
Links

This resource has links to the following:

[reference]  [top]

Frame Relay – Nortel

Description

The custom data entities for the framerelay_nortel table

Table

cdt_framerelay_nortel

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Discards Discards integer G The number of inbound frames dropped because of format errors, or because the VC is inactive
Timeseries Data: Stats, Formats & Options
Dlci Data Link Connection ID string G The Data Link Connection Identifier for this virtual circuit
InSpeed Rx Speed integer G Interface Input Speed (Statseeker custom attribute)
OutSpeed Tx Speed integer G Interface Output Speed (Statseeker custom attribute)
ReceivedBECNs Rx BECNs integer G Number of frames received from the network indicating backward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedDEs Rx DEs integer G Number of frames received from the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFECNs Rx FECNs integer G Number of frames received from the network indicating forward congestion since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
ReceivedFrames Rx Frames integer G Number of frames received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
ReceivedOctets Rx Bytes integer G Number of octets received over this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G The Rx Utilization
Timeseries Data: Stats, Formats & Options
SentDEs Tx DEs integer G Number of frames sent to the network indicating that they were eligible for discard since the virtual circuit was created
Timeseries Data: Stats, Formats & Options
SentFrames Tx Frames integer G The number of frames sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
SentOctets Tx Bytes integer G The number of octets sent from this virtual circuit since it was created
Timeseries Data: Stats, Formats & Options
State State string G, U Indicates whether the particular virtual circuit is operational, one of:

  • active
  • inactive
  • invalid


Can be combined with an event format for event-based analytics, see Event Formats.

TxUtil Tx Util float G The Tx Utilization
Timeseries Data: Stats, Formats & Options
ifPoll Interface Poll string G, U Polling state of the interface, one of:

  • on
  • off
subifIndex Interface Index string G Index of the connected interface
Links

This resource has links to the following:

[reference]  [top]

Fortinet Fortigate Firewall

Description

The custom data entities for the fw_fortinet_fortigate table

Table

cdt_fw_fortinet_fortigate

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
sessionCount Active Sessions integer G Number of active sessions on the device
Timeseries Data: Stats, Formats & Options
sessionCountIpv6 Active IPv6 Sessions integer G Number of active IPv6 sessions on the device
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

IEEE 802.11

Description

The custom data entities for the ieee_80211 table

Table

cdt_ieee_80211

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
macAddress Mac Address string G, U Mac Address
manufacturerName Manufacturer Name string G, U The name of the manufacturer
manufacturerOUI Organizationally Unique Identifier string G, U A 24-bit number that uniquely identifies an organization.
productName Product Name string G, U The name of the product
productVersion Product Version string G, U The version of the product
Links

This resource has links to the following:

[reference]  [top]

Inventory

Description

The custom data entities for the inventory table

Table

cdt_inventory

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G An indication of the general hardware type of the physical entity
description Description string G A textual description of physical entity
firmwareRev Firmware Revision string G The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G The vendor-specific model name identifier string for the physical entity
serial Serial Number string G The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G The vendor-specific software revision string for the physical entity
vendor Vendor string G The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

Device Information

Description

The custom data entities for the inventory_device table

Table

cdt_inventory_device

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G An indication of the general hardware type of the physical entity
description Description string G A textual description of physical entity
firmwareRev Firmware Revision string G The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G The vendor-specific model name identifier string for the physical entity
serial Serial Number string G The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G The vendor-specific software revision string for the physical entity
vendor Vendor string G, U The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

Entity Asset Information

Description

The custom data entities for the inventory_entity table

Table

cdt_inventory_entity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G, U An indication of the general hardware type of the physical entity
description Description string G, U A textual description of physical entity
firmwareRev Firmware Revision string G, U The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G, U The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G, U Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G, U The vendor-specific model name identifier string for the physical entity
physicalName Physical Name string G, U Physical Name
serial Serial Number string G, U The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G, U The vendor-specific software revision string for the physical entity
vendor Vendor string G The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

F5 Asset Information

Description

The custom data entities for the inventory_f5 table

Table

cdt_inventory_f5

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G An indication of the general hardware type of the physical entity
description Description string G A textual description of physical entity
firmwareRev Firmware Revision string G The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G The vendor-specific model name identifier string for the physical entity
serial Serial Number string G The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G The vendor-specific software revision string for the physical entity
vendor Vendor string G The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

F5 Chassis Information

Description

The custom data entities for the inventory_f5_chassis table

Table

cdt_inventory_f5_chassis

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G An indication of the general hardware type of the physical entity
description Description string G A textual description of physical entity
firmwareRev Firmware Revision string G The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G, U The vendor-specific model name identifier string for the physical entity
serial Serial Number string G, U The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G The vendor-specific software revision string for the physical entity
vendor Vendor string G The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

F5 Slot Information

Description

The custom data entities for the inventory_f5_slot table

Table

cdt_inventory_f5_slot

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G An indication of the general hardware type of the physical entity
description Description string G A textual description of physical entity
firmwareRev Firmware Revision string G The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G The vendor-specific model name identifier string for the physical entity
serial Serial Number string G, U The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G The vendor-specific software revision string for the physical entity
vendor Vendor string G The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

Juniper Asset Information

Description

The custom data entities for the inventory_juniper table

Table

cdt_inventory_juniper

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G An indication of the general hardware type of the physical entity
description Description string G, U A textual description of physical entity
firmwareRev Firmware Revision string G The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G, U The vendor-specific model name identifier string for the physical entity
serial Serial Number string G, U The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G The vendor-specific software revision string for the physical entity
vendor Vendor string G The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

Riverbed Asset Information

Description

The custom data entities for the inventory_riverbed table

Table

cdt_inventory_riverbed

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
class Class string G An indication of the general hardware type of the physical entity
description Description string G A textual description of physical entity
firmwareRev Firmware Revision string G The vendor-specific firmware revision string for the physical entity
hardwareRev Hardware Revision string G The vendor-specific hardware revision string for the physical entity
isFRU Is Field Replaceable Unit string G Indicates whether or not this physical entity is considered a ‘field replaceable unit’ by the vendor
model Model string G, U The vendor-specific model name identifier string for the physical entity
serial Serial Number string G, U The vendor-specific serial number string for the physical entity
softwareRev Software Revision string G, U The vendor-specific software revision string for the physical entity
vendor Vendor string G The name of the manufacturer of this physical component
Links

This resource has links to the following:

[reference]  [top]

IP Address Table

Description

The custom data entities for the ip_addr table

Table

cdt_ip_addr

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
broadcast BroadCast string G, U BroadCast Address.
ipaddress IP Address string G, U IP Address
maxReasembleSize ReasmMaxSize string G, U Re-assembly Max Size.
netmask NetMask string G, U Network Mask
Links

This resource has links to the following:

[reference]  [top]

IP Address Table (includes IPv6)

Description

The custom data entities for the ip_address table

Table

cdt_ip_address

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
addrtype IP Address Type string G, U IP Address Type
ipaddress IP Address string G IP Address.
origin Origin string G, U Origin
status Status string G, U Status
type Type string G, U Type
Links

This resource has links to the following:

[reference]  [top]

IP System Stats

Description

The custom data entities for the ip_system_stats table

Table

cdt_ip_system_stats

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
discontinuityTime Discontinuity Time integer G, U The value of sysUpTime on the most recent occasion at which any one or more of this entry’s counters suffered a discontinuity.
ipDefaultTTL Default TTL integer G The default value inserted into the Time-To-Live field of the IPv4 header of datagrams originated at this entity, whenever a TTL value is not supplied by the transport layer protocol.
ipReasmTimeout Reassembly Timeout integer G The maximum number of seconds that received fragments are held while they are awaiting reassembly at this entity.
ipVersion IP Version string G IP version, one of:

  • ipv4
  • ipv6
ipv4Forwarding IPv4 Forwarding string G The indication of whether this entity is acting as an IPv4 router in respect to the forwarding of datagrams received by, but not addressed to, this entity. One of:

  • forwarding
  • notforwarding
ipv6DefaultHopLimit IPv6 Default Hop Limit integer G The default value inserted into the Hop Limit field of the IPv6 header of datagrams originated at this entity whenever a Hop Limit value is not supplied by the transport layer protocol.
ipv6Forwarding IPv6 Forwarding string G The indication of whether this entity is acting as an IPv6 router on any interface in respect to the forwarding of datagrams received by, but not addressed to, this entity. One of:

  • forwarding
  • notforwarding
reasmFails Reassembly Fail integer G The number of failures detected by the IP re-assembly algorithm (for whatever reason: timed out, errors, etc).
Timeseries Data: Stats, Formats & Options
reasmOKs Reassembly Success integer G The number of IP datagrams successfully re-assembled.
Timeseries Data: Stats, Formats & Options
reasmReqds Reassembly Required integer G The number of IP fragments received which needed to be reassembled at this entity.
Timeseries Data: Stats, Formats & Options
refreshRate Refresh Rate integer G, U The minimum reasonable polling interval for this entry.
routingDiscards Routing Discards integer G The number of routing entries which were chosen to be discarded even though they are valid.
Timeseries Data: Stats, Formats & Options
rxAddrErrors Rx Address Errors integer G The number of input IP datagrams discarded because the IP address in their IP header’s destination field was not a valid address to be received at this entity.
Timeseries Data: Stats, Formats & Options
rxBcastPkts Rx Bcast Pkts integer G The number of IP broadcast datagrams received.
Timeseries Data: Stats, Formats & Options
rxBytes Rx Bytes integer G The total number of octets received in input IP datagrams, including those received in error.
Timeseries Data: Stats, Formats & Options
rxDelivers Rx Delivers integer G The total number of input datagrams successfully delivered to IP user-protocols (including ICMP).
Timeseries Data: Stats, Formats & Options
rxDiscards Rx Discards integer G The number of input IP datagrams for which no problems were encountered to prevent their continued processing, but which were discarded (e.g., for lack of buffer space).
Timeseries Data: Stats, Formats & Options
rxForwPackets Rx Forward Pkts integer G The number of input datagrams for which this entity was not their final IP destination, as a result of which an attempt was made to find a route to forward them to that final destination.
Timeseries Data: Stats, Formats & Options
rxHdrErrors Rx Header Errors integer G The number of input datagrams discarded due to errors in their IPv4 headers, including bad checksums, version number mismatch, other format errors, time-to-live exceeded, errors discovered in processing their IPv4 options, etc.
Timeseries Data: Stats, Formats & Options
rxMcastBytes Rx Mcast Bytes integer G The total number of octets received in IP multicast datagrams.
Timeseries Data: Stats, Formats & Options
rxMcastPkts Rx Mcast Pkts integer G The number of IP multicast datagrams received.
Timeseries Data: Stats, Formats & Options
rxNoRoutes Rx No Routes integer G The number of input IP datagrams discarded because no route could be found to transmit them to their destination.
Timeseries Data: Stats, Formats & Options
rxPackets Rx Pkts integer G The total number of input datagrams received from interfaces, including those received in error.
Timeseries Data: Stats, Formats & Options
rxTruncatedPkts Rx Truncated Pkts integer G The number of input IP datagrams discarded because the datagram frame didn’t carry enough data.
Timeseries Data: Stats, Formats & Options
rxUnknownProtos Rx Unknown Protocols integer G The number of locally-addressed datagrams received successfully but discarded because of an unknown or unsupported protocol.
Timeseries Data: Stats, Formats & Options
txBcastPkts Tx Bcast Pkts integer G The number of IP broadcast datagrams transmitted.
Timeseries Data: Stats, Formats & Options
txBytes Tx Bytes integer G The total number of octets in IP datagrams delivered to the lower layers for transmission.
Timeseries Data: Stats, Formats & Options
txDiscards Tx Discards integer G The number of output IP datagrams for which no problem was encountered to prevent their transmission to their destination, but which were discarded (e.g., for lack of buffer space).
Timeseries Data: Stats, Formats & Options
txForwPackets Tx Forwarded Pkts integer G The number of datagrams for which this entity was not their final IP destination and for which it was successful in finding a path to their final destination.
Timeseries Data: Stats, Formats & Options
txFragCreates Fragments Created integer G The number of IP datagram fragments that have been generated as a result of fragmentation at this entity.
Timeseries Data: Stats, Formats & Options
txFragFails Fragment Fail integer G The number of IP datagrams that have been discarded because they needed to be fragmented at this entity but could not be, e.g., because their Don’t Fragment flag was set.
Timeseries Data: Stats, Formats & Options
txFragOKs Fragment Success integer G The number of IP datagrams that have been successfully fragmented at this entity.
Timeseries Data: Stats, Formats & Options
txFragReqds Fragment Required integer G The number of IP datagrams that would require fragmentation in order to be transmitted.
Timeseries Data: Stats, Formats & Options
txMcastBytes Tx Mcast Bytes integer G The total number of octets transmitted in IP multicast datagrams.
Timeseries Data: Stats, Formats & Options
txMcastPkts Tx Mcast Pkts integer G The number of IP multicast datagrams transmitted.
Timeseries Data: Stats, Formats & Options
txNoRoutes Tx No Routes integer G The number of IP datagrams discarded because no route could be found to transmit them to their destination.
Timeseries Data: Stats, Formats & Options
txPackets Tx Pkts integer G The total number of IP datagrams that this entity supplied to the lower layers for transmission.
Timeseries Data: Stats, Formats & Options
txRequests Tx Requests integer G The total number of IP datagrams which local IP user protocols (including ICMP) supplied to IP in requests for transmission.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Juniper Firewall

Description

The custom data entities for the juniper_firewall table

Table

cdt_juniper_firewall

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Connections Connections integer G Incoming connections established
Timeseries Data: Stats, Formats & Options
Denied Denied integer G Packets dropped due to policy deny
Timeseries Data: Stats, Formats & Options
RxPermitted Rx Permitted integer G Incoming bytes permitted by policy
Timeseries Data: Stats, Formats & Options
TxPermitted Tx Permitted integer G Outgoing bytes permitted by policy
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Juniper Ping

Description

The custom data entities for the juniper_ping table

Table

cdt_juniper_ping

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
AvgRtt Avg Rtt integer G Average round trip time from all probes during this test. Measured in microseconds.
Timeseries Data: Stats, Formats & Options
JitterRtt Jitter Rtt integer G Variation in round trip time from all probes during this test. Measured in microseconds.
Timeseries Data: Stats, Formats & Options
LastRtt Last Rtt integer G Round trip time from most recent successful probe during this test. Measured in microseconds.
Timeseries Data: Stats, Formats & Options
MaxRtt Max Rtt integer G Maximum round trip time from all probes during this test. Measured in microseconds.
Timeseries Data: Stats, Formats & Options
MinRtt Min Rtt integer G Minimum round trip time from all probes during this test. Measured in microseconds.
Timeseries Data: Stats, Formats & Options
TestName Test Name string G, U The name of the ping test.
Links

This resource has links to the following:

[reference]  [top]

Juniper Pulse VPN Users

Description

The custom data entities for the juniper_pulse_vpn_users table

Table

cdt_juniper_pulse_vpn_users

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
iveConcurrentUsers Concurrent Users integer G The Total number of Concurrent user Licenses used for the IVE Node
Timeseries Data: Stats, Formats & Options
iveMaxConcurrentUsersLicenseCapacity License Capacity integer G Total licensed concurrent users capacity
Timeseries Data: Stats, Formats & Options
iveSSLConnections SSL Connections integer G Total number of SSL connection
Timeseries Data: Stats, Formats & Options
iveVPNTunnels VPN Tunnels integer G The number of concurrent Pulse IPSec and NC users
Timeseries Data: Stats, Formats & Options
pulseVpnName Pulse VPN Index string G Pulse VPN Index
signedInMailUsers Mail Users integer G Number of Signed-In Mail Users
Timeseries Data: Stats, Formats & Options
signedInWebUsers Web Users integer G Number of Signed-In Web Users
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Alteon Group

Description

The custom data entities for the loadbalancer_alteon_group table

Table

cdt_loadbalancer_alteon_group

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
CurrSessions Current Sessions integer G Group Current Sessions
Timeseries Data: Stats, Formats & Options
HighestSessions Highest Sessions integer G Group Highest Sessions
Timeseries Data: Stats, Formats & Options
Octets Octets integer G RServer Octets Tx + Rx
Timeseries Data: Stats, Formats & Options
TotalSessions Total Sessions integer G Group Total Sessions
Timeseries Data: Stats, Formats & Options
lbName name string G name
Links

This resource has links to the following:

[reference]  [top]

Alteon Real Servers

Description

The custom data entities for the loadbalancer_alteon_rserv table

Table

cdt_loadbalancer_alteon_rserv

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
CurrSessions Current Sessions integer G RServer Current Sessions
Timeseries Data: Stats, Formats & Options
FailureTime Failure Time string G, U Time of the last failure.
Failures Failures integer G The total number of times that the real server is claimed down.
Timeseries Data: Stats, Formats & Options
HighestSessions Highest Sessions integer G RServer Highest Sessions
Timeseries Data: Stats, Formats & Options
Octets Octets integer G RServer Octets Tx + Rx
Timeseries Data: Stats, Formats & Options
RealState State string G, U Current state of the Real Server, one of:

  • disabled – the server is disabled
  • failed – the server failed
  • running – the server is running


Can be combined with an event format for event-based analytics, see Event Formats.

RealStatus Status string G, U Current status of the Real Server, one of:

  • cookiepersistent – Cookie Persistent
  • cookiepersistentfastage – Cookie Persistent Fastage
  • disable – Disable
  • enable – Enable
  • fastage – Fastage


Can be combined with an event format for event-based analytics, see Event Formats.

TotalSessions Total Sessions integer G RServer Total Sessions
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Alteon Virtual Servers

Description

The custom data entities for the loadbalancer_alteon_vserv table

Table

cdt_loadbalancer_alteon_vserv

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
CurrSessions Current Sessions integer G VServer Current Sessions
Timeseries Data: Stats, Formats & Options
HighestSessions Highest Sessions integer G VServer Highest Sessions
Timeseries Data: Stats, Formats & Options
IPAddress IpAddress string G, U Virtual Server IP Address
Octets Octets integer G VServer Octets Tx + Rx
Timeseries Data: Stats, Formats & Options
TotalSessions Total Sessions integer G VServer Total Sessions
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory

Description

The custom data entities for the memory table

Table

cdt_memory

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object, one of:

  • HOST-RESOURCES-TYPES.hrStorageCompactDisc
  • HOST-RESOURCES-TYPES.hrStorageFixedDisk
  • HOST-RESOURCES-TYPES.hrStorageFlashMemory
  • HOST-RESOURCES-TYPES.hrStorageFloppyDisk
  • HOST-RESOURCES-TYPES.hrStorageNetworkDisk
  • HOST-RESOURCES-TYPES.hrStorageOther
  • HOST-RESOURCES-TYPES.hrStorageRam
  • HOST-RESOURCES-TYPES.hrStorageRamDisk
  • HOST-RESOURCES-TYPES.hrStorageRemovableDisk
  • HOST-RESOURCES-TYPES.hrStorageVirtualMemory

Alternatively, a vendor name may be returned depending on the implementation (e.g. Cisco, Juniper, etc)

memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Alcatel

Description

The custom data entities for the memory_alcatel table

Table

cdt_memory_alcatel

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Alcatel – AOS7

Description

The custom data entities for the memory_alcatel_aos7 table

Table

cdt_memory_alcatel_aos7

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Alteon

Description

The custom data entities for the memory_alteon table

Table

cdt_memory_alteon

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Aruba

Description

The custom data entities for the memory_aruba table

Table

cdt_memory_aruba

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Avaya – RC

Description

The custom data entities for the memory_avaya_rc table

Table

cdt_memory_avaya_rc

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Avaya – S5

Description

The custom data entities for the memory_avaya_s5 table

Table

cdt_memory_avaya_s5

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Cisco

Description

The custom data entities for the memory_cisco table

Table

cdt_memory_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Cisco Enhanced

Description

The custom data entities for the memory_cisco_nexus table

Table

cdt_memory_cisco_nexus

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryAllocHit Allocation Success integer G The number of successful allocations from the memory pool
Timeseries Data: Stats, Formats & Options
memoryAllocMiss Allocation Fail integer G The number of unsuccessful allocations from the memory pool
Timeseries Data: Stats, Formats & Options
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreeHit Free Success integer G The number of successful frees/deallocations from the memory pool
Timeseries Data: Stats, Formats & Options
memoryFreeMiss Free Fail integer G The number of unsuccessful frees/deallocations from the memory pool
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memoryHighestFree Free High Water Mark integer G The largest number of free bytes from the memory pool on the physical entity
Timeseries Data: Stats, Formats & Options
memoryHighestUsed Used High Water Mark integer G The largest number of used bytes from the memory pool on the physical entity
Timeseries Data: Stats, Formats & Options
memoryLargestFreeBlock Largest Free Block integer G The largest number of contiguous free bytes from the memory pool
Timeseries Data: Stats, Formats & Options
memoryLowestFree Free Low Water Mark integer G The lowest recorded amount of available memory in the memory pool
Timeseries Data: Stats, Formats & Options
memoryLowestUsed Used Low Water Mark integer G The lowest number of bytes from the memory pool that have been used by applications on the physical entity since sysUpTime
Timeseries Data: Stats, Formats & Options
memoryShared Shared integer G The number of shared bytes in the memory pool
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Cisco SAN

Description

The custom data entities for the memory_cisco_san table

Table

cdt_memory_cisco_san

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Dell

Description

The custom data entities for the memory_dell table

Table

cdt_memory_dell

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
agentSwitchCpuProcessMemAvailable Size integer G The total memory available.
Timeseries Data: Stats, Formats & Options
agentSwitchCpuProcessMemFree Free integer G The total memory free for utilization.
Timeseries Data: Stats, Formats & Options
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Dell F10 S

Description

The custom data entities for the memory_dell_F10_S table

Table

cdt_memory_dell_F10_S

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Dell DNOS

Description

The custom data entities for the memory_dell_dnos table

Table

cdt_memory_dell_dnos

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Extreme

Description

The custom data entities for the memory_extreme table

Table

cdt_memory_extreme

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Extreme VSP

Description

The custom data entities for the memory_extreme_vsp table

Table

cdt_memory_extreme_vsp

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Fortinet Fortigate

Description

The custom data entities for the memory_fortinet_fortigate table

Table

cdt_memory_fortinet_fortigate

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Fortinet Fortigate Hard Disk

Description

The custom data entities for the memory_fortinet_fortigate_hd table

Table

cdt_memory_fortinet_fortigate_hd

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Fortinet Fortigate Low Mem

Description

The custom data entities for the memory_fortinet_fortigate_lowmem table

Table

cdt_memory_fortinet_fortigate_lowmem

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Foundry

Description

The custom data entities for the memory_foundry table

Table

cdt_memory_foundry

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Foundry MLX

Description

The custom data entities for the memory_foundry_mlx table

Table

cdt_memory_foundry_mlx

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Juniper

Description

The custom data entities for the memory_juniper table

Table

cdt_memory_juniper

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – NetScaler

Description

The custom data entities for the memory_netscaler table

Table

cdt_memory_netscaler

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memSizeMB Size integer G, U Total amount of system memory, in megabytes.
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Netscreen

Description

The custom data entities for the memory_netscreen table

Table

cdt_memory_netscreen

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Nokia

Description

The custom data entities for the memory_nokia table

Table

cdt_memory_nokia

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Procurve

Description

The custom data entities for the memory_procurve table

Table

cdt_memory_procurve

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Server

Description

The custom data entities for the memory_server table

Table

cdt_memory_server

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryAllocationUnits Allocation Units integer G, U The size, in bytes, of the data objects allocated from this pool. If this entry is monitoring sectors, blocks, buffers, or packets, for example, this number will commonly be greater than one. Otherwise this number will typically be one.
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G, U Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – UCD – Real

Description

The custom data entities for the memory_ucd_real table

Table

cdt_memory_ucd_real

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryBuffer Buffer integer G The total amount of real or virtual memory currently allocated for use as memory buffers.
Timeseries Data: Stats, Formats & Options
memoryCached Cached integer G The total amount of real or virtual memory currently allocated for use as cached memory.
Timeseries Data: Stats, Formats & Options
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memoryShared Shared integer G The number of shared bytes in the memory pool
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – UCD – Swap

Description

The custom data entities for the memory_ucd_swap table

Table

cdt_memory_ucd_swap

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Memory – Virtual

Description

The custom data entities for the memory_virtual table

Table

cdt_memory_virtual

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
hrStorageAllocationUnits Allocation Units integer G, U The size, in bytes, of the data objects allocated from this pool. If this entry is monitoring sectors, blocks, buffers, or packets, for example, this number will commonly be greater than one. Otherwise this number will typically be one.
memoryDesc Description string G Description
memoryFree Free integer G Amount of memory free in Bytes
Timeseries Data: Stats, Formats & Options
memoryFreePercent Free Percent float G Amount of memory free as a percentage
Timeseries Data: Stats, Formats & Options
memorySize Size integer G Size of this memory object in Bytes
Timeseries Data: Stats, Formats & Options
memoryType Type string G, U Type of this memory object
memoryUsed Used integer G Amount of memory used in Bytes
Timeseries Data: Stats, Formats & Options
memoryUsedPercent Used Percent float G Amount of memory used as a percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

MAC/IP/Switch Port

Description

The custom data entities for the mis table

Table

cdt_mis

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ip IP Address string G, U IP Address
lastresolved Last Resolved time G, U Last Resolved
linktype Link Type string G, U Link Type
mac MAC string G, U MAC Address
oui Vendor string G, U Organisationally Unique Identifier
vlan_name VLAN Name string G, U VLAN Name
vlanid VLAN Id string G, U VLAN Id
Links

This resource has links to the following:

  • arp_dev – link to the cdt_device object for the ARP device
  • connecteddevice – link to the cdt_device object for the connected device
  • deviceLink – link to the cdt_device object for the parent device
  • connectedport – link to the cdt_port object for the connected interface
  • port – link to the cdt_port object for the associated interface
[reference]  [top]

Optical Signal Monitoring

Description

The custom data entities for the optical table

Table

cdt_optical

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
SNR SNR integer G SNR
Timeseries Data: Stats, Formats & Options
opticalName Name string G Name
rxPower Rx Power integer G Rx Power
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Optical Signal Monitoring – ADVA

Description

The custom data entities for the optical_adva table

Table

cdt_optical_adva

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
SNR SNR integer G SNR
Timeseries Data: Stats, Formats & Options
opticalName Name string G, U Name
portAdminState Admin State string G, U Administrative State of the port, one of:

  • dsbld – Disabled
  • is – IS
  • mgt – Management


Can be combined with an event format for event-based analytics, see Event Formats.

portAidString portAidString string G, U portAidString
portOperState portOperState string G, U Operational State of the port, one of:

  • anr – ANR
  • nr – NR
  • out – OUT
  • un – UN
  • undefined – Undefined


Can be combined with an event format for event-based analytics, see Event Formats.

portRemark Remark string G, U Remark
rxPower Rx Power integer G Rx Power
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Optical Signal Monitoring – ADVA – Loss

Description

The custom data entities for the optical_adva_measurement table

Table

cdt_optical_adva_measurement

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
linkLoss Link Loss integer G Link loss at termination in tenth of dB.
Timeseries Data: Stats, Formats & Options
measurementFpLineEndPos End Pos integer G End Pos
Timeseries Data: Stats, Formats & Options
portLink Port Link string G Port Link
portMeasurementName Measurement Name string G Measurement Name
Links

This resource has links to the following:

[reference]  [top]

Optical Signal Monitoring – NBS

Description

The custom data entities for the optical_nbs table

Table

cdt_optical_nbs

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
SNR SNR integer G SNR
Timeseries Data: Stats, Formats & Options
nbsOsaChannelOSNRMax Maximum OSNR integer G The user-specified maximum OSNR of this channel
Timeseries Data: Stats, Formats & Options
nbsOsaChannelOSNRMin Minimum OSNR integer G The user-specified minimum OSNR of this channel
Timeseries Data: Stats, Formats & Options
nbsOsaChannelRxPowerMax Power Max integer G The user-specified maximum signal strength, in millidecibels (mdBm), of this channel. Not supported value: -100001
Timeseries Data: Stats, Formats & Options
nbsOsaChannelRxPowerMin Power Min integer G The user-specified minimum signal strength, in millidecibels (mdBm), of this channel. Not supported value: -100001
Timeseries Data: Stats, Formats & Options
nbsOsaChannelStatus Status string G, U If the OSA thinks the channel is there or not, one of:

  • absent
  • present


Can be combined with an event format for event-based analytics, see Event Formats.

opticalName Name string G Name
rxPower Rx Power integer G Rx Power
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Optical – Cisco

Description

The custom data entities for the optical_sensor_cisco table

Table

cdt_optical_sensor_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
dBm Decibel Milliwatts integer G dB relative to 1mW of power
Timeseries Data: Stats, Formats & Options
mW Milliwatts integer G milliwatts
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Other

Description

The custom data entities for the other_sensor table

Table

cdt_other_sensor

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
type Type string G sensor type
value Value string G sensor value
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Other – Cisco

Description

The custom data entities for the other_sensor_cisco table

Table

cdt_other_sensor_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
type Type string G, U sensor type
value Value string G sensor value
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Other – Entity

Description

The custom data entities for the other_sensor_entity table

Table

cdt_other_sensor_entity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
type Type string G, U sensor type
value Value string G sensor value
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Palo Alto Firewall Connections

Description

The custom data entities for the palo_alto_firewall_connections table

Table

cdt_palo_alto_firewall_connections

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ActiveConnections Active Connections integer G Total number of active sessions.
Timeseries Data: Stats, Formats & Options
ActiveIcmpConnections Active ICMP Connections integer G Total number of active ICMP sessions.
Timeseries Data: Stats, Formats & Options
ActiveTcpConnections Active TCP Connections integer G Total number of active TCP sessions.
Timeseries Data: Stats, Formats & Options
ActiveUdpConnections Active UDP Connections integer G Total number of active UDP sessions.
Timeseries Data: Stats, Formats & Options
ConnectionUtil Connection Util integer G Session table utilization percentage. Values should be between 0 and 100.
Timeseries Data: Stats, Formats & Options
MaxConnections Max Connections integer G, U Total number of sessions supported.
Links

This resource has links to the following:

[reference]  [top]

Palo Alto Firewall Connections Zone Stats

Description

The custom data entities for the palo_alto_firewall_connections_zone table

Table

cdt_palo_alto_firewall_connections_zone

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
panZoneActiveOtherIpCps Other IP Cps integer G Number of active Other IP connections per second for this zone.
Timeseries Data: Stats, Formats & Options
panZoneActiveTcpCps TCP Cps integer G Number of active TCP connections per second for this zone.
Timeseries Data: Stats, Formats & Options
panZoneActiveUdpCps UDP Cps integer G Number of active UDP connections per second for this zone.
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Palo Alto VPN

Description

The custom data entities for the palo_alto_vpn table

Table

cdt_palo_alto_vpn

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
paloVpnName Palo Alto VPN Index string G Palo Alto VPN Index
panGPGWUtilizationActiveTunnels Active Tunnels integer G Number of active tunnels
Timeseries Data: Stats, Formats & Options
panGPGWUtilizationMaxTunnels Max Tunnels integer G Max tunnels allowed
Timeseries Data: Stats, Formats & Options
panGPGWUtilizationPct Utilization integer G GlobalProtect Gateway utilization percentage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

PoE Device

Description

The custom data entities for the poe_main table

Table

cdt_poe_main

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
consumptionPower Consumed Power integer G Measured usage power expressed in Watts
Timeseries Data: Stats, Formats & Options
operStatus Operational Status string G, U The operational status of the main PSE
Can be combined with an event format for event-based analytics, see Event Formats.
power Nominal Power integer G The nominal power of the PSE expressed in Watts
Timeseries Data: Stats, Formats & Options
usageThreshold Usage Threshold integer G Measured usage power expressed in Watts
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

PoE Device – Cisco

Description

The custom data entities for the poe_main_cisco table

Table

cdt_poe_main_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
consumptionPower Consumed Power integer G Measured usage power expressed in Watts
Timeseries Data: Stats, Formats & Options
descr Description string G, U A textual string containing information about the Power Source Equipment (PSE) group
operStatus Operational Status string G, U The operational status of the main PSE
Can be combined with an event format for event-based analytics, see Event Formats.
power Nominal Power integer G The nominal power of the PSE expressed in Watts
Timeseries Data: Stats, Formats & Options
pwrMonitorCapable Power Monitor Capable string G, U Whether the given PSE group is capable of monitoring the power consumption of the interfaces that belong to the group
usageThreshold Usage Threshold integer G Measured usage power expressed in Watts
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

PoE Interface

Description

The custom data entities for the poe_port table

Table

cdt_poe_port

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
adminEnable Admin Enable string G, U Whether an interface can provide PSE function, one of:

  • True – Enabled
  • False – Disabled


Can be combined with an event format for event-based analytics, see Event Formats.

detectionStatus Detection Status string G, U The operational status of the port powered device detection, one of:

  • disabled – the PSE State diagram is in the state DISABLED
  • searching – the PSE State diagram is in a state other than those listed
  • deliveringPower – the PSE State diagram is in the state POWER_ON
  • fault – the PSE State diagram is in the state TEST_ERROR
  • test – the PSE State diagram is in the state TEST_MODE
  • otherFault – the PSE State diagram is in the state IDLE due to the variable error_conditions


Can be combined with an event format for event-based analytics, see Event Formats.

invalidSignatureCount Invalid Signature Counter integer G The number of times PSE state diagram enters the state SIGNATURE_INVALID
Timeseries Data: Stats, Formats & Options
overLoadCount Overload Counter integer G The number of times PSE state diagram enters the state ERROR_DELAY_OVER
Timeseries Data: Stats, Formats & Options
powerDeniedCount Power Denied Counter integer G The number of times PSE state diagram enters the state POWER_DENIED
Timeseries Data: Stats, Formats & Options
shortCircuitCount Short Circuit Counter integer G The number of times PSE state diagram enters the state ERROR_DELAY_SHORT
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

PoE Interface – Cisco

Description

The custom data entities for the poe_port_cisco table

Table

cdt_poe_port_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
adminEnable Admin Enable string G, U Whether an interface can provide PSE function, one of:

  • True – Enabled
  • False – Disabled


Can be combined with an event format for event-based analytics, see Event Formats.

detectionStatus Detection Status string G, U The operational status of the port powered device detection, one of:

  • disabled – the PSE State diagram is in the state DISABLED
  • searching – the PSE State diagram is in a state other than those listed
  • deliveringPower – the PSE State diagram is in the state POWER_ON
  • fault – the PSE State diagram is in the state TEST_ERROR
  • test – the PSE State diagram is in the state TEST_MODE
  • otherFault – the PSE State diagram is in the state IDLE due to the variable error_conditions


Can be combined with an event format for event-based analytics, see Event Formats.

deviceDetected Device Detected string G, U Whether a Powered Device (PD) has been detected on the interface.
Can be combined with an event format for event-based analytics, see Event Formats.
invalidSignatureCount Invalid Signature Counter integer G The number of times PSE state diagram enters the state SIGNATURE_INVALID
Timeseries Data: Stats, Formats & Options
overLoadCount Overload Counter integer G The number of times PSE state diagram enters the state ERROR_DELAY_OVER
Timeseries Data: Stats, Formats & Options
portDescr Physical Description string G Physical interface description
portEnable Interface Enable string G, U Enable status of the PSE port, one of:

  • auto
  • static
  • limit
  • disable


Can be combined with an event format for event-based analytics, see Event Formats.

powerAvailable Power Available integer G The amount of power available for the Powered Device to use
Timeseries Data: Stats, Formats & Options
powerConsumption Power Consumption integer G Actual power consumption of the Powered Device connected to this interface
Timeseries Data: Stats, Formats & Options
powerDeniedCount Power Denied Counter integer G The number of times PSE state diagram enters the state POWER_DENIED
Timeseries Data: Stats, Formats & Options
powerMax Power Max integer G The maximum amount of power that the PSE will make available to the PD connected to this interface
shortCircuitCount Short Circuit Counter integer G The number of times PSE state diagram enters the state ERROR_DELAY_SHORT
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Interface

Description

The custom data entities for the port table

Table

cdt_port

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G, U The poll state of the entity

  • on
  • off
InBroadcastPkts Rx Bcast Pkts integer G Number of received broadcast packets
Timeseries Data: Stats, Formats & Options
InBroadcastPps Rx Bcast Pps float G Number of received broadcast packets per second
Timeseries Data: Stats, Formats & Options
InDiscards Rx Discards integer G Number of received discards
Timeseries Data: Stats, Formats & Options
InErrors Rx Errors integer G Number of received errors
Timeseries Data: Stats, Formats & Options
InMulticastPkts Rx Mcast Pkts integer G Number of received multicast packets
Timeseries Data: Stats, Formats & Options
InMulticastPps Rx Mcast Pps float G Number of received multicast packets per second
Timeseries Data: Stats, Formats & Options
InOctets Rx Bytes integer G Number of received bytes
Timeseries Data: Stats, Formats & Options
InOutBroadcastPkts Total Bcast Pkts integer G Combined Rx and Tx broadcast packets
Timeseries Data: Stats, Formats & Options
InOutDiscards Total Discards integer G Combined Rx and Tx Discards
Timeseries Data: Stats, Formats & Options
InOutErrors Total Errors integer G Combined Rx and Tx Errors
Timeseries Data: Stats, Formats & Options
InOutMulticastPkts Total Mcast Pkts integer G Combined Rx and Tx multicast packets
Timeseries Data: Stats, Formats & Options
InOutOctets Total Bytes integer G Combined Rx and Tx Bytes
Timeseries Data: Stats, Formats & Options
InOutSpeed Total Speed integer G Combined Rx and Tx Speed
InOutUcastPkts Total Ucast Pkts integer G Combined Rx and Tx unicast packets
Timeseries Data: Stats, Formats & Options
InUcastPkts Rx Ucast Pkts integer G Number of received unicast packets
Timeseries Data: Stats, Formats & Options
InUcastPps Rx Ucast Pps float G Number of received unicast packets per second
Timeseries Data: Stats, Formats & Options
OutBroadcastPkts Tx Bcast Pkts integer G Number of transmitted broadcast packets
Timeseries Data: Stats, Formats & Options
OutBroadcastPps Tx Bcast Pps float G Number of transmitted broadcast packets per second
Timeseries Data: Stats, Formats & Options
OutDiscards Tx Discards integer G Number of transmitted discards
Timeseries Data: Stats, Formats & Options
OutErrors Tx Errors integer G Number of transmitted errors
Timeseries Data: Stats, Formats & Options
OutMulticastPkts Tx Mcast Pkts integer G Number of transmitted multicast packets
Timeseries Data: Stats, Formats & Options
OutMulticastPps Tx Mcast Pps float G Number of transmitted multicast packets per second
Timeseries Data: Stats, Formats & Options
OutOctets Tx Bytes integer G Number of transmitted bytes
Timeseries Data: Stats, Formats & Options
OutUcastPkts Tx Ucast Pkts integer G Number of transmitted unicast packets
Timeseries Data: Stats, Formats & Options
OutUcastPps Tx Ucast Pps float G Number of transmitted unicast packets per second
Timeseries Data: Stats, Formats & Options
RxBps Rx Bps float G Received bits per second
Timeseries Data: Stats, Formats & Options
RxDiscardsPercent Rx Discards Percent float G Rx discards percentage
Timeseries Data: Stats, Formats & Options
RxErrorPercent Rx Errors Percent float G Rx errors percentage
Timeseries Data: Stats, Formats & Options
RxTxDiscardsPercent Total Discards Percent float G Total discards percentage
Timeseries Data: Stats, Formats & Options
RxTxErrorPercent Total Errors Percent float G Total errors percentage
Timeseries Data: Stats, Formats & Options
RxUtil Rx Util float G Rx Utilization
Timeseries Data: Stats, Formats & Options
TxBps Tx Bps float G Transmitted bits per second
Timeseries Data: Stats, Formats & Options
TxDiscardsPercent Tx Discards Percent float G Tx discards percentage
Timeseries Data: Stats, Formats & Options
TxErrorPercent Tx Errors Percent float G Tx errors percentage
Timeseries Data: Stats, Formats & Options
TxUtil Tx Util float G Tx Utilization
Timeseries Data: Stats, Formats & Options
if90day if90day integer G, U Status of port usage over 90 days, one of:

  • 0
  • 1
ifAdminStatus ifAdminStatus string G, U The desired state of the interface, one of:

  • up
  • down
  • testing

Can be combined with an event format for event-based analytics, see Event Formats.

ifAlias Alias string G, U Interface Alias (ifAlias)
ifDescr Description string G, U Interface Description (ifDescr)
ifDuplex ifDuplex string G, U Interface Duplex, one of:

  • auto
  • half
  • full
  • unknown
ifInSpeed Rx Speed integer G, U Interface Input Speed (Statseeker custom attribute)
ifIndex ifIndex string G, U Interface Index (IF-MIB.ifIndex)
ifName ifName string G, U Interface Name (IF-MIB.ifName)
ifNonUnicast NUcast Polling string G, U NonUnicast Polling status of the port, one of:

  • on
  • off
  • global
ifOperStatus ifOperStatus string G, U Current operational status of port, one of:

  • dormant
  • down
  • lowerLayerDown
  • notPresent
  • testing
  • unknown
  • up

Can be combined with an event format for event-based analytics, see Event Formats.

ifOutSpeed Tx Speed integer G, U Interface Output Speed (Statseeker custom attribute)
ifPhysAddress PhysAddress string G, U Interface MAC Address (ifPhysAddress)
ifPoll ifPoll string G, U Polling status of the port, one of:

  • on
  • off
ifSpeed Speed integer G, U Interface Speed (based on ifSpeed or ifHighSpeed)
ifTitle Title string G, U Interface Title (Statseeker custom attribute – ifTitle)
ifType Type string G, U Interface Type, one of:

  • a12MppSwitch
  • aal2
  • aal5
  • actelisMetaLOOP
  • adsl
  • adsl2
  • adsl2plus
  • aflane8023
  • aflane8025
  • arap
  • arcnet
  • arcnetPlus
  • async
  • atm
  • atmbond
  • atmDxi
  • atmFuni
  • atmIma
  • atmLogical
  • atmRadio
  • atmSubInterface
  • atmVciEndPt
  • atmVirtual
  • aviciOpticalEther
  • basicISDN
  • bgppolicyaccounting
  • bridge
  • bsc
  • cblVectaStar
  • cctEmul
  • ces
  • channel
  • ciscoISLvlan
  • cnr
  • coffee
  • compositeLink
  • dcn
  • ddnX25
  • digitalPowerline
  • digitalWrapperOverheadChannel
  • dlsw
  • docsCableDownstream
  • docsCableMaclayer
  • docsCableMCmtsDownstream
  • docsCableUpstream
  • docsCableUpstreamChannel
  • ds0
  • ds0Bundle
  • ds1
  • ds1FDL
  • ds3
  • dtm
  • dvbAsiIn
  • dvbAsiOut
  • dvbRccDownstream
  • dvbRccMacLayer
  • dvbRccUpstream
  • e1
  • econet
  • eon
  • eplrs
  • escon
  • ethernet3Mbit
  • ethernetCsmacd
  • fast
  • fastEther
  • fastEtherFX
  • fcipLink
  • fddi
  • fibreChannel
  • frameRelay
  • frameRelayInterconnect
  • frameRelayMPI
  • frameRelayService
  • frDlciEndPt
  • frf16MfrBundle
  • frForward
  • g703at2mb
  • g703at64k
  • gfp
  • gigabitEthernet
  • gr303IDT
  • gr303RDT
  • gtp
  • h323Gatekeeper
  • h323Proxy
  • hdh1822
  • hdlc
  • hdsl2
  • hiperlan2
  • hippi
  • hippiInterface
  • homepna
  • hostPad
  • hssi
  • hyperchannel
  • ibm370parChan
  • idsl
  • ieee1394
  • ieee80211
  • ieee80212
  • ieee80216WMAN
  • ieee8023adLag
  • if-gsn
  • imt
  • infiniband
  • interleave
  • ip
  • ipForward
  • ipOverAtm
  • ipOverCdlc
  • ipOverClaw
  • ipSwitch
  • isdn
  • isdns
  • isdnu
  • iso88022llc
  • iso88023Csmacd
  • iso88024TokenBus
  • iso88025CRFPInt
  • iso88025Dtr
  • iso88025Fiber
  • iso88025TokenRing
  • iso88026Man
  • isup
  • l2vlan
  • l3ipvlan
  • l3ipxvlan
  • lapb
  • lapd
  • lapf
  • linegroup
  • lmp
  • localTalk
  • macSecControlledIF
  • macSecUncontrolledIF
  • mediaMailOverIp
  • mfSigLink
  • miox25
  • mocaVersion1
  • modem
  • mpc
  • mpegTransport
  • mpls
  • mplsTunnel
  • msdsl
  • mvl
  • myrinet
  • nfas
  • nsip
  • opticalChannel
  • opticalChannelGroup
  • opticalTransport
  • other
  • para
  • pdnEtherLoop1
  • pdnEtherLoop2
  • plc
  • pon155
  • pon622
  • pos
  • ppp
  • pppMultilinkBundle
  • primaryISDN
  • propAtm
  • propBWAp2Mp
  • propCnls
  • propDocsWirelessDownstream
  • propDocsWirelessMaclayer
  • propDocsWirelessUpstream
  • propMultiplexor
  • propPointToPointSerial
  • propVirtual
  • propWirelessP2P
  • proteon10Mbit
  • proteon80Mbit
  • q2931
  • qam
  • qllc
  • radioMAC
  • radsl
  • reachDSL
  • regular1822
  • rfc1483
  • rfc877x25
  • rpr
  • rs232
  • rsrb
  • sdlc
  • sdsl
  • shdsl
  • sip
  • sipSig
  • sipTg
  • sixToFour
  • slip
  • smdsDxi
  • smdsIcip
  • softwareLoopback
  • sonet
  • sonetOverheadChannel
  • sonetPath
  • sonetVT
  • srp
  • ss7SigLink
  • stackToStack
  • starLan
  • tdlc
  • teLink
  • termPad
  • tr008
  • trasnpHdlc
  • tunnel
  • ultra
  • usb
  • v11
  • v35
  • v36
  • v37
  • vdsl
  • virtualIpAddress
  • virtualTg
  • voiceDID
  • voiceEM
  • voiceEMFGD
  • voiceEncap
  • voiceFGDEANA
  • voiceFGDOS
  • voiceFXO
  • voiceFXS
  • voiceOverAtm
  • voiceOverCable
  • voiceOverFrameRelay
  • voiceOverIp
  • x213
  • x25huntGroup
  • x25mlp
  • x25ple
Links

This resource has links to the following:

[reference]  [top]

[reference]  [top]

Interface EtherLike

Description

The custom data entities for the port_etherlike table

Table

cdt_port_etherlike

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
InPauseFrames Rx Pause integer G Timeseries Data: Stats, Formats & Options
OutPauseFrames Tx Pause integer G Timeseries Data: Stats, Formats & Options
alignmentErrors Alignment Errors integer G A count of frames received on a particular interface that are not an integral number of octets in length and do not pass the FCS check. The count represented by an instance of this object is incremented when the alignmentError status is returned by the MAC service to the LLC (or other MAC user). Received frames for which multiple error conditions pertain are, according to the conventions of IEEE 802.3 Layer Management, counted exclusively according to the error status presented to the LLC.
Timeseries Data: Stats, Formats & Options
carrierSenseErrors Carrier Sense Errors integer G The number of times that the carrier sense condition was lost or never asserted when attempting to transmit a frame on a particular interface. The count represented by an instance of this object is incremented at most once per transmission attempt, even if the carrier sense condition fluctuates during a transmission attempt. This counter does not increment when the interface is operating in full-duplex mode.
Timeseries Data: Stats, Formats & Options
deferredTransmissions Deferred Transmissions integer G A count of frames for which the first transmission attempt on a particular interface is delayed because the medium is busy. The count represented by an instance of this object does not include frames involved in collisions.
Timeseries Data: Stats, Formats & Options
excessiveCollisions Excessive Collisions integer G A count of frames for which transmission on a particular interface fails due to excessive collisions.
Timeseries Data: Stats, Formats & Options
fcsErrors FCS Errors integer G A count of frames received on a particular interface that are an integral number of octets in length but do not pass the FCS check. This count does not include frames received with frame-too-long or frame-too-short error.
Timeseries Data: Stats, Formats & Options
frameTooLongs Frame Too Long integer G Interface that exceed the maximum permitted frame size. The count represented by an instance of this object is incremented when the frameTooLong status is returned by the MAC service to the LLC (or other MAC user).
Timeseries Data: Stats, Formats & Options
internalMacReceiveErrors Internal MAC Receive Errors integer G A count of frames for which reception on a particular interface fails due to an internal MAC sublayer receive error. A frame is only counted by an instance of this object if it is not counted by the corresponding instance of either the dot3StatsLateCollisions object, the dot3StatsExcessiveCollisions object, or the dot3StatsCarrierSenseErrors object.
Timeseries Data: Stats, Formats & Options
internalMacTransmitErrors Internal MAC Transmit Errors integer G A count of frames for which transmission on a particular interface fails due to an internal MAC sublayer transmit error. A frame is only counted by an instance of this object if it is not counted by the corresponding instance of either the dot3StatsLateCollisions object, the dot3StatsExcessiveCollisions object, or the dot3StatsCarrierSenseErrors object.
Timeseries Data: Stats, Formats & Options
lateCollisions Late Collisions integer G The number of times that a collision is detected on a particular interface later than 512 bit-times into the transmission of a packet. Five hundred and twelve bit-times corresponds to 51.2 microseconds on a 10 Mbit/s system. A (late) collision included in a count represented by an instance of this object is also considered as a (generic) collision for purposes of other collision-related statistics.
Timeseries Data: Stats, Formats & Options
multipleCollisions Multiple Collisions integer G A count of successfully transmitted frames on a particular interface for which transmission is inhibited by more than one collision. A frame that is counted by an instance of this object is also counted by the corresponding instance of either the ifOutUcastPkts or ifOutNUcastPkts object and is not counted by the corresponding instance of the dot3StatsSingleCollisionFrames object.
Timeseries Data: Stats, Formats & Options
singleCollisions Single Collisions integer G A count of successfully transmitted frames on a particular interface for which transmission is inhibited by exactly one collision. A frame that is counted by an instance of this object is also counted by the corresponding instance of either the ifOutUcastPkts or ifOutNUcastPkts object and is not counted by the corresponding instance of the dot3StatsMultipleCollisionFrames object.
Timeseries Data: Stats, Formats & Options
symbolErrors Symbol Errors integer G Number of times there was an invalid data symbol when a valid carrier was present. See MIB for details
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Interface – Cisco NBAR

Description

The custom data entities for the port_nbar table

Table

cdt_port_nbar

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
DiscoverEnable Protocol Discovery Enable string G, U Whether protocol discovery is enabled on an interface, one of:

  • true
  • false
portIdx Port Index string G Index of the host interface
portName Port Name string G Name of the host interface
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Amps

Description

The custom data entities for the power_amps_sensor table

Table

cdt_power_amps_sensor

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
amperes Amperes integer G electrical current
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Amps – Cisco

Description

The custom data entities for the power_amps_sensor_cisco table

Table

cdt_power_amps_sensor_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
amperes Amperes integer G electrical current
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Amps – Entity

Description

The custom data entities for the power_amps_sensor_entity table

Table

cdt_power_amps_sensor_entity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
amperes Amperes integer G electrical current
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems – Battery

Description

The custom data entities for the power_system_battery table

Table

cdt_power_system_battery

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
batteryCurrent Battery Current integer G Battery Current
Timeseries Data: Stats, Formats & Options
batteryPercentRemaining Battery Percent Remaining integer G Battery Percent Remaining
Timeseries Data: Stats, Formats & Options
batteryRecommendedReplaceDate Battery Recommended Replace Date string G Battery Recommended Replace Date
batteryReplaceIndicator Battery Replacement Indicator string G Battery Replacement Indicator
Can be combined with an event format for event-based analytics, see Event Formats.
batteryState Battery Status string G Battery Status
Can be combined with an event format for event-based analytics, see Event Formats.
batteryTemperatureCelsius Battery Temperature (C) float G Battery Temperature (C)
Timeseries Data: Stats, Formats & Options
batteryTemperatureFarenheit Battery Temperature (F) float G Battery Temperature (F)
Timeseries Data: Stats, Formats & Options
batteryVoltage Battery Voltage integer G Battery Voltage
Timeseries Data: Stats, Formats & Options
runtimeRemaining Battery Runtime Remaining float G Battery Runtime Remaining
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Battery – Alpha Power

Description

The custom data entities for the power_system_battery_alpha table

Table

cdt_power_system_battery_alpha

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
batteryCurrent Battery Current integer G Battery Current
Timeseries Data: Stats, Formats & Options
batteryPercentRemaining Battery Percent Remaining integer G Battery Percent Remaining
Timeseries Data: Stats, Formats & Options
batteryRecommendedReplaceDate Battery Recommended Replace Date string G, U Battery Recommended Replace Date
batteryReplaceIndicator Battery Replacement Indicator string G Battery Replacement Indicator
Can be combined with an event format for event-based analytics, see Event Formats.
batteryState Battery Status string G, U Battery Status
Can be combined with an event format for event-based analytics, see Event Formats.
batteryTemperatureCelsius Battery Temperature (C) float G Battery Temperature (C)
Timeseries Data: Stats, Formats & Options
batteryTemperatureFarenheit Battery Temperature (F) float G Battery Temperature (F)
Timeseries Data: Stats, Formats & Options
batteryVoltage Battery Voltage integer G Battery Voltage
Timeseries Data: Stats, Formats & Options
runtimeRemaining Battery Runtime Remaining float G Battery Runtime Remaining
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Battery – APC Schneider Electric UPS

Description

The custom data entities for the power_system_battery_apcups table

Table

cdt_power_system_battery_apcups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
batteryCurrent Battery Current integer G Battery Current
Timeseries Data: Stats, Formats & Options
batteryPercentRemaining Battery Percent Remaining integer G Battery Percent Remaining
Timeseries Data: Stats, Formats & Options
batteryRecommendedReplaceDate Battery Recommended Replace Date string G, U Battery Recommended Replace Date
batteryReplaceIndicator Battery Replacement Indicator string G, U Battery Replacement Indicator
Can be combined with an event format for event-based analytics, see Event Formats.
batteryState Battery Status string G, U Battery Status
Can be combined with an event format for event-based analytics, see Event Formats.
batteryTemperatureCelsius Battery Temperature (C) float G Battery Temperature (C)
Timeseries Data: Stats, Formats & Options
batteryTemperatureFarenheit Battery Temperature (F) float G Battery Temperature (F)
Timeseries Data: Stats, Formats & Options
batteryVoltage Battery Voltage integer G Battery Voltage
Timeseries Data: Stats, Formats & Options
runtimeRemaining Battery Runtime Remaining float G Battery Runtime Remaining
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Battery – Generic UPS

Description

The custom data entities for the power_system_battery_generic_ups table

Table

cdt_power_system_battery_generic_ups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
batteryCurrent Battery Current integer G Battery Current
Timeseries Data: Stats, Formats & Options
batteryPercentRemaining Battery Percent Remaining integer G Battery Percent Remaining
Timeseries Data: Stats, Formats & Options
batteryRecommendedReplaceDate Battery Recommended Replace Date string G, U Battery Recommended Replace Date
batteryReplaceIndicator Battery Replacement Indicator string G Battery Replacement Indicator
Can be combined with an event format for event-based analytics, see Event Formats.
batteryState Battery Status string G Battery Status
Can be combined with an event format for event-based analytics, see Event Formats.
batteryTemperatureCelsius Battery Temperature (C) float G Battery Temperature (C)
Timeseries Data: Stats, Formats & Options
batteryTemperatureFarenheit Battery Temperature (F) float G Battery Temperature (F)
Timeseries Data: Stats, Formats & Options
batteryVoltage Battery Voltage integer G Battery Voltage
Timeseries Data: Stats, Formats & Options
runtimeRemaining Battery Runtime Remaining float G Battery Runtime Remaining
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems – Input

Description

The custom data entities for the power_system_input table

Table

cdt_power_system_input

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
inputCurrent Input Current float G Input Current
Timeseries Data: Stats, Formats & Options
inputVoltage Input Voltage float G Input Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Input – Alpha Power

Description

The custom data entities for the power_system_input_alpha table

Table

cdt_power_system_input_alpha

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
inputCurrent Input Current float G Input Current
Timeseries Data: Stats, Formats & Options
inputVoltage Input Voltage float G Input Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Input – APC Schneider Electric UPS

Description

The custom data entities for the power_system_input_apcups table

Table

cdt_power_system_input_apcups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
inputCurrent Input Current float G Input Current
Timeseries Data: Stats, Formats & Options
inputVoltage Input Voltage float G Input Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Input – Generic UPS

Description

The custom data entities for the power_system_input_generic_ups table

Table

cdt_power_system_input_generic_ups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
inputCurrent Input Current float G Input Current
Timeseries Data: Stats, Formats & Options
inputVoltage Input Voltage float G Input Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems – Output

Description

The custom data entities for the power_system_output table

Table

cdt_power_system_output

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
outputCurrent Output Current float G Output Current
Timeseries Data: Stats, Formats & Options
outputLoad Output Load float G Output Load
Timeseries Data: Stats, Formats & Options
outputVoltage Output Voltage float G Output Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Output – Argus/Alpha

Description

The custom data entities for the power_system_output_alpha table

Table

cdt_power_system_output_alpha

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
outputCurrent Output Current float G Output Current
Timeseries Data: Stats, Formats & Options
outputLoad Output Load float G Output Load
Timeseries Data: Stats, Formats & Options
outputVoltage Output Voltage float G Output Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Output – APC Schneider Electric UPS

Description

The custom data entities for the power_system_output_apcups table

Table

cdt_power_system_output_apcups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
outputCurrent Output Current float G Output Current
Timeseries Data: Stats, Formats & Options
outputLoad Output Load float G Output Load
Timeseries Data: Stats, Formats & Options
outputVoltage Output Voltage float G Output Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems Output – Generic UPS

Description

The custom data entities for the power_system_output_generic_ups table

Table

cdt_power_system_output_generic_ups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
outputCurrent Output Current float G Output Current
Timeseries Data: Stats, Formats & Options
outputLoad Output Load float G Output Load
Timeseries Data: Stats, Formats & Options
outputVoltage Output Voltage float G Output Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Power Systems – Status

Description

The custom data entities for the power_system_status table

Table

cdt_power_system_status

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
psMake Make string G Make
psModel Model string G Model
Links

This resource has links to the following:

[reference]  [top]

Power Systems Status – Alpha Power

Description

The custom data entities for the power_system_status_alpha table

Table

cdt_power_system_status_alpha

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
psMake Make string G Make
psModel Model string G, U Model
Links

This resource has links to the following:

[reference]  [top]

Power Systems Status – APC Schneider Electric UPS

Description

The custom data entities for the power_system_status_apcups table

Table

cdt_power_system_status_apcups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
psMake Make string G Make
psModel Model string G, U Model
Links

This resource has links to the following:

[reference]  [top]

Power Systems Status – Generic UPS

Description

The custom data entities for the power_system_status_generic_ups table

Table

cdt_power_system_status_generic_ups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
psMake Make string G Make
psModel Model string G, U Model
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Volts

Description

The custom data entities for the power_volts_sensor table

Table

cdt_power_volts_sensor

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
voltType Volt Type string G type of voltage
volts Volts integer G electrical potential
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Volts – Cisco

Description

The custom data entities for the power_volts_sensor_cisco table

Table

cdt_power_volts_sensor_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
voltType Volt Type string G type of voltage
volts Volts integer G electrical potential
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Volts – Entity

Description

The custom data entities for the power_volts_sensor_entity table

Table

cdt_power_volts_sensor_entity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
voltType Volt Type string G type of voltage
volts Volts integer G electrical potential
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Watts

Description

The custom data entities for the power_watts_sensor table

Table

cdt_power_watts_sensor

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
watts Watts integer G power
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Watts – Cisco

Description

The custom data entities for the power_watts_sensor_cisco table

Table

cdt_power_watts_sensor_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
watts Watts integer G power
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Sensor – Power – Watts – Entity

Description

The custom data entities for the power_watts_sensor_entity table

Table

cdt_power_watts_sensor_entity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
watts Watts integer G power
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Printer

Description

The custom data entities for the printer table

Table

cdt_printer

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
Links

This resource has links to the following:

[reference]  [top]

Printer – General

Description

The custom data entities for the printer_general table

Table

cdt_printer_general

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
MarkerSuppliesLevel Marker Supplies Level integer G The current level of the supply container
Timeseries Data: Stats, Formats & Options
MarkerSuppliesMaxCapacity Marker Supplies Max Capacity string G, U The maximum capacity of the supply container
SerialNumber Serial Number string G Printer serial number
Links

This resource has links to the following:

[reference]  [top]

Custom Data Type Ranges

Description

IP address ranges for discovering custom data type entities

Table

cdt_ranges

Fields
Field ID Field Title Type Get, Add, Update Description
id ID string G Custom data type identifier/key
autoremove Autoremove string G, U Whether discovery should remove data not in latest rewalk, one of:

  • on
  • off
  • default
ranges Ranges string G, U IP address ranges (using include/exclude syntax)
enable Enable integer G, U Whether discovery is enabled for this CDT, one of:

  • 0
  • 1
[reference]  [top]

SonicWall VPN Users

Description

The custom data entities for the sonicwall_vpn_users table

Table

cdt_sonicwall_vpn_users

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
activeNetExtenderConnections Active NetExtender Connections integer G Active NetExtender Connections
Timeseries Data: Stats, Formats & Options
activeUserLicense Active User Licenses integer G User Licenses in use.
Timeseries Data: Stats, Formats & Options
activeUsers Active Users integer G Active User Sessions
Timeseries Data: Stats, Formats & Options
activeVirtualAssistTechnicians Active VirtualAssist Technicians integer G Active Virtual Assist Technicians
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature

Description

The custom data entities for the temperature table

Table

cdt_temperature

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Alcatel

Description

The custom data entities for the temperature_alcatel table

Table

cdt_temperature_alcatel

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Alcatel – AOS7

Description

The custom data entities for the temperature_alcatel_aos7 table

Table

cdt_temperature_alcatel_aos7

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – APC

Description

The custom data entities for the temperature_apc_env table

Table

cdt_temperature_apc_env

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – APC Internal

Description

The custom data entities for the temperature_apc_int table

Table

cdt_temperature_apc_int

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Avaya – S5

Description

The custom data entities for the temperature_avaya_s5 table

Table

cdt_temperature_avaya_s5

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Cisco

Description

The custom data entities for the temperature_cisco table

Table

cdt_temperature_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G, U Description of this entity
temperatureState State string G, U Current state of the entity, one of:

  • critical
  • normal
  • notFunctioning
  • notPresent
  • shutdown
  • warning

Can be combined with an event format for event-based analytics, see Event Formats.

temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Dell F10 S

Description

The custom data entities for the temperature_dell_F10_S table

Table

cdt_temperature_dell_F10_S

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Dell DNOS

Description

The custom data entities for the temperature_dell_dnos table

Table

cdt_temperature_dell_dnos

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Dell PowerConnect

Description

The custom data entities for the temperature_dell_power table

Table

cdt_temperature_dell_power

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Extreme

Description

The custom data entities for the temperature_extreme table

Table

cdt_temperature_extreme

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Extreme VSP

Description

The custom data entities for the temperature_extreme_vsp table

Table

cdt_temperature_extreme_vsp

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Foundry

Description

The custom data entities for the temperature_foundry table

Table

cdt_temperature_foundry

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Foundry MLX

Description

The custom data entities for the temperature_foundry_mlx table

Table

cdt_temperature_foundry_mlx

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G, U Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Juniper

Description

The custom data entities for the temperature_juniper table

Table

cdt_temperature_juniper

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G, U Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Netscreen

Description

The custom data entities for the temperature_netscreen table

Table

cdt_temperature_netscreen

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G, U Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Sensor

Description

The custom data entities for the temperature_sensor table

Table

cdt_temperature_sensor

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G, U Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Temperature – Cisco Sensor

Description

The custom data entities for the temperature_sensor_cisco table

Table

cdt_temperature_sensor_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
temperatureDescr Description string G, U Description of this entity
temperatureType Vendor string G Vendor for this entity
temperatureValueCelsius Celsius float G Temperature in celsius
Timeseries Data: Stats, Formats & Options
temperatureValueFahrenheit Fahrenheit float G Temperature in fahrenheit
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Ubiquiti AirMAX

Description

The custom data entities for the ubiquiti_airmax table

Table

cdt_ubiquiti_airmax

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
capacity Capacity integer G AirMAX Capacity
Timeseries Data: Stats, Formats & Options
quality Quality integer G AirMAX Quality
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Ubiquiti Radio

Description

The custom data entities for the ubiquiti_radio table

Table

cdt_ubiquiti_radio

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
TxPower Transmit Power integer G, U The current transmit power
frequency Operating Frequency integer G, U The current operating frequency
mode Operating Mode string G, U The current mode, one of:

  • ap
  • aprepeater
  • apwds
  • sta
Links

This resource has links to the following:

[reference]  [top]

Ubiquiti Wireless Statistics

Description

The custom data entities for the ubiquiti_wl_stats table

Table

cdt_ubiquiti_wl_stats

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ApMac AP MAC address string G, U The MAC address of the connected AP
RxBps Rx Bps integer G The current received bitrate
Timeseries Data: Stats, Formats & Options
TxBps Tx Bps integer G The current transmitted bitrate
Timeseries Data: Stats, Formats & Options
ccq CCQ integer G Client Connection Quality
Timeseries Data: Stats, Formats & Options
count Station Count integer G The number of stations currently connected (Only valid if in AP mode)
Timeseries Data: Stats, Formats & Options
rssi RSSI integer G Received Signal Strength Indicator
Timeseries Data: Stats, Formats & Options
strength Signal Strength integer G The current signal strength
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

UPS

Description

The custom data entities for the ups table

Table

cdt_ups

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
batteryCurrent Battery Current float G Battery Current
Timeseries Data: Stats, Formats & Options
batteryPercentRemaining Battery Percent Remaining float G Battery Percent Remaining
Timeseries Data: Stats, Formats & Options
batteryVoltage Battery Voltage float G Battery Voltage
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

UPS – APC

Description

The custom data entities for the ups_apc table

Table

cdt_ups_apc

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
advInputLineVoltage Input Line Voltage integer G Timeseries Data: Stats, Formats & Options
advOutputCurrent Output Current integer G Timeseries Data: Stats, Formats & Options
advOutputVoltage Output Voltage integer G Timeseries Data: Stats, Formats & Options
batteryCurrent Battery Current float G Battery Current
Timeseries Data: Stats, Formats & Options
batteryPercentRemaining Battery Percent Remaining float G Battery Percent Remaining
Timeseries Data: Stats, Formats & Options
batteryReplaceIndicator Battery Replace Indicator string G, U One of:

  • batteryNeedsReplacing
  • noBatteryNeedsReplacing


Can be combined with an event format for event-based analytics, see Event Formats.

batteryVoltage Battery Voltage float G Battery Voltage
Timeseries Data: Stats, Formats & Options
phaseInputCurrent Phase Input Current integer G Timeseries Data: Stats, Formats & Options
phaseInputVoltage Phase Input Voltage integer G Timeseries Data: Stats, Formats & Options
phaseOutputCurrent Phase Output Current integer G Timeseries Data: Stats, Formats & Options
phaseOutputVoltage Phase Output Voltage integer G Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

UPS – Generic

Description

The custom data entities for the ups_generic table

Table

cdt_ups_generic

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
batteryCurrent Battery Current float G Battery Current
Timeseries Data: Stats, Formats & Options
batteryPercentRemaining Battery Percent Remaining float G Battery Percent Remaining
Timeseries Data: Stats, Formats & Options
batteryStatus Battery Status string G, U One of:

  • batteryDepleted
  • batteryLow
  • batteryNormal
  • unknown

Can be combined with an event format for event-based analytics, see Event Formats.

batteryVoltage Battery Voltage float G Battery Voltage
Timeseries Data: Stats, Formats & Options
inputCurrent Input Current integer G Timeseries Data: Stats, Formats & Options
inputVoltage Input Voltage integer G Timeseries Data: Stats, Formats & Options
outputCurrent Output Current integer G Timeseries Data: Stats, Formats & Options
outputSource Output Source string G, U One of:

  • battery
  • booster
  • bypass
  • none
  • normal
  • other
  • reducer

Can be combined with an event format for event-based analytics, see Event Formats.

outputVoltage Output Voltage integer G Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Cisco WAAS

Description

The custom data entities for the waas_cisco table

Table

cdt_waas_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
cwoTfoStatsActiveOptConn Active Opt Connections integer G This object contains number of currently active TCP connections getting optimized
Timeseries Data: Stats, Formats & Options
cwoTfoStatsActiveOptTCPPlusConn TCP Plus Opt Connections integer G This object contains number of active TCP connections going through TCP plus other optimization
Timeseries Data: Stats, Formats & Options
cwoTfoStatsLoadStatus Load Status integer G, U This object indicates the load status of the Traffic Flow Optimizer.
Can be combined with an event format for event-based analytics, see Event Formats.
This object indicates the load status of the Traffic Flow Optimizer, one of:

  • 1 – unknown, feature is not active or disabled
  • 2 – green, feature is operating normally, within acceptable load limits
  • 3 – yellow, feature is overloaded, and new connections received by it may not get optimized
  • 4 – red, feature is not healthy, and existing as well as new connections received by it may not get optimized


Can be combined with an event format for event-based analytics, see Event Formats.

cwoTfoStatsMaxActiveConn Max Connections integer G This object contains maximum number of active TCP connections that this device can optimize. This figure need only be pooled irregularly and used as the 100% highWaterMark for active connection count threshold assessment or x axis scaling.
Timeseries Data: Stats, Formats & Options
cwoTfoStatsTotalOptConn Total Opt Connections integer G This object contains total number of TCP connections optimized since TFO was started or its statistics were last reset
Timeseries Data: Stats, Formats & Options
Links

This resource has links to the following:

[reference]  [top]

Wireless AP

Description

The custom data entities for the wireless_ap table

Table

cdt_wireless_ap

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ClientCount Clients integer G Clients
Timeseries Data: Stats, Formats & Options
vendor Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

Wireless AP – Cisco

Description

The custom data entities for the wireless_ap_cisco table

Table

cdt_wireless_ap_cisco

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ActiveBridges Active Bridges integer G This is the number of bridges currently associating with this device on this interface.
Timeseries Data: Stats, Formats & Options
ActiveRepeaters Active Repeaters integer G This is the number of repeaters currently associating with this device on this interface.
Timeseries Data: Stats, Formats & Options
ClientCount Clients integer G Clients
Timeseries Data: Stats, Formats & Options
ClientsAssociated Client Associations integer G This object counts the number of stations associated with this device on this interface since device re-started.
Timeseries Data: Stats, Formats & Options
ClientsAuthenticated Client Auths integer G This object counts the number of stations authenticated with this device on this interface since device re-started.
Timeseries Data: Stats, Formats & Options
ClientsDeauthenticated Client DeAuths integer G This object counts the number of stations deauthenticated with this device on this interface since device re-started.
Timeseries Data: Stats, Formats & Options
ClientsRoamedAway Roamed Away integer G This object counts the number of stations roamed away from this device on this interface since device re-started.
Timeseries Data: Stats, Formats & Options
ClientsRoamedIn Roamed In integer G This object counts the number of stations roamed from another device to this device on this interface since device re-started.
Timeseries Data: Stats, Formats & Options
CurrentChannel Channel integer G The current operating frequency channel of the DSSS PHY, as selected either by selective scanning or via IEEE802dot11-MIB dot11CurrentChannel. Valid channel numbers are defined in the IEEE 802.11 Standard. For North America, 802.11b channels allowed are 1 to 11 and 802.11a channels allowed are 36,40,44,48,52,56, 60, and 64.
Timeseries Data: Stats, Formats & Options
CurrentTxPowerLevel Power Level integer G The TxPowerLevel N currently configured to transmit data.
Timeseries Data: Stats, Formats & Options
vendor Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

Wireless AP – Extreme

Description

The custom data entities for the wireless_ap_extreme table

Table

cdt_wireless_ap_extreme

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G The entity identifier
name Name string G The entity name
deviceid Device ID integer G The ID of the parent device
idx Index string G The base SNMP index for this entity
table Table string G The table to which the entity belongs
poll Poll State string G The poll state of the entity

  • on
  • off
ClientCount Clients integer G Clients
Timeseries Data: Stats, Formats & Options
vendor Vendor string G Vendor
Links

This resource has links to the following:

[reference]  [top]

Configuration Build

Description

Build the custom datatype configurations

Table

config_build

Fields

No Fields

Options – force
force key Description
true Force a build, even if no changes have occurred
false Only run a build if changes have occurred
[reference]  [top]

Discover

Description

Statseeker Discovery Process

Table

discover

Fields

No Fields

Options
Option Description
block Block if another discover is running, defaults to false. Set to one of:

  • false – return an error if another discover is running
  • true – block if another discover is running
device Requires mode = rewalk.
Optional, name of the device to rewalk
discover_config Override discover configuration
email A list of comma-separated email addresses. When selected the output log will be emailed to these addresses on completion of the task. If logfile is set, the logfile will be kept, otherwise a temporary logfile is used which is later removed. If subject is set, the value will be used for the email subject, otherwise a default subject line is used
getNext Requires mode = single.
Discover using SNMP getNext, defaults to false.

  • false – use bulk requests for discovery
  • true – use getNext requests for discovery
ip Requires mode = single.
The IP address of the device being discovered.
logfile Path to store the discover log, defaults to ~/nim/etc/discover.log
minimal Requires mode = single
Whether to perform a minimal discover, defaults to false. Set to one of:

  • false – perform full discover
  • true – perform minimal discover (only walk a few core tables)
mode The type of discovery to run, set to one of:

  • hosts – discover all devices in the hostfile
  • ranges – discover all devices in the IP scan ranges file
  • rewalk – rewalk devices that have previously been discovered
  • single – discover a single device
  • snmpv3add – discover SNMPv3 devices
runPostProcessing Whether to run discover post-processing steps. Currently this includes Auto-grouping and the Hardware Inventory report generation. This will result in a quicker discover but means that the added devices won’t be added to any Auto-groups or the Hardware Inventory report until the next full discover, defaults to true. Set to one of:

  • false – don’t perform post processing steps
  • true – perform post processing steps
snmperrlog Enable SNMP error logging, defaults to false. Set to one of:

  • false – disable SNMP error logging
  • true – enable SNMP error logging
snmpv1 Requires mode = single.
Force SNMPv1 collection, defaults to false.

  • false – allow SNMPv2 collection
  • true – force SNMPv1 collection
subject The subject line to use when the email option is specified
verbose Verbosity level for discovery process output, defaults to 0. Set to one of:

  • 0 – disable verbose output
  • 1 – set output verbosity to low
  • 2 – set output verbosity to medium
  • 3 – set output verbosity to high
snmpv3config Requires mode = snmpv3add.
Path to the config file containing details of devices to add.

Run with the execute command (/api/v2.1/discover/execute), see the Execute Endpoint for details.

[reference]  [top]

Discover Configuration

Description

The configuration options for Statseekers’ discovery mechanism

Table

discover_config

Fields
Field ID Field Title Type Get, Add, Update Description
communities Community Strings object G, U Comma separated SNMPv1 and SNMPv2 community strings
id ID integer G Discover config identifier/key
iftype Interface Types object G, U Comma separated list of interface types to include
ip_range_configurations Per IP Address Range Configuration object G, U An array of Discover Configuration objects associated to IP Address Ranges. Each configuration in the array contains the following fields:

Field ID Type Description
communities string Comma separated SNMPv1 and SNMPv2 community strings
enabled boolean Set the range configuration to be enabled/disabled
excludes string Comma separated sysdescr strings for entities to exclude from the configuration
iftypes string Comma separated iftypes strings for entities to include in the configuration
includes string Comma separated sysdescr strings for entities to include in the configuration
ip_range_text string Include range string specifying the IP range to be covered by the configuration
title string Name for the configuration rule

These configurations are in addition to the global discovery settings for the IP range specified in ranges. This allows you to apply specific include/exclude rules based on sysDescr and iftype to select IP ranges, and to restrict which community strings are sent to a given IP.

Note: community strings, and include/exclude rules, added in this way are in addition to the global rules, they do not replace the global rules. All exclude rules take precedence over any include rule.
ping_count Ping Run Count integer G, U Number of passes for the ping discover
ping_skip Ping Skip integer G, U Number of ipaddress to skip between each ping
ranges Ranges object G, U Comma separated discover ranges (using include/exclude syntax)
sysdescr SysDescr object G, U Comma separated SysDescr values to decide which devices to discover
ping_rate Ping Rate integer G, U Number of pings to send per second
[reference]  [top]

Discover Hosts

Description

Hosts used for discovery

Table

discover_hosts

Fields
Field ID Field Title Type Get, Add, Update Description
enable Enabled integer G, U, A Whether this host is enabled for discovery, one of:

  • 0
  • 1
hostname Hostname string G, U, A (required) Name of the host
id ID integer G Host identifier
ipaddress IP Address string G, U, A (required) IP address of the host
[reference]  [top]

Statseeker Entities

Description

Entries in the Statseeker entity database

Table

entity

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G Entity identifier/key
name Name string G The name of the entity
parentid Parent ID integer G The id of the entities parent
parentname Parent Name string G The name of the entities parent
type Type string G The entity type
[reference]  [top]

Event Entity Details

Description

Statseeker Events

Table

event

Fields
Field ID Field Title Type Get, Add, Update Description
availability Availability object G Statistics describing specific states for this event, can be used with the following formats:

Formats Description
inPercent The percent of time the event has been in any of the requested states
inTime The time the event has been in any of the requested states
inTransitions The number of transitions from one of the requested states to a state not requested
outPercent The percent of time the event has not been in any of the states
outTime The time the event has not been in any of the requested states
outTransitions The number of transitions from a state that wasn’t request to a requested state
totalTransitions The total number of transition between all of the states
description Description string G, U, A (required) A description of the type of event
device Device string G The name of the device that owns the entity
deviceid Device ID integer G The ID of the device that owns the entity
entity Entity string G The name of the entity that owns the event
entityid Entity ID integer G, U, A (required) The ID of the entity that owns the entity
entityTypeName Entity Type Name string G The name of the type of entity that owns the event
entityTypeTitle Entity Type Title string G The title of the type of entity that owns the event
id ID integer G Event Identifier
status Current Status object G The current state of the event, can be used with the following formats

Formats Description
delta The number of seconds to the previous record
inTime The number of seconds that the current state has been active
stateid The current state identifier of the event
time The time of of the last transition
state The current state of the event
Links

This resource has links to the following:

[reference]  [top]

Events

Description

Statseeker Event Records

Table

event_record

Fields
Field ID Field Title Type Get, Add, Update Description
delta Delta integer G The number of seconds since the last record of the same event
device Device string G The name of the device that owns the entity
deviceid Device ID integer G The ID of the device that owns the entity
entity Entity string G The name of the entity that owns the event
entityid Entity ID integer G, A The ID of the entity that owns the entity
entityTypeName Entity Type Name string G The name of the type of entity that owns the event
entityTypeTitle Entity Type Title string G The title of the type of entity that owns the event
event Event string G, A The event text associated to the record
eventid Event ID integer G, A (required) The event id associated to the record
id ID string G Event Record Identifier
note Note string G, U The note associated with the record
state State string G, A (required) The state text associated to the record
stateid State ID integer G, A The state id associated to the record
time Time integer G, A Epoch time that the record was created
Options
  • lastx – Display the last x records, rather than using a timefilter
Links

This resource has links to the following:

[reference]  [top]

Field

Description

API Fields

Table

field

Fields
Field ID Field Title Type Get, Add, Update Description
name Name string G Name of the field
datatype Data Type string G Data Type
polltype Poll Type string G Poll Type
interval Interval integer G Polling interval
id ID integer G Field Identifier
title Title string G Title of the field
description Description string G Description of the field
units Units string G Data units (eg, bits, bytes, packets)
enum Enum object G Valid values for this type
objectid Object ID integer G Object Identifier
Links

This resource has links to the following:

[reference]  [top]

Group

Description

API Groups

Table

group

Fields
Field ID Field Title Type Get, Add, Update Description
entities Entities object G, U The entities that are assigned to this group

Formats Description
count Number of entities assigned to the group
exc_count Number of entities assigned to the group (excluding child entities not explicitly assigned)
exc_hexstr Hex bitstring representation of assigned entities (excluding child entities not explicitly assigned)
exc_list Array of entity ids assigned to the group (excluding child entities not explicitly assigned)
hexstr Hex bitstring representation of assigned entities
list Array of entity ids assigned to the group
objects Array of object names that have entities assigned to the group
id ID integer G ID of the group
name Name string G, A (required), U Name of the group


Group Mode

The Group object requires a mode be specified when performing PUT requests to make changes to the group’s members (entities). The mode specifies what the API should do with the entities when making changes.

Mode Description
clear Remove the specified entities from the group
set Remove all existing entities and then add the specified entities to the group
add Add the specified entities to the group
[reference]  [top]

License

Description

Statseeker License

Table

license

Fields
Field ID Field Title Type Get, Add, Update Description
custnum Customer Number object G, A Valid customer number/server ID
end End object G License end time
entityCounts Entity Counts object G Number of polled, exceeded and total entities for each Custom Data Type
feature95thPercent Feature – 95 Percentile reporting object G 95th percent feature status
featureAnomaly Feature – Anomaly Detection object G Anomaly detection feature status
featureAPIRead Feature – API Read object G API Read feature status
featureAPIWrite Feature – API Write object G API Write feature status
featureCDR Feature – Custom Data Reporting object G CDR feature status
featureCDT Feature – Custom Data Types object G CDT feature status
featureDash Feature – Dashboard object G Dashboard feature status
featureFastpoll Feature – 1 Second Poller object G 1 second poller feature status
featureFastpollExt Feature – 1 Second Poller: Extended object G 1 Second Poller: Extended feature status
featureForecast Feature – Forecasting object G Forecasting feature status
featureHA Feature – High Availability object G HA feature status
featureIPv6 Feature – IPv6 object G IPv6 feature status
featureL2Subnet Feature – Layer 2 Subnet object G Layer 2 Subnet feature status
featureMIS Feature – Mac/IP Switch object G Mac/IP switch feature status
featureMultiTennant Feature – Multitennant UI object G Multitennant feature status
featureNetflow Feature – Netflow object G Netflow feature status
featureNthPercent Feature – Custom percentile reporting object G Nth percent feature status
featureSDN Feature – SDN object G SDN feature status
featureSpanningTree Feature – Spanning Tree object G Spanning Tree feature status
featureTrend Feature – Trendlines object G Trendlines feature status
featureUD Feature – Upstream Devices object G Upstream devices feature status
featureUserAuth Feature – Extended User Authentication object G Extended user authentication feature status
hardwareid Hardware ID object G Valid Hardware ID’s
id ID integer G License Identifier
key Key object G, A (required) License Key
limitCustom Custom Entity Limit object G Number of custom entities polled/allowed
limitDevice Device Limit object G Number of devices polled/allowed
limitMISHistory MIS History Limit object G Maximum allowed history for MIS data
limitPort Port Limit object G Number of ports polled/allowed
start Start object G License start time
tier Tier object G License Tier
version Statseeker Version string G The version of this statseeker installation
Options – test
test key Description
true Test the license
false Add the license
[reference]  [top]

API Links

Description

Configured links for API objects

Table

link

Fields
Field ID Field Title Type Get, Add, Update Description
default Default integer G, A (required), U Whether the link is the default between the src and dst
dst Destination Object string G, A (required), U Name of the destination object
dst_fields Destination Fields object G, A (required), U Field definitions referenced by the destination query
dst_query Destination Query string G, A (required), U Formula to apply to the destination object
id ID integer G Link identifier
name Name string G, A (required), U The name of the link
src Source Object string G, A (required), U Name of the source object
src_fields Source Fields object G, A (required), U Field definitions referenced by the source query
src_query Source Query string G, A (required), U Formula to apply to the source object
title Title string G, A (required), U The title of the link
type Type string G The type of the link
[reference]  [top]

MAC Records

Description

MAC Information

Table

mac

Fields
Field ID Field Title Type Get, Add, Update Description
portid Interface ID integer G, A, U The port on the device the MAC address belongs to (if known)
firstseen First Seen time G, A, U The first time MIS collector saw this MAC
deviceid Device ID integer G, U The Device the MAC address belongs to (if known)
oui Vendor string G, A, U The Vendor associated to MAC
name MAC string G, A (required), U The MAC represented as a string
id ID integer G, A, U MAC Identifier
lastseen Last Seen time G, A, U The last time MIS collector saw this MAC
lastmisrec Last MIS Record time G, A, U The last time MIS collector added a record for this MAC
Links

This resource has links to the following:

[reference]  [top]

Message

Description

Statseeker Messages

Table

message

Fields
Field ID Field Title Type Get, Add, Update Description
entity Entity string G The name of the entity that owns this message
entityid Entity ID integer G, A (required) The ID of the entity that owns this message
id ID integer G Message Identifier
text Message Text string G, A (required) The message text
time Time integer G Message Time
type Type string G, A (required) Message Type
Options
  • lastx – Display the last x records, rather than using a timefilter
Links

This resource has links to the following:

[reference]  [top]

MAC/IP/Switch Port Records

Description

Individual MAC/IP/Switchport records

Table

mis_record

Fields
Field ID Field Title Type Get, Add, Update Description
vlan_id VLAN Id integer G, A VLAN ID on port which MAC address was seen
id ID integer G Record Identifier
time Time time G, A (required) The time when the MIS record was inserted
connected_port Connected Interface integer G, A Interface ID of port MAC was seen on
connected_device Connected Device integer G, A Device ID MAC was seen on
ip IP Address string G, A The IP Address of the End Device
name MAC string G, A (required) MAC Address
vlan_name VLAN Name string G, A VLAN Name on port which MAC address was seen
arp_router ARP Device integer G, A The device whose ARP cache the MAC address was retrieved from
Links

This resource has links to the following:

[reference]  [top]

NIM Options

Description

Configuration options for statseeker

Table

nim_options

Fields
Field ID Field Title Type Get, Add, Update Description
id ID string G Option identifier/key
value Value string G, U Option value
[reference]  [top]

Notifications

Description

Notifications for Statseeker

Table

notification

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G Notification identifier/key
message Message string G, A (required), U The notification message
status Status string G, A, U The status of notification
timestamp Timestamp time G, A, U The time that the notification was created
type Type string G, A (required), U The type of notification, one of:

  • error
  • warning
  • info
[reference]  [top]

Object

Description

API Objects

Table

object

Fields
Field ID Field Title Type Get, Add, Update Description
category Category string G Category of object
commands Commands object G The valid commands for an object
description Description string G Description of the object
fields Fields object G The valid fields for an object
id ID integer G Object Identifier
inherits Inherits object G Object inherits list
name Name string G Name of the object
title Title string G Title of the object
[reference]  [top]

APIC Configurations

Description

APIC Configuration details which will be used for ACI Poller

Table

spe_aci

Fields
Field ID Field Title Type Get, Add, Update Description
cleanup Cleanup Interval string G, U, A Cleanup interval for stale entities
id ACI Device ID integer G, A (required) ACI Device ID
password Password string G, U, A (required) Password for APIC User
port APIC Port integer G, U, A APIC Port
proto APIC Protocol string G, U, A APIC Protocol, one of:

  • http
  • https
username User string G, U, A (required) Username to use for communication with APIC Device
[reference]  [top]

Syslog

Description

Syslog Messages

Table

syslog

Fields
Field ID Field Title Type Get, Add, Update Description
entity Entity string G The name of the entity that owns this message
entityid Entity ID integer G, A (required) The ID of the entity that owns this message
id ID integer G Message Identifier
text Message Text string G, A (required) The message text
time Time integer G Message Time
type Type string G, A (required) Message Type
Options
  • lastx – Display the last x records, rather than using a timefilter
Links

This resource has links to the following:

[reference]  [top]

Task

Description

Statseeker Task

Table

task

Fields
Field ID Field Title Type Get, Add, Update Description
commands Commands object G, U, A (required) Array of api commands to run (will be run sequentially)
id ID integer G Task Identifier
progress Progress integer G, U Percentage completed of the task
results Results object G, U Array of api results for the commands (only most recently result displayed)
status Status string G, U Current status of the task
time Time object G, U, A Time to run the command, can be used with the following formats:

formats key Description
cron Cron format string, for recurring tasks
unix Unix/Epoch timestamp
ttl Time to Live integer G, U, A The number of seconds to keep the task results
[reference]  [top]

Threshold Configuration

Description

Statseeker Thresholds

Table

threshold

Fields
Field ID Field Title Type Get, Add, Update Description
above Above integer G, U, A Whether the threshold triggers on above or below the specified value, one of:

  • 0 – below
  • 1 – above
enabled Enabled integer G, U, A Whether the threshold is enabled or disabled
field Field string G, A (required) The field associated to the threshold
field_opts Field Options object G, U, A Any options provided to the field
filters Filters object G, U, A The filters to use for retrieving the data
format Format string G, A (required) The format to use for the threshold field, one of:

  • Average
  • Total
  • Maximum
  • Median
  • Minimum
  • Standard Deviation
  • 95th Percentile
  • Percentile
  • Count
  • Anomaly Metric
  • Anomaly Strength
  • Trendline Start
  • Trendline Finish
  • Trendline Change
  • Trendline Daily Change
  • Trendline Percent Change
  • Trendline Strength
  • Trendline Prediction
  • Baseline Average
  • Baseline Comparison
  • Forecast Value
  • Forecast Upper Value
  • Forecast Lower Value
  • Forecast Daily Change
group_by_format Group by Format string G, A If provided, thresholds will use this format to aggregate data by device, one of:

  • Average
  • Maximum
  • Median
  • Minimum
  • Standard Deviation
  • Total
  • 95th Percentile
  • Disabled
id ID integer G Threshold Identifier
interval Interval integer G, U, A (required) The interval to apply to the time filter query
name Name string G, A (required) The name of the threshold
object Object string G, A (required) The object type associated to the threshold
timefilter Time Filter string G, U, A The time filter query to use for retrieving the data
trigger Trigger string G, U, A The type of trigger to be used for alerting, one of:

  • breach
  • transition
tz Time Zone string G, U, A The time zone to use for the time filter query
value Value float G, A (required) The threshold value
[reference]  [top]

Threshold Entity Details

Description

Statseeker Threshold Events

Table

threshold_event

Fields
Field ID Field Title Type Get, Add, Update Description
description Description string G A description of the type of event
device Device string G The name of the device that owns the entity
deviceid Device ID integer G The ID of the device that owns the entity
entity Entity string G The name of the entity that owns the event
entityid Entity ID integer G The ID of the entity that owns the entity
entityTypeName Entity Type Name string G The name of the type of entity that owns the event
entityTypeTitle Entity Type Title string G The title of the type of entity that owns the event
id ID integer G Event Identifier
status Current Status object G The current state of the event, can be used with the following formats:

formats key Description
time The time of of the last transition
delta The number of seconds to the previous record
stateid he current state identifier of the event
state The current state of the event
value The value of the data that triggered the transition
breach Where the event is breached
threshold Threshold Name string G The name of the threshold that owns the event
thresholdAbove Threshold Above bool G A boolean indicating whether the threshold breach state is above or below the threshold
thresholdField Threshold Field string G The timeseries field of the threshold that owns the event
thresholdFormat Threshold Format string G The timeseries format of the threshold that owns the event
thresholdid Threshold ID integer G The id of the threshold that owns the event
thresholdInterval Threshold Interval integer G The interval of the threshold that owns the event
thresholdTable Threshold Object string G The object/table of the threshold that owns the event
thresholdValue Threshold Value float G The trigger value of the threshold that owns the event
transitions Transitions object G Statistics describing specific state transitions for this event, can be used with the following formats:

Formats Description
outPercent The percent of time the event has not been in any of the states
inTime The time the event has been in any of the requested states
outTime The time the event has not been in any of the requested states
totalTransitions The total number of transition between all of the states
inTransitions The number of transitions from one of the requested states to a state not requested
inPercent The percent of time the event has been in any of the requested states
outTransitions The number of transitions from a state that wasn’t request to a requested state
Links

This resource has links to the following:

[reference]  [top]

Threshold Events

Description

Statseeker Threshold Records

Table

threshold_record

Fields
Field ID Field Title Type Get, Add, Update Description
delta Delta integer G The number of seconds since the last record of the same event
device Device string G The name of the device that owns the entity
deviceid Device ID integer G The ID of the device that owns the entity
entity Entity string G The name of the entity that owns the event
entityid Entity ID integer G The ID of the entity that owns the entity
entityTypeName Entity Type Name string G The name of the type of entity that owns the event
entityTypeTitle Entity Type Title string G The title of the type of entity that owns the event
event Event string G The event text associated to the record
eventid Event ID integer G The event id associated to the record
id ID string G Threshold Record Identifier
note Note string G, U The note associated with the record
state State string G The state text associated to the record
stateid State ID integer G The state id associated to the record
thresholdid Threshold ID integer G The id of the threshold that owns the event
time Time integer G Epoch time that the record was created
value Breach Value float G Value that triggered the threshold breach.
Options
  • lastx – Display the last x records, rather than using a timefilter
Links

This resource has links to the following:

[reference]  [top]

Time Filter

Description

Time filter favorites

Table

timefilter

Fields
Field ID Field Title Type Get, Add, Update Description
id ID integer G Time filter identifier
locked Locked integer G Whether the time filter is locked, one of:

  • 0
  • 1
name Name string G, U, A (required) Time filter name
order Order integer G, U, A Sort order for the time filter
query Query string G, U, A (required) Time filter query
user User integer G User that created the time filter
[reference]  [top]

Trap

Description

Trap Messages

Table

trap

Fields
Field ID Field Title Type Get, Add, Update Description
entity Entity string G The name of the entity that owns this message
entityid Entity ID integer G, A (required) The ID of the entity that owns this message
id ID integer G Message Identifier
text Message Text string G, A (required) The message text
time Time integer G Message Time
type Type string G, A (required) Message Type
Options
  • lastx – Display the last x records, rather than using a timefilter
Links

This resource has links to the following:

[reference]  [top]

User

Description

Statseeker Users

Table

user

Fields
Field ID Field Title Type Get, Add, Update Description
api API Access string G, U, A User API access permission, one of:

  • r
  • rw
auth Authentication method string G, U, A User authentication method, one of:

  • file
  • ldap
  • radius
auth_refresh Authentication Refresh integer G, U, A The time allowed after a token has expired that it will be refreshed (in seconds)
auth_ttl Authentication TTL integer G, U, A The TTL for authentication tokens (in seconds)
email Email string G, U, A User email address
exportDateFormat Date Format string G, U, A User specified Date Format
id ID integer G User Identifier
is_admin Is Admin integer G, U, A Whether the user has admin access, one of:

  • 0
  • 1
name Name string G, A (required) User name
password Password string G, U, A User password
reportRowSpacing Report Row Spacing string G, U, A The report row spacing preference for the user
top_n Top N integer G, U, A The default Top N number for the user
tz Time Zone string G, U, A User time zone
[reference]  [top]

Timeseries Data: Stats, Formats, Aggregation Formats, and Field Options

All Statseeker timeseries data metrics can have a statistical analysis applied to the raw data prior to being displayed in tables or graphs. The combination of stats, formats, and field option values that can be specified for a given metric offer you the flexibility to present your data in a condensed, easy to interpret and meaningful manner.

Timeseries Field Formats

Implemented with:{field}_formats={formats}

Format Required Field Option Description
95th 95th percentile of the data
anomaly_metric Metric from -100 to 100 indicating whether requested timeseries values are unusually large or small
anomaly_strength Metric from 0 to 100 indicating whether requested timeseries values are extreme or unusual
avg Average of the data
baseline List of expected baseline values calculated from historical data. Corresponds to 0% anomaly metric.
baseline_avg Average of expected baseline values calculated from historical data. Corresponds to 0% anomaly metric.
baseline_compare Difference between data average and expected baseline calculated from historical data
baseline_lwr List of baseline lower confidence interval values. Corresponds to -95% anomaly metric.
baseline_percent_compare Percentage difference between data average and expected baseline calculated from historical data
baseline_upr List of baseline upper confidence interval values. Corresponds to 95% anomaly metric.
count Number of non-null data points
current The current value
cvals Cumulative data values
first The first value in the data
forecast_boundary_time forecast.predict_time Time forecast exceeds feasible value range if before end of timefilter range
forecast_daily_change The average daily change of forecast values
forecast_fit forecast.predict_range An array of forecast values without periodic deviations at peak and offpeak times
forecast_max Upper boundary of feasible forecast value range
forecast_min Lower boundary of feasible forecast value range
forecast_predict forecast.predict_time Long term prediction value calculated from historical data
forecast_predict_offpeak forecast.predict_time Long term prediction value calculated from historical data at offpeak times
forecast_predict_peak forecast.predict_time Long term prediction value calculated from historical data at peak times
forecast_vals forecast.predict_range An array of forecast values with periodic deviations at peak and offpeak times
last ‘The last value in the data
max Maximum data value
median Median of the data
min Minimum data value
percentile Custom percentile of the data
start_time Time of the first data point
start_tz_offset The timezone offset of the first data point
stddev Standard deviation of the data
total Sum of the data
trendline_change Trendline change over the requested timefilter range
trendline_daily_change Slope of the trendline (units/day)
trendline_finish Value of the last trendline data point
trendline_fit Trendline data values
trendline_lwr Trendline confidence interval values (lower)
trendline_percent_change Trendline change scaled by the average of data over requested time filter
trendline_predict trendline.predict_time Prediction value from the trendline
trendline_start Value of the first trendline data point
trendline_strength Goodness of fit (R-squared) of the trendline
trendline_upr Trendline confidence interval values (upper)
vals Timeseries data values
[reference]  [top]


Timeseries Stats

Implemented with:

stats={"stats_key":{"stat":value}}

E.g.

stats={"forecast":{"predict_time":"now +30d"}

Stats Key Description
forecast Forecast related input options:

  • data_range: Timefilter for the historical data range used to calculate forecasts, the default being 6 months.
  • is_cumulative-[True, False]: Whether to use a cumulative forecasts. Can be applied to the following data formats:
    • forecast_predict
    • forecast_predict_peak
    • forecast_predict_offpeak
    • forecast_min
    • forecast_max
    • forecast_boundary_time
    • forecast_daily_change
  • max: Manually set upper boundary of feasible forecast value range. Can be applied to the following data formats:
    • forecast_predict
    • forecast_predict_peak
    • forecast_predict_offpeak
    • forecast_min
    • forecast_max
    • forecast_boundary_time
    • forecast_daily_slope
    • forecast_fit
    • forecast_vals
  • min: Manually set lower boundary of feasible forecast value range. Can be applied to the following data formats:
    • forecast_predict
    • forecast_predict_peak
    • forecast_predict_offpeak
    • forecast_min
    • forecast_max
    • forecast_boundary_time
    • forecast_daily_slope
    • forecast_fit
    • forecast_vals
  • predict_time: Time to use for the associated forecast data format. Can be applied to the following data formats:
    • forecast_predict
    • forecast_predict_peak
    • forecast_predict_offpeak
  • data_range: Timefilter for the historical data range used to calculate forecasts, default is last 180 days. Can be applied to the following data formats:
    • forecast_predict
    • forecast_predict_peak
    • forecast_predict_offpeak
    • forecast_min
    • forecast_max
    • forecast_boundary_time
    • forecast_daily_slope
    • forecast_fit
    • forecast_vals
percentile The value to use for the percentile format (between 0 and 100)
trendline Trendline related input options:

  • constrained=[True, False]: Whether to use a constrained trendline
  • is_cumulative-[True, False]: Whether to use a cumulative trendline
  • lwr_stddev: The number of standard deviations to use for the trendline_lwr format
  • upr_stddev: The number of standard deviations to use for the trendline_upr format
baseline Baseline related input options:

  • constrained=[True, False]: Whether to use a constrained trendline
  • data_range: Timefilter for the historical data range used to calculate baseline and anomaly metrics, default is last 180 days. Can be applied to the following data formats:
    • baseline_avg
    • baseline_compare
    • baseline_percent_compare
    • baseline
    • baseline_lwr
    • baseline_upr
    • anomaly_metric
    • anomaly_strength
  • is_cumulative-[True, False]: Whether to use a cumulative trendline
  • lwr_stddev: Baseline percentile to output for the baselineline_lwr format, default 2.5
  • percentile: Baseline percentile to output, defaults to 50. Can be applied to the following data formats:
    • baseline_avg
    • baseline_compare
    • baseline_percent_compare
    • baseline
  • predict_time: The time to use for the trendline_predict value
  • predict_time: The time to use for the trendline_predict value
  • upr_stddev: Baseline percentile to output for the baselineline_upr format, default 97.5
[reference]  [top]

Timeseries Field Options

Implemented with:{field}_option={value}

Timeseries Field Option Description
forecast.max Manually sets a maximum boundary for forecast data
forecast.min Manually sets a minimum boundary for forecast data
forecast.predict_range
  • A timefilter for forecast output arrays
  • Only the start and end of the timefilter range are used
forecast.predict_time A timefilter range value for forecast predictions
forecast.source_data_range
  • A timefilter for forecast input arrays
  • Only the start and end of the timefilter range are used
  • Defaults to 6 months
trendline.lwr_stddev Number of standard deviations from trendline to lower bound
Default = 3
trendline.predict_time A timefilter range value (e.g. ‘now + 5m’ or ‘end-of-today’) used by format trendline_predict for outputting the value of a trendline at trendline.predict_time
trendline.upper_stddev Number of standard deviations from trendline to upper bound
Default = 3
[reference]  [top]




Timeseries Aggregation Formats

Implemented with:{field}_aggregation_format={aggregation_format}

Note: using aggregation, the following rules apply:

  • When the aggregated data is a number – ignore all null values and return the aggregated value required based on non-null values only
  • When the aggregated data is NOT a number – attempt to convert all values to a number prior to aggregation. Any instance of null will result in the aggregated value being returned as null.
Format Description
95th The 95th percentile of the values
avg The average of the values
cat Concatenation of the values. Not supported for non-scalar formats such as vals
count The number of rows that match, and have a non-null value
count_all The number of rows that match, including NULL values
count_unique Number of unique non-null values in the group
count_unique_all Number of unique values in the group (including null values)
first The first matching value
last The last matching value
list Concatenate values as per the cat format, but return the output as comma separated list of values
list_unique Comma separated concatenation of the unique values in the group
max The maximum value
median The median value
min The minimum value
stddev The standard deviation value
sum The sum of all values
total Similar to sum, but returns 0 instead of NULL if there are only NULL values in the data being aggregated
[reference]  [top]

Event Formats

Statseeker event data metrics can have a statistical analysis applied to the raw data prior to being displayed in tables or graphs.

The availability formats (avl_{format} in the table below) require an additional parameter specifying the state/s in question. This additional parameter syntax is {field}_states={comma separated list of states}. For example:ifOperStatus_states=down,lowerLayerDown.

Format Description
avl_inPercent The percent of time the event has been in any of the requested states
avl_inTime The time the event has been in any of the requested states
avl_inTransitions The number of transitions from one of the requested states to a state not requested
avl_outPercent The percent of time the event has not been in any of the states
avl_outTime The time the event has not been in any of the requested states
avl_outTransitions The number of transitions from a state that wasn’t requested to a requested state
avl_totalTransitions The total number of transition between all of the states
poll Whether polling is enabled for the event

  • on : polling enabled
  • off : polling disabled
state The current state of the event
state_delta The number of seconds to the previous record
state_id The current state identifier of the event
state_inTime The number of seconds that the current state has been active
state_time The time of of the last transition


Example of using Event Formats:

Return the percentage of time that a device was “Up” in the previous month during business hours (Mon-Sat, 6am – 6pm), limit this to devices in the Routers group.

/api/v2.1/cdt_device?fields=name,ipaddress,ping_state&ping_state_formats=avl_inPercent&ping_state_states=up&ping_state_timefilter=range = start_of_last_month to end_of_last_month;time = 06:00 to 18:00;wday = Mon to Sat;&groups=Routers

  • fields=name,ipaddress,ping_state – fields to return
  • ping_state_formats=avl_inPercent – return the percentage of time that the device in the specified ping state
  • ping_state_states=up – the specified ping state is “up”
  • ping_state_timefilter=range = start_of_last_month to end_of_last_month; time = 06:00 to 18:00; wday = Mon to Sat; – the reporting period is Mon – Sat, 6am – 6pm, last month
  • groups=Routers – only return data on devices in the “Routers” group
Note: for readability purposes, the above example request string is not URL encoded. To encode the string for use, replace all spaces with %20.
[reference]  [top]