Skip to content

aspectran/aspectow-appmon

Repository files navigation

Aspectow AppMon

Build Status Maven Central Version javadoc License

Aspectow AppMon is a powerful monitoring tool that provides an integrated, real-time view of logs, events, and metrics for your Aspectran-based application servers. It helps you observe and analyze the behavior of your applications, making it easier to debug issues, optimize performance, and ensure stability.

petclinic-screenshot

Features

  • Real-time Monitoring: Observe logs, application events, and performance metrics as they happen.
  • Agent-Based Collection: A lightweight agent collects data from your Aspectran application without significant overhead.
  • Live Data Streaming: Supports WebSockets and long-polling for streaming live data to the monitoring dashboard.
  • Data Persistence: Persists event and metric data for historical analysis and reporting.
  • Activity Charting: Visualize application activity with real-time charts.
  • Extensible Exporters: Easily extend the system to export data to other monitoring systems or databases.

Requirements

  • Java 21 or later
  • Maven 3.9.4 or later (the included Maven wrapper is recommended)

Building from Source

To build Aspectow AppMon from the source code, follow these steps:

  1. Clone the repository:

    git clone https://github.com/aspectran/aspectow-appmon.git
  2. Navigate to the project directory:

    cd aspectow-appmon
  3. Build the project: Use the provided build script to compile the code and package the application. The rebuild command cleans the project before building.

    ./build rebuild

Running the Demo

After a successful build, you can run the included demo application to see Aspectow AppMon in action.

  1. Start the demo server:

    ./build demo
  2. Access the dashboard: Open your web browser and navigate to http://localhost:8082.

The demo will showcase the real-time monitoring dashboard with sample data.

Contributing

Contributions are welcome! If you would like to contribute, please feel free to fork the repository and submit a pull request. For major changes, please open an issue first to discuss what you would like to change.

License

Aspectow AppMon is licensed under the Apache License 2.0.