Hawkular-APM

is the Application Performance Management solution offering:

• Distributed Tracing (e.g. for microservices)

• Application Performance Management

• Business Transaction Management (currently only using JVM javaagent based approach)

Applications can be instrumented, using a non-intrusive Java agent approach for JVM based applications, or through Zipkin client libraries (for polyglot environment).

In other words Hawkular APM provides the capabilities to monitor the flow of invocations across servers, tiers, on-premises and in the cloud. It also enables detailed performance analysis to be performed of the individual components that make up an application.

Build & Run

To build and run execute:

$ mvn clean install -Pdev -DskipTests [-Ptests]
$ dist/target/hawkular-apm-${version}/bin/standalone.sh [-Djboss.http.port=9411]

-> go to http://localhost:[8080|9411]/ and log in with jdoe:password

The parameters to these commands are:

• -Djboss.http.port=9411 - bind APM port to Zipkin 9411 port. Default APM port is 8080.

• -Pdev - create user jdoe:password

• -Ptests - run integration tests

Add non-intrusive Java instrumentation to instrument your applications (doc):

$ source dist/target/hawkular-apm-${version}/apm/setenv.sh <APM server port>

-> restart your Java applications

Documentation

Project documentation can be found here.

REST API documentation can be generated using -Pdocgen profile.
The doc is generated under rest/target folder.

$ mvn clean install -Pdocgen

Project Structure

The project is divided into several areas:

api	This module contains the Java interfaces for services and processors, as well as the information model for exchanging business transaction information.
client	This folder contains the modules used to collector information from an execution environment.
dist	This module builds a distribution containing a pre-packaged Hawkular server with BTM installed.
processors	This folder contains the processor implementations that derive higher level information from the raw business transaction fragments reported by execution environments.
server	This folder contains the modules related to the server.
tests	This folder contains the integration tests.
tools	This folder contains the tools for working for APM.
ui	The angularjs based user interface.

License

Hawkular-APM is released under Apache License, Version 2.0 as described in the LICENSE document

   Copyright 2015-2016 Red Hat, Inc.

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.