Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
135 lines (93 sloc) 4.12 KB
README file for the Application Heartbeats Project (Heartbeats)
Heartbeats official website:
The latest release of Heartbeats is always available in two
alternative formats from:
You can download the latest release of Heartbeats from:
There is a google group for discussion about the development of
Heartbeats at
Please read the NEWS file if you are upgrading from a previous release.
Please read the TODO file if you are interested in being informed on the
ongoing works. You can also find a list of issues at:
The contents of this README file are:
Project Description
Getting Started
Directory Organization
Documentation for Heartbeats
Environment Variables for Heartbeats
Testing Heartbeats
Team Members
Project Description
The Application Heartbeats framework provides a simple, standardized way for
applications to monitor their performance and make that information available
to external observers. The framework allows programmers to express their
applicationÕs goals and the progress that it is making using a simple API.
This progress can then be observed by either the application itself or an
external system (such as the OS or another application) so that the application
or system can be adapted to make sure the goals are met.
Getting Started
1. You can download the latest release of Heartbeats from:
2. Once you have downloaded your copy of the Heartbeats framework you just have to
unzip it:
tar -xzvf heartbeatsapi-VX.Y.tar.gz
3. At this point you are ready to start to use the Heartbeats framework. You can:
3.1 Take a look to the documentation (see "Documentation for Heartbeats")
3.2 Familiarize yourself with the Heartbeats API using our examples (see "Testing
3.3 Start to use the Application Heartbeats into your own applications
3.4 Get in touch with us and let us know your feedbacks, criticisms, suggestions
(send us an email or join our Heartbeats google group at:
Directory Organization
|-doc/ -- Documentation
|-html -- Documentation in HTML format
|-latex -- Documentation in latex format
|-src/ -- Source files
|-inc/ -- Header files
Documentation for Heartbeats
The documentation for the Heartbeats framework has been created with
Doxygen. You can find both an HTML and Latex version of the
documentation in the latest release of the Heartbeats framework. If,
for any reasons, you need to recreate the documentation by yourself,
you just have to use the following command (use it from the root
directory of the Heartbeats framework):
doxygen heartbeats_doc
Environment Variables for Heartbeats
In the Heartbeats framework, Heartbeat-enabled applications signal
their presence to the rest of the world by writing a file to a special
directory. Currently, this directory is specified by an environment
variable: HEARTBEAT_ENABLED_DIR. Before running the tests, users
should define this variable to point to a directory in which they have
read and write permissions.
Testing Heartbeats
The latest release of the Heartbeats framework comes with a set of
available tests that can be used to familiarize yourself with this
API. You can run one of our two examples, using the following command
(use it from the root directory of the Heartbeats framework):
make bench-tp
to use the throughput example, or
make bench-lat
to use the latency example
Team Members
Henry Hoffmann
Jonathan Eastep
Marco D. Santambrogio
Jason E. Miller
Anant Agarwal