5.1 Hosts and host groups

What is a "host"?

Typical Yoopl hosts are the assets you wish to monitor (servers, IoT, switches, etc).

Creating hosts is one of the first monitoring tasks in Yoopl. For example, if you want to monitor some parameters on a server “x”, you must first create a host called, say, “Server_X” and then you can look to add monitoring items to it.

Hosts are organized into host groups.

Proceed to creating and configuring a host

Configuration

The Host tab contains attributes:

Attributes description:

  • Code - enter a host code. Required. Alphanumerics and underscores are allowed. Min 4 Max 8

  • Name - enter a host name. Required. Alphanumerics, spaces, dots, dashes and underscores are allowed. Max 255

  • Address - enter a host address. Any characters are allowed .Max 255.

  • Freshness threshold - enter a host freshness threshold. Required. Integer value as seconds.

  • Number Of Transmitters - enter a host number Of transmitters. Required. Integer value.

  • Full name - enter a host full name.

  • Dashboard image - select a host dashboard image.

  • Map image - select a host map image

  • Host type - select host type. [regular, privated, templated] are allowed.

  • ContactId - unique ContactID code 4-numeric СССС – object number, first three digits is the unique code, the last digit is the transmitter's logical address

  • Notes - enter a host notes.

  • Maintenance - check if the host is serviced by a service organization

  • Send Sos - check if the host send Sos access v.3 to the local rescue unit

  • Рassport # - enter a host passport number.

  • Object Id - enter a host unique object number (unique transmitter number). See more Sos access.

  • Alarm type - select alarm type ”AL” = «Alarm» “RE” = reset . See more Sos access.

  • Event code - select event code. [1, 2, 3, 4] are allowed.

  • Event text - enter event code description. Max 255 symbols.

  • Alarm category - select alarm category. [FI, FP, ТЕ, NE, FA] are allowed.

    Alarm category values:
    «FI» - fire
    «FP» - fire protection
    «ТЕ» - technogenic emergency
    «ТН» - technogenic hazard
    «NE» - notification of emergency
    «FA» - fault',
  • Rescue - local rescue unit ID

  • Host group - select host group.

  • Initial state - select initial state for the host('UP', 'DOWN', or 'UNREACHABLE'). Default 'UP';

  • Checkcommand = select checkcommand. Used to specify the command that should be used to check if the host is up or down.

  • Host State Type - select the state type for the current host check ('HARD' or 'SOFT').

  • Check_interval - the number of "time units" between regularly scheduled checks of the host. Unless you've changed the interval_length directive from the default value of 60, this number will mean minutes. More information on this value can be found in the check scheduling documentation.

  • Retry interval - the number of "time units" to wait before scheduling a re-check of the hosts. Hosts are rescheduled at the retry interval when they have changed to a non-UP state.

Once the host has been retried max_check_attempts times without a change in its status, it will revert to being scheduled at its "normal" rate as defined by the check_interval value. Unless you've changed the interval_length directive from the default value of 60, this number will mean minutes.

More information on this value can be found in the check scheduling documentation.

Host variable

  • _hostState - a string indicating the current state of the host ('UP', 'DOWN', or 'UNREACHABLE'

  • _lastHostState - a string indicating the last state of the host ('UP', 'DOWN', or 'UNREACHABLE';

  • _hostDuration - a string indicating the amount of time that the host has spent in its current state

  • _hostDowntime - a number indicating the current 'downtime depth' for the host

  • _lastHostCheck - this is a timestamp indicating the time at which a check of the host was last performed

  • _lastHostStateChange - this is a timestamp indicating the time the host last changed state

  • _lastHostUp - this is a timestamp indicating the time at which the host was last detected as being in an UP state

  • _lastHostDown - this is a timestamp indicating the time at which the host was last detected as being in a DOWN state

  • _lastHostUnreachable - this is a timestamp indicating the time at which the host was last detected as being in an UNREACHABLE state