org.jboss.da:metrics

This project is a service, which provides information about built artifacts and analyse the projects' dependencies.

License	Apache License, Version 2.0
Categories	JBoss Container Application Servers Metrics Application Testing & Monitoring Monitoring
GroupId	org.jboss.da
ArtifactId	metrics
Last Version	1.7.0
Release Date	Aug 12, 2019
Type	ejb
Description	This project is a service, which provides information about built artifacts and analyse the projects' dependencies.

Download metrics

Filename	Size
metrics-1.7.0.pom
metrics-1.7.0.jar	5 KB
metrics-1.7.0-sources.jar	3 KB
metrics-1.7.0-javadoc.jar	35 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.jboss.da/metrics/ -->
<dependency>
    <groupId>org.jboss.da</groupId>
    <artifactId>metrics</artifactId>
    <version>1.7.0</version>
    <type>ejb</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.jboss.da/metrics/
implementation 'org.jboss.da:metrics:1.7.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.jboss.da/metrics/
implementation ("org.jboss.da:metrics:1.7.0")

Apache Buildr

'org.jboss.da:metrics:ejb:1.7.0'

Apache Ivy

<dependency org="org.jboss.da" name="metrics" rev="1.7.0">
  <artifact name="metrics" type="ejb" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.jboss.da', module='metrics', version='1.7.0')
)

Scala SBT

libraryDependencies += "org.jboss.da" % "metrics" % "1.7.0"

Leiningen

[org.jboss.da/metrics "1.7.0"]

Dependencies

compile (4)

Group / Artifact	Type	Version
org.jboss.spec.javax.ejb : jboss-ejb-api_3.2_spec	jar
io.dropwizard.metrics : metrics-core	jar	4.0.2
io.dropwizard.metrics : metrics-jvm	jar	4.0.2
io.dropwizard.metrics : metrics-graphite	jar	4.0.2

provided (1)

Group / Artifact	Type	Version
org.projectlombok : lombok	jar	1.18.2

Project Modules

There are no modules declared in this project.

Dependency-analysis

Dependency analyzer CLI

• You can found the CLI in cli-wrap/ folder
• Documentation for CLI can be found here: http://project-ncl.github.io/dependency-analysis/users-documentation.html

Build a project

• mvn clean package

Build a project and run integration tests in testsuite module

• mvn clean verify -DtestsuiteContainer=/path/to/EAP/dir
• You can exclude tests, which use remote services, using -PexcludeRemoteTests

Deploy/work with local jboss instance

• make sure your instance of EAP is running (/path/to/EAP/bin/standalone.sh)

• DEPLOY: mvn clean package wildfly:deploy

  • deploys 'application' module (application/target/dependency-analysis.ear)
  • deploys to standalone/data/content instead of standalone/deployments
  • default endpoints http://localhost:8080/da/ http://localhost:8080/da-bcg/
  • swagger provides a generated UI to test the endpoints http://localhost:8080/da/doc/doc http://localhost:8080/da-bcg/doc

• UNDEPLOY: mvn wildfly:undeploy

Working with JBoss Developer Studio (JBDS)

• Deploying through IDE via 'Run on Server' (e.g. JBDS) seems to corrupt expected endpoints, use maven command to deploy/undeploy

• Project DA uses lombok.jar to generate boilerplate getters/setters/constructors via annotations, download/install into your IDE as per https://projectlombok.org/download.html

• Workspace errors in .js, .xml, other files can be ignored as long as Maven build completes successfully from command line

Setup application

• Setup PostgreSQL database
• Datasource configuration and connection information in the standalone.xml datasource has to be named "PostgresDA"
• JDBC for PostgreSQL is needed. You have to add it to standalone.xml
• Add to the folder <EAP_HOME>/modules/system/layers/base/org/postgresql/main/ a file named module.xml and a file with the driver (download from here)
• The Dependency Analysis project uses a JSON configuration file for its configuration and is found in common/src/main/resources/da-config.json or it can be set using property da-config-file
• You can set values to cofigure Dependency Analyser
  • keycloak% - keycloak settings
  • pncServer - link to pnc server
  • aproxServer - link to Indy server
  • aproxGroup - Indy group

Run/debug integration tests in 'testsuite' through IDE (JBDS/Eclipse)

• Install Arquillian support:

  • Help -> Install New Software -> Work With -> http://download.jboss.org/jbosstools/updates/stable/luna/
  • Select 'Arquillian support' under 'JBoss Web and Java EE Development'
  • Create a run configuration for any test class/test method you want to run (right click - Run As - JUnit)
  • Open 'Arquillian' tab under the run configuration to set properties (jbossHome, managementPort)

• Run/Debug your run configuration

Metrics support

PNC tracks metrics of JVM and its internals via Dropwizard Metrics. The metrics can currently be reported to a Graphite server by specifying as system property or environment variables those properties:

• metrics_graphite_server (mandatory)
• metrics_graphite_port (mandatory)
• metrics_graphite_prefix (mandatory)
• metrics_graphite_interval (optional)

If the metrics_graphite_interval variable (interval specified in seconds) is not specified, we'll use the default value of 60 seconds to report data to Graphite.

The graphite reporter is configured to report rates per second and durations in terms of milliseconds.

Versions

Version
1.7.0 Aug 12, 2019
1.5.0 Apr 10, 2019
1.4.1 Nov 21, 2018
1.4.0 Oct 23, 2018
1.3.2 Aug 9, 2018
1.3.1 Jul 30, 2018
1.3.0 Jun 26, 2018