[Documentation] [TitleIndex] [WordIndex

Only released in EOL distros:  

Package Summary

The ARNI processing node, which rates statistics against their specifications.

  • Maintainer status: maintained
  • Maintainer: Matthias Hadlich <matthiashadlich AT yahoo DOT de>, Andreas Bihlmaier <andreas.bihlmaier AT gmx DOT de>
  • Author: Micha Wetzel <micha.wetzel AT student.kit DOT edu>, Alex Weber <alex.weber3 AT gmx DOT net>, Matthias Klatte <matthias.klatte AT go4more DOT de>, Sebastian Kneipp <sebastian.kneipp AT gmx DOT net>, Matthias Hadlich <matthiashadlich AT yahoo DOT de>
  • License: BSD

Introduction

The monitoring node retrieves data on the topics /statistics, /statistics_node and /statistics_host. It then rates them according to specifications stored in the parameter namespace /arni/specifications. The resulting data are published on the topic /statistics_rated.

Used Parameters

For parameters shared across the arni packages see this list.

Parameter

Default value

Description

arni_processing provides a storage with rated data for the GUI widgets.

~storage/timeout

300(s)

The time in seconds since when data is considered old and will be removed.

~storage/auto_cleanup

True

Enable or disable the automatic cleanup.

~storage/cleanup_timer

30(s)

The time in s giving the interval of automatic cleanup.

Statistics about topics are generated from the /statistics topic and aggregated over time.

~aggregation_window

3(s)

The duration of time over which the processing node aggregates messages on a topic.

Connections are tested if they still send data

~alive_interval

5(s)

Interval to check all registered connections.

~alive_timer

10(s)

Default timer afther when a connections is regarded as "dead".

All references for rating the incoming statistics are stored as specifications in a list on the parameterserver.

/arni/specifications

[]

See the Specification format below.

Additionaly some commands can be send as service calls:

Service

Content

Effect

/monitoring_node/reload_specifications

std_srvs.srv.Empty

Reloads all specifications from the namespace /arni/specifications (see Parameters)

Specifications

The processing node rates the incoming statistics based on given specifications. They are read from the namespace /arni/specifications. There you might give your desired specifications for a given seuid according to this format:

- n!example_node: # a seuid
    measurement1: [minvalue, maxvalue]
    # or
    measurement2: [value, deviation, "relative"]

You can pack these specifications as list items in one single list, which will then overwrite the whole list when you load several lists or add one more namespace block with the list like /arni/specifications/logical_unit1 = [], /arni/specifications/logical_unit2 = []. The latter method allows you to selectively unset specification blocks. Learn more about the seuid. Note that the measurement fields can be basically every field in the respective messagetypes. See theses for comments on units.

Additionally the field alive_timer determines when the specified item is regarded as "dead" (see above). Note that this field expects a single number unlike the other fields!

For reference all fields are listed below.

Limit format

Usually the limits for a measurement are given as list with minimum and maximum value. If a third parameter is set as "relative", the limits will be calculated as minvalue = value * (1 - deviation) etc.

Note: If a measured value returns an array (for example bandwidth_max for multiple network adapters) you can give an array of such limits. If you receive more values than you defined limits, spare values will be rated as unknown. If you don't give an array of limits, the given limit will be used for each value.

Specification Fields

Hosts

cpu_temp_mean (float32)
cpu_temp_stddev (float32)
cpu_temp_max (float32)

cpu_usage_mean (float32)
cpu_usage_stddev (float32)
cpu_usage_max (float32)

cpu_usage_core_mean (float32[])
cpu_usage_core_stddev (float32[])
cpu_usage_core_max (float32[])

cpu_temp_core_mean (float32[])
cpu_temp_core_stddev (float32[])
cpu_temp_core_max (float32[])

gpu_temp_mean (float32[])
gpu_temp_stddev (float32[])
gpu_temp_max (float32[])

gpu_usage_mean (float32[])
gpu_usage_stddev (float32[])
gpu_usage_max (float32[])

ram_usage_mean (float32)
ram_usage_stddev (float32)
ram_usage_max (float32)

message_frequency_mean (int32[])
message_frequency_stddev (int32[])
message_frequency_max (int32[])

bandwidth_mean (float32[])
bandwidth_stddev (float32[])
bandwidth_max (float32[])

Nodes

node_cpu_usage_mean (float32)
node_cpu_usage_stddev (float32)
node_cpu_usage_max (float32)

node_cpu_usage_core_mean (float32[])
node_cpu_usage_core_stddev (float32[])
node_cpu_usage_core_max (float32[])

node_gpu_usage_mean (float32[])
node_gpu_usage_stddev (float32[])
node_gpu_usage_max (float32[])

node_ramusage_mean (float32)
node_ramusage_stddev (float32)
node_ramusage_max (float32)
 
node_message_frequency_mean (float32)
node_message_frequency_stddev (float32)
node_message_frequency_max (float32)

node_bandwidth_mean (float32)
node_bandwidth_stddev (float32)
node_bandwidth_max (float32)

node_write_mean (float32)
node_write_stddev (float32)
node_write_max (float32)

node_read_mean (float32)
node_read_stddev (float32)
node_read_max  (float32)

Connections

Connections use the built-in Statistics messagetype.

delivered_msgs (int32)
dropped_msgs (int32)
traffic (int32)
bandwidth (int32) # normalized traffic
period_mean (duration)
period_stddev (duration)
period_max (duration)
stamp_age_mean (duration)
stamp_age_stddev (duration)
stamp_age_max (duration)

Topics

Topics use a subset of these fields:

delivered_msgs (int32)
dropped_msgs (int32)
packages (int32) # number of packages included in the aggregation
packages_per_second (float32) # packages normalized over their timespan
traffic (int32)
bandwidth (float32) # normalized traffic
frequency (float32)
stamp_age_mean (duration)
stamp_age_stddev (duration)
stamp_age_max (duration)


2020-08-08 12:27