This project is now deprecated, in favor of CNCF's Jaeger (was: Distributed Tracing and Application Performance Management)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.mvn
api [maven-release-plugin] prepare for next development iteration Mar 21, 2017
client
dist [maven-release-plugin] prepare for next development iteration Mar 21, 2017
examples [maven-release-plugin] prepare for next development iteration Mar 21, 2017
performance/server [maven-release-plugin] prepare for next development iteration Mar 21, 2017
server [maven-release-plugin] prepare for next development iteration Mar 21, 2017
tests [maven-release-plugin] prepare for next development iteration Mar 21, 2017
ui [maven-release-plugin] prepare for next development iteration Mar 21, 2017
.gitignore Ignoring target/ is anough to exclude jars, wars, ears and classes Nov 29, 2016
.travis.maven.settings.xml Update copyright in headers to 2017 Jan 4, 2017
.travis.swagger.sh Update copyright in headers to 2017 Jan 4, 2017
.travis.yml Add cache for bower libs and node_packages Feb 1, 2017
LICENSE Initial commit Apr 23, 2015
README.md Added deprecation notice to the readme Sep 27, 2017
mvnw Introduce mvnw - a way to ensure that devs and CI use the same Maven Nov 29, 2016
mvnw.cmd Introduce mvnw - a way to ensure that devs and CI use the same Maven Nov 29, 2016
pom.xml [maven-release-plugin] prepare for next development iteration Mar 21, 2017

README.md

Hawkular-APM

This project is now ARCHIVED and deprecated in favor of CNCF's Jaeger. See our announcement blog post for more details.

Travis Jira Issues Join the chat at freenode:hawkular

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 the OpenTracing standard API, optionally with the help of framework integrations and a non-intrusive Java Agent, that can be found in the OpenTracing contrib organization. It is also possible to use Hawkular APM as an alternative backend for Zipkin client libraries.

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.

Project documentation can be found here.

Build & Run

To build and run execute:

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

-> go to http://localhost:[8080|9411]/ and log in with admin: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 admin:password
  • -Pitest - 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

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:

Folder Description
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 APM installed.
examples This folder contains example applications.
server This folder contains the modules related to the server.
tests This folder contains the integration tests.
ui The angularjs based user interface.

Related Repositories

License

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

   Copyright 2015-2017 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.