JBoss.orgCommunity Documentation
This section describes the "out of the box" additional services that are provided.
The "Call Trace" service is used to return a tree structure tracing the path of a business transaction (as a call/invocation stack) through a Service Oriented Architecture.
The URL for the service’s REST GET request is: <host>/overlord-rtgov/call/trace/instance?identifier=<value>
This service has the following query parameters:
Parameter | Description |
---|---|
identifier | This mandatory parameter uniquely identifies the activities associated with the business transaction. |
The "Service Dependency" service is used to return a service dependency graph as a SVG image. The graph represents the invocation and usage links between services (and their operations), and provides a color-coded indication of areas that require attention. Where situations have been detected against services or their operations, this will be flagged on the service dependency graph with an appropriate colour reflecting their severity.
The URL for the service’s REST GET request is: <host>/overlord-rtgov/service/dependency/overview?width=<value>
This service has the following query parameters:
Parameter | Description |
---|---|
width | Represents the optional image width. If the width is below a certain threshold, then a summary version of the dependency graph will be provided without text or tooltips (used to display metrics). |
The colors used for the graph nodes and links can be customized by editing a MVEL script.
The script is called ColorSelector.mvel
and is located within the /WEB-INF/classes
folder of the overlord-rtgov-services.war
archive. This file can be edited and updated within this war, and the war deployed to cause the changes to take affect.
An example of the contents of this script is:
String color="#00FF00"; double gap=metric.getMax()-metric.getMin(); if (gap > 0) { double mid=metric.getAverage()-metric.getMin(); double ratio=mid/gap; if (ratio > 0.95) { color = "#FF0000"; } else if (ratio > 0.9) { color = "#FF3300"; } else if (ratio > 0.85) { color = "#FF5930"; } else if (ratio > 0.8) { color = "#FF6A45"; } else if (ratio > 0.75) { color = "#FF9479"; } else if (ratio > 0.7) { color = "#FF9900"; } } return (color);
The script takes two variables:
Variable | Description |
---|---|
metric | The metric to be evaluated. |
component | The service definition component associated with the metric. This variable is not used within the example script above. |
The script is then responsible for returning the color code.