To configure Heartbeat define a set of
monitors to check your remote hosts.
Specify monitors either directly inside the
heartbeat.yml config file, or in external
dynamically loaded files located in the directory referenced by
One advantage of using external files is that these can be automatically reloaded
without stopping the Heartbeat process.
monitor item is an entry in a yaml list, and so begins with a dash (-).
You can define the type of monitor to use, the hosts to check, and other
optional settings that control Heartbeat behavior.
The following example configures three monitors checking via the
protocols directly inside the
heartbeat.yml file, and demonstrates how to use TCP Echo
and HTTP response verification:
# heartbeat.yml heartbeat.monitors: - type: icmp id: ping-myhost name: My Host Ping hosts: ["myhost"] schedule: '*/5 * * * * * *' - type: tcp id: myhost-tcp-echo name: My Host TCP Echo hosts: ["myhost:777"] # default TCP Echo Protocol check.send: "Check" check.receive: "Check" schedule: '@every 5s' - type: http id: service-status name: Service Status service.name: my-apm-service-name hosts: ["http://localhost:80/service/status"] check.response.status:  schedule: '@every 5s' heartbeat.scheduler: limit: 10
heartbeat.yml configuration file is convenient, but has two drawbacks:
it can become hard to manage with large numbers of monitors, and it will not reload
heartbeat automatically when its contents changes.
Define monitors via the
heartbeat.config.monitors to prevent those issues from
happening to you. To do so you would instead have your
heartbeat.yml file contain the following:
# heartbeat.yml heartbeat.config.monitors: # Directory + glob pattern to search for configuration files path: /path/to/my/monitors.d/*.yml # If enabled, heartbeat will periodically check the config.monitors path for changes reload.enabled: true # How often to check for changes reload.period: 1s
Then, define one or more files in the directory pointed to by
You may specify multiple monitors in a given file if you like. The contents of these files is
monitor definitions only, e.g. what is normally under the
heartbeat.monitors section of
heartbeat.yml. See below for an example
# /path/to/my/monitors.d/localhost_service_check.yml - type: http id: service-status name: Service Status hosts: ["http://localhost:80/service/status"] check.response.status:  schedule: '@every 5s'
You can configure Heartbeat to use the following monitor types:
- Uses an ICMP (v4 and v6) Echo Request to ping the configured hosts. Requires special permissions or root access.
- Connects via TCP and optionally verifies the endpoint by sending and/or receiving a custom payload.
Connects via HTTP and optionally verifies that the host returns the
expected response. Will use
Elastic-Heartbeatas the user agent product.
http monitor types both support SSL/TLS and some proxy