Fuse ESB Enterprise Apache Camel Monitoring Plugin

Transcription

1 Fuse ESB Enterprise Apache Camel Monitoring Plugin Version 7.1 December 2012 Integration Everywhere

2

3 Apache Camel Monitoring Plugin Version 7.1 Updated: 08 Jan 2014 Copyright 2012 Red Hat, Inc. and/or its affiliates. Trademark Disclaimer These materials and all Progress software products are copyrighted and all rights are reserved by Progress Software Corporation. The information in these materials is subject to change without notice, and Progress Software Corporation assumes no responsibility for any errors that may appear therein. The references in these materials to specific platforms supported are subject to change. Fuse, FuseSource, Fuse ESB, Fuse ESB Enterprise, Fuse MQ Enterprise, Fuse Mediation Router, Fuse Message Broker, Fuse Services Framework, Fuse IDE, Fuse HQ, Fuse Management Console, and Integration Everywhere are trademarks or registered trademarks of FuseSource Corp. or its parent corporation, Progress Software Corporation, or one of their subsidiaries or affiliates in the United States. Apache, ServiceMix, Camel, CXF, and ActiveMQ are trademarks of Apache Software Foundation. Any other names contained herein may be trademarks of their respective owners.

4

5 Table of Contents 1. Apache Camel Managed Resources Camel Context Service Camel Component Service Camel Endpoint Service Camel Route Service Camel Processor Service

6 List of Tables 1.1. Availability Indicators

7 Chapter 1. Apache Camel Managed Resources Overview Apache Camel metrics are collected for routes that are deployed in Red Hat JBoss Fuse. Based on a resource's metrics, you can invoke Control Operations on the resource to avoid or correct throughput and performance problems. Agent Metric Collectors The main service entries, which collect the required metrics, are: Camel Context Camel Component Camel Endpoint Camel Route Camel Processor Note By default, Availability status is collected on all Camel services. Only the Camel Route and Camel Processor services collect additional metrics. Availability Status This metric is of category Availability and of type Dynamic. It indicates the availability status of a resource during a given time slice. Table 1.1. Availability Indicators Icon State Available (Up) Down Resource is running and responding to availability checks. Resource is not responding to availability checks. 7

8 Chapter 1. Apache Camel Managed Resources Icon State Unknown Disabled Mixed (resource groups only) The agent has no record of the resource's state. This could be due to the resource having been newly added to inventory, so has not yet been checked for availability. Or it could be that the agent is down. The resource has been administratively marked as unavailable. In reality, the resource could be running or stopped. When a resource is disabled, the server ignores availability reports from the agent to prevent unnecessary alerts triggered by known down (or cycling) states. Members in a resource group have different availability states. 8

9 Chapter 2. Camel Context Service Overview : Singleton: Plugin: Camel Context no Camel Child Resource Types???????????????? Connection Properties Note You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions. Required Internal Camel Id The name of the Camel component yes Component Camel Version The Camel version yes CamelVersion Context The name of the Camel Context yes context Metrics Configuration Properties Operations You can invoke control operations to avoid or correct throughput and performance problems. 9

10 Chapter 2. Camel Context Service start stop suspend resume The start operation starts up the selected camel context. The stop operation stops the selected camel context immediately. The suspend operation pauses the routing of messages and preserves the state of the route, after the completion of all inflight exchanges. The resume operation resumes the processing of messages after a call to suspend. Package Types 10

11 Chapter 3. Camel Component Service Overview : Singleton: Plugin: Camel Component no Camel Parent Resource Types???? Child Resource Types Connection Properties Note You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions. Required Internal Component The name of the Camel component yes Component Metrics Configuration Properties Operations Package Types 11

12 12

13 Chapter 4. Camel Endpoint Service Overview : Singleton: Plugin: Camel Endpoint no Camel Parent Resource Type???? Child Resource Types Connection Properties Note You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions. Required Internal Endpoint Uri The uri of the Camel consumer endpoint yes EndpointUri Metrics Configuration Properties Operations Package Types 13

14 14

15 Chapter 5. Camel Route Service Overview : Singleton: Plugin: Camel Route no Camel Parent Resource Types???? Child Resource Types Connection Properties Note You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions. Route Id Endpoint Uri The name of the Camel route The uri of the consumer endpoint in the Camel route Required yes yes Internal RouteId EndpointUri Metrics Note You must use the internal name to reference Traits in Dynamic Group Definition expressions. Type Internal Exchanges Completed Indicates the total number of exchanges the route has processed successfully since route start-up or the last reset operation. ExchangesCompleted 15

