209.12. MetricsMessageHistoryFactory

Camel 2.17 から利用可能

このファクトリーでは、メッセージのルーティング中にメトリクスを使用して Message History パフォーマンス統計を取得できます。これは、すべてのルートの各ノードにメトリクス Timer を使用して機能します。このファクトリーは、以下の例のように Java および XML で使用できます。

Java では、以下のようにファクトリーを CamelContext に設定します。

context.setMessageHistoryFactory(new MetricsMessageHistoryFactory());

XML DSL の場合、以下のように <bean> を定義します。

  <!-- use camel-metrics message history to gather metrics for all messages being routed -->
  <bean id="metricsMessageHistoryFactory" class="org.apache.camel.component.metrics.messagehistory.MetricsMessageHistoryFactory"/>

ファクトリーでは以下のオプションがサポートされます。

Expand

Name	デフォルト	説明
useJmx	false	`com.codahale.metrics.JmxReporter` を使用して詳細な統計を JMX に報告するかどうか。 CamelContext で JMX が有効になっている場合、JMX ツリーのサービスタイプの下に `MetricsRegistryService` mbean が登録されていることに注意してください。この mbean には、統計を JSON 出力する 1 つのオペレーションがあります。`useJmx` を true に設定する必要があるのは、統計タイプごとに詳細な mbeans が必要な場合のみです。
jmxDomain	org.apache.camel.metrics	JMX ドメイン名
prettyPrint	false	統計を json 形式で出力する際に Pretty print を使用するかどうか。
metricsRegistry		共有 `com.codahale.metrics.MetricRegistry` の使用を許可します。指定しない場合は、Camel はこの CamelContext によって使用される共有インスタンスを作成します。
rateUnit	TimeUnit.SECONDS	メトリクスレポーターまたは統計を json 出力するときのレートに使用する単位。
durationUnit	TimeUnit.MILLISECONDS	メトリクスレポーターまたは統計を json 出力するときの期間に使用する単位。
namePattern	`name.routeId.id.type`	使用する名前パターン。区切り文字としてドットを使用しますが、変更できます。値 `名`、`routeId`、`type`、および `id` は実際の値に置き換えられます。`name` は、CamelContext の名前です。`routeId` はルートの名前です。`id` パターンはノード ID を表します。and `type` は履歴の値です。

実行時にメトリクスには Java API または JMX からアクセスでき、データを json 出力として収集できます。

Java コードから、以下のように CamelContext からサービスを取得できます。

MetricsMessageHistoryService service = context.hasService(MetricsMessageHistoryService.class);
String json = service.dumpStatisticsAsJson();

また、JMX API では、Bean は name=MetricsMessageHistoryService の type=services ツリーに登録されます。

209.12. MetricsMessageHistoryFactory

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links