Logging

HEAppE Middleware provides a logging mechanism that allows users to track the progress of their jobs and monitor the system’s performance. The logging system is designed to be flexible and can be configured to suit the needs of different users and applications.

The logging system is build on the top of the Log4Net library, which is a popular logging framework for .NET applications. Log4Net provides a wide range of features, including support for different logging levels, output formats, and destinations. The logging system can be configured to log messages to various outputs, such as console, file, or database.

HEAppE Middleware logs

HEAppE Middleware logs are stored in the /opt/heappe/projects/<project>/app/logs/ directory of the HEAppE installation.

The logs are organized into subdirectories based on the type of log. The following subdirectories are created by default:

  • API: Contains logs related to the HEAppE API.

  • DataStaging-API: Contains logs related to the Data Staging API.

  • RateLimit: Contains logs related to the rate limiting of API requests.

  • Vault: Contains logs related to the Vault service.

The logs are stored in files named with the date of the log entry. For example, the log file for April 9, 2025, would be named 2025_04_09.log.

Example of the log directory structure:

/opt/heappe/projects/<project>/app/logs/
├── API
│   └── 2025_04_09.log
├── DataStaging-API
│   └── 2025_04_09.log
├── RateLimit
│   └── 2025_04_09.log
└── Vault
    └── vault-agent.log