fork of heartbeats 1.2
C Shell Python
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 19 commits behind camillol:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
prove da fare


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