---
name: "xymond_hostdata"
section: "8"
platform: "linux"
package: "xymon"
version: "4.3.30-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/xymond_hostdata"
---

# xymond\_hostdata(8)

xymond worker module for storing historical client data

## NAME

xymond\_hostdata - xymond worker module for storing historical client data

## SYNOPSIS

**xymond\_channel --channel=clichg xymond\_hostdata**

## DESCRIPTION

xymond\_hostdata is a worker module for xymond, and as such it is normally run via the *[xymond\_channel(8)](/xymond_channel/8.md)* program. Whenever a status column in Xymon changes to an alert state (usually red, yellow or purple), this module receives a copy of the latest Xymon client data sent by the host, and stores it on disk. This allows you to review all of the data collected by the Xymon client on the server around the time that a problem occurred. This can make troubleshooting incidents easier by providing a snapshot of the host status shortly before a problem became apparent.

Note: This module requires that *[xymond(8)](/xymond/8.md)* is launched with the "--store-clientlogs" option enabled.

## OPTIONS

- \--minimum-free=N

  Sets the minimum percentage of free filesystem space on the $CLIENTLOGS directory. If there is less than N% free space, xymond\_hostdata will not save the data. Default: 5

- \--debug

  Enable debugging output.

## FILES

All of the host data are stored in the $CLIENTLOGS directory, by default this is the $XYMONVAR/hostdata/ directory.

## SEE ALSO

[xymond(8)](/xymond/8.md), [xymond\_channel(8)](/xymond_channel/8.md), [xymon(7)](/xymon/7.md)
