dtc:monitor:icmp : DTC ICMP monitor object.

The DTC ICMP monitor object is used to determine the health of a server by monitoring the response to an ICMP ping.

Object Reference

References to dtc:monitor:icmp are object references. The name part of a DTC ICMP monitor object reference has the following components:

  • Name of DTC ICMP monitor

Example: dtc:monitor:icmp/ZG5zLm5ldHdvcmtfdmlldyQxMTk:DTCIcmp1

Restrictions

The object does not support the following operations:

  • CSV export

The object cannot be managed on Cloud Platform members.

Fields

These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.

The basic version of the object contains the field(s): comment, name.

The following fields are required to create this object:

Field Notes
name  

comment

comment

Comment for this DTC monitor; maximum 256 characters.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The default value is empty.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

Notes

The comment is part of the base object.

extattrs

extattrs

Extensible attributes associated with the object.

For valid values for extensible attributes, see the following information.

Type

Extensible attributes.

This field allows +/- to be specified as part of the field name when updating the object, see the following information.

Create

The default value is empty.

Search

For how to search extensible attributes, see the following information.

interval

interval

The interval for TCP health check.

Type

Unsigned integer.

Create

The default value is 5.

Search

The field is not available for search.

name

name

The display name for this DTC monitor.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The field is required on creation.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

Notes

The name is part of the base object.

retry_down

retry_down

The value of how many times the server should appear as down to be treated as dead after it was alive.

Type

Unsigned integer.

Create

The default value is 1.

Search

The field is not available for search.

retry_up

retry_up

The value of how many times the server should appear as up to be treated as alive after it was dead.

Type

Unsigned integer.

Create

The default value is 1.

Search

The field is not available for search.

timeout

timeout

The timeout for TCP health check in seconds.

Type

Unsigned integer.

Create

The default value is 15.

Search

The field is not available for search.

Fields List

Field Type Req R/O Base Search
comment String N N Y : = ~
extattrs Extattr N N N ext
interval Unsigned int N N N N/A
name String Y N Y : = ~
retry_down Unsigned int N N N N/A
retry_up Unsigned int N N N N/A
timeout Unsigned int N N N N/A