16 Chapter 5. Camel Route Service Exchanges Completed Per Minute Type Internal Indicates the total number ExchangesCompleted of exchanges the route has processed successfully per minute since route start-up or the last reset operation. Exchanges Failed Indicates the total number of exchanges that the route has failed to process since route start-up or the last reset operation. ExchangesFailed Exchanges Failed Per Minute Exchanges Total Exchanges Total Per Minute Indicates the total number ExchangesFailed of exchanges that the route has failed to process per minute since route start-up or the last reset operation. Indicates the total number of exchanges, passed or failed, that the route has processed since route start-up or the last reset operation. ExchangesTotal Indicates the total number ExchangesTotal of exchanges, passed or failed, that the route has processed per minute since route start-up or the last reset operation. Inflight Exchanges Indicates the number of exchanges currently transiting the route. InflightExchanges Inflight Exchanges Per Minute Indicates the number of exchanges currently transiting the route per minute. InflightExchanges Min Processing Time Indicates the shortest time, in milliseconds, to process an exchange since route MinProcessingTime 16

17 Mean Processing Time Max Processing Time Total ProcessingTime Type start-up or the last reset operation. Internal Indicates the average MeanProcessingTime processing time, in milliseconds, for all exchanges processed since route start-up or the last reset operation. Indicates the longest time, in milliseconds, to process an exchange since route start-up or the last reset operation. MaxProcessingTime Indicates the total TotalProcessingTime processing time, in milliseconds, of all exchanges processed since route start-up or the last reset operation. Last Processing Time Indicates the time, in milliseconds, it took the route to process the last exchange. LastProcessingTime Note All Exchanges* metrics are of type Trends Up and category Throughput. Because Trends Up metrics continuously increase, the rate of change becomes more important to track than the total number of exchanges, so JBoss ON automatically calculates and creates a secondary Per Minute metric for each Exchanges* 17

18 Chapter 5. Camel Route Service metric. By default, the Per Minute metrics, rather than their counterparts, are enabled and charted. Configuration Properties Operations reset shutdown start stop You can invoke control operations to avoid or correct throughput and performance problems. The reset operation immediately clears all counters, thus all statistics, for the specified route. The shutdown operation immediately stops and shuts down the selected route, pending the completion of all inflight exchanges. The start operation starts up the selected route, including all of its processors and services. The stop operation immediately stops the selected route, pending the completion of all pending inflight exchanges. Package Types 18

19 Chapter 6. Camel Processor Service Overview : Singleton: Plugin: Camel Processor no Camel Parent Resource Types???? Child Resource Types Connection Properties Note You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions. Required Internal Route Id The name of the Camel route yes RouteId Processor Id The name of the processor in the Camel Route yes ProcessorId Metrics Note Exchanges Completed Type You must use the internal name to reference Traits in Dynamic Group Definition expressions. Internal Indicates the total number ExchangesCompleted of exchanges the selected processor has processed successfully since processor 19

20 Chapter 6. Camel Processor Service Exchanges Completed Per Minute Type start-up or the last reset operation. Indicates the total number of exchanges the selected processor has processed successfully per minute since processor start-up or the last reset operation. Internal ExchangesCompleted Exchanges Failed Indicates the total number of exchanges that the selected processor has failed to process since processor start-up or the last reset operation. ExchangesFailed Exchanges Failed Per Minute Indicates the total number ExchangesFailed of exchanges that the selected processor has failed to process per minute since processor start-up or the last reset operation. Exchanges Total Indicates the total number of exchanges, passed or failed, that the selected processor has processed since route start-up or the last reset operation. ExchangesTotal Exchanges Total Per Minute Indicates the total number ExchangesTotal of exchanges, passed or failed, that the selected processor has processed per minute since route start-up or the last reset operation. Min Processing Time Indicates the shortest time, in milliseconds, to process an exchange since processor start-up or the last reset operation. MinProcessingTime 20

21 Mean Processing Time Max Processing Time Total Processing Time Type Internal Indicates the average MeanProcessingTime processing time, in milliseconds, for all exchanges processed since processor start-up or the last reset operation. Indicates the longest time, MaxProcessingTime in milliseconds, to process an exchange since processor start-up or the last reset operation. Indicates the total TotalProcessingTime processing time, in milliseconds, of all exchanges processed since processor start-up or the last reset operation. Last Processing Time Indicates the time, in milliseconds, it took the selected processor to process the last exchange. LastProcessingTime Configuration Properties Operations reset start You can invoke control operations to avoid or correct throughput and performance problems. The reset operation immediately clears all counters, thus all statistics, for the specified processor. The start operation starts up the selected processor and all of its services. 21

22 Chapter 6. Camel Processor Service stop The stop operation immediately stops the selected processor. Package Types 22