ヘッダーをスキップ
Oracle Composite Application Monitor and Modelerユーザーズ・ガイド
リリース10.2.0.5
B56252-01
  目次
目次

戻る
戻る
 
次へ
次へ
 

6 データのエクスポート

この章では、次のエクスポート機能について説明します。

6.1 データ・エクスポート・モード

CAMMで収集されたパフォーマンス・データを外部データベースやその他の永続的な形式にエクスポートするには3つのモードがあります。これらのモードを使用して、パフォーマンス・データをCAMMから抽出する最適な方法を柔軟に選択することができます。

6.1.1 ファイルへのエクスポート

このモードでは、生パフォーマンス・データがいくつかのCSV(カンマ区切り値)ファイルとしてエクスポートされます。

6.1.2 データベースへのエクスポート

このモードでは、生パフォーマンス・データがいくつかのANSI SQL文としてエクスポートされます。これらのSQL文を使用して、表を作成しデータを挿入できます。

6.1.3 ファイルへの集計エクスポート

このモードでは、毎日の集計操作を経た集計済パフォーマンス・データがいくつかのCSVファイルとしてエクスポートされます。

6.2 CAMMのエクスポート構成

次の項で、CAMMのエクスポート構成について説明します。

6.2.1 CAMMの定期的エクスポート構成

CAMMでは、リアルタイム・パフォーマンス・メトリックが内部データ・リポジトリ(MySQLデータベース)に格納されます。このデータを履歴データ・リポジトリに格納する場合は、パフォーマンス・データをエクスポートするための自動機能が提供されます。エクスポートの実行頻度、エクスポートの実行時間、エクスポート・データの時間範囲(1日以内)を管理できます。

例6-1 CAMMのエクスポート構成

# Setting for integrated export
AggregationManager.IntegratedExport = false
AggregationManager.ExportDataStartHour = 0
AggregationManager.ExportDataEndHour = 0
AggregationManager.ExportDataSetRangeInHour = 4
AggregationManager.ExportDataSetIntervalInHour = 1
AggregationManager.ExportDataSetDelay = 10000
AggregationManager.ExportStartTime = 0
AggregationManager.ExportEndTime = 0
AggregationManager.ExportFilePurgeTime = 10d

デフォルトでは、自動エクスポート機能は無効になっています。有効にするためにはAggregationManager.IntegratedExportパラメータをtrueに設定します。AggregationManager.ExportDataStartHourとAggregationManager.ExportDataEndHourという対のパラメータは、必要なエクスポート・パフォーマンス・データの1日のうちの時間範囲を指定します。デフォルトは24時間です。

パラメータAggregationManager.ExportDataSetRangeInHourは、各エクスポート・ファイルに格納するデータの量を示します。デフォルトは4時間分のデータです。つまり、4時間分のデータを含むエクスポート・データ・ファイルが複数作成されます。

通常のCAMMパフォーマンス・データ収集機能に対するエクスポート問合せの影響を最小限に抑えるために、時間のかかるデータ・エクスポート問合せは分散して実行します。これは、AggregationManager.ExportDataSetIntervalInHourパラメータの設定によって行います。デフォルトは1時間です。この場合、エクスポート問合せスレッドは1時間ごとに実行されます。

AggregationManager.ExportDataSetDelayでは、連続するエクスポート問合せの間の休止時間を定義します。デフォルトは10秒です。この場合、後続のエクスポート問合せは前の問合せの10秒以内には実行されません。

AggregationManager.ExportFilePurgeTimeは、エクスポート・データ・ファイルが削除されるまでの日数を指定します。デフォルトは10日です。現在のデフォルトは最適な値です。自動エクスポート機能を有効にする他は、このセクションを変更しないでください。

自動エクスポート機能は、$CAMM_HOME/config/export.xmlファイルを参照してエクスポートされるデータの定義を確認し、このファイルに定義されたルールに基づいてパフォーマンス・データをエクスポートします。

出力ディレクトリはexport.xmlで指定されます。このディレクトリの内容はエクスポートのたびに上書きされます。

6.2.2 メトリック・エクスポートの手動実行

CAMMマネージャのbinディレクトリには、runExportMetric.sh/batおよびrunExportEvent.sh/batというスクリプトがあります。それぞれ、メトリックとイベント(アラートなど)をCSVファイルにエクスポートします。

次のようにrunExportMetric.shを実行します。

./runExportMetric.sh <path to export.xml configuration> <start time> <end time>

例:

C:\oracle\em10g\bin>runExportMetric.bat c:\oracle\em10g\config\export.xml
 "4/1/09 16:06:00" "4/1/09 16:36:00"

開始時間と終了時間はマシンのローカル・タイムゾーンの時刻です。出力されるエクスポートcsvファイルのタイムスタンプはUTC/GMTになります。

6.2.3 export.xmlファイル

export.xmlファイルには、パフォーマンス・メトリックとイベントをエクスポートするために必要なすべてのディレクティブとフィルタが含まれます。このファイルは、CAMM統合自動エクスポート機能および手動エクスポート・スクリプトで使用されます。

例6-2 export.xmlファイルの内容

<?xml version="1.0" encoding="UTF-8"?>
<export xmlns="http://www.acsera.com/ns/export" verbose="true" exportMetric="true"
exportEvent="true" metricDataGrain="180s" exportFullMetric="true">
<!--
<output type="jdbc" convertTimeFormat="true"
arguments="access,metric,sun.jdbc.odbc.JdbcOdbcDriver,jdbc:odbc:acsera"/>
-->
<output type="file" convertTimeFormat="false"
arguments="/home/acsera/acsera/export,metric"/>
<entityTypes exportAllTypes="false">
<entityType name="BEA.ProcessNode"/>
<entityType name="J2EE.Dispatcher"/>
<entityType name="J2EE.JDBC.ConnectionPool"/>
<entityType name="J2EE.JVM"/>
</entityTypes>
<!--extra filter -->
<!--
<filters>
<filter key="containerID" values="cgServer"/>
</filters>
-->
<!-- don't modify this -->
<columns>
<column header="Timestamp" type="Timestamp"/>
<column header="EntityID" type="EntityID"/>
<column header="Application" type="Entity" key="applicationID" default=""/>
</columns>
</export>

次の表で様々な属性について説明します。

表6-1 <export>の属性

属性 説明

exportMetric

true/false(パフォーマンス・メトリックをエクスポートするかどうか)

exportEvent

true/false(SLOイベントをエクスポートするかどうか)

metricDataGrain

60s、180sまたは1800s(エクスポートするメトリック集計層)。60s層と比べて、180s層の移入は1.25時間、1800s層の移入は7時間遅れることに注意してください。

exportFullMetric

true/false(合計、カウント、最小および最大のメトリックを含めるかどうか)


表6-2 <output>の属性

属性 説明

type

file/jdbc(csvファイルに出力するか、JDBCを使用してデータを別のデータベースに書き込むか)。JDBC出力の場合、必要な表はエクスポート・メカニズムによって自動的に作成されます。

convertTimeFormat

true/false(メトリックのタイムスタンプを判読可能な形式(UTC/GMT)に変換するかどうか)。falseの場合、タイムスタンプはlong integerになります。カンマ区切りリストで引数(jdbc)を指定します。

arguments

詳細は、表6-3および表6-4を参照してください。


表6-3 type属性がJDBCの場合の<output>要素のarguments属性の値

属性 説明

第1パラメータ

データベース・タイプ(任意の文字列)

第2パラメータ

表の接頭辞(必ずメトリックを指定)

第3パラメータ

完全修飾JDBCドライバ・クラス

第4パラメータ

JDBC URL


表6-4 typeがfileの場合の<output>要素のarguments属性の値

引数 説明

第1パラメータ

CSVファイルの出力ディレクトリ(このディレクトリが作成されます。既存のファイルは上書きされます。)

第2パラメータ

表の接頭辞(必ずメトリックを指定)


表6-5 <entityTypes>要素の属性

属性 説明

exportAllTypes

true/false(すべてのエンティティ・タイプを出力するか、<entityType>要素に指定されたタイプのみを出力するか)。


表6-6 <entityType>要素の属性

属性 説明

name

exportAllTypesがfalseに設定された場合にエクスポートに含めるentityTypeの名前


6.3 WebLogicでのエクスポート・データの例

この項の表では、様々なエクスポート・ファイルのフィールドについて説明します。

表6-7 エクスポート・ファイル名: metricBEA_ChannelInstance.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

チャネルの完全修飾名

channelID

チャネルの完全修飾名

serviceID

サービスまたはJPDのURL

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

Metric.J2EE.ChannelInstance.MessageCount

JMXメトリック

Metric.J2EE.ChannelInstance.DeadMessageCount

JMXメトリック


表6-8 エクスポート・ファイル名: metricBEA_ProcessType.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

実装クラス名

processID

プロセスの表示名

serviceID

サービスまたはJPDのURL

projectID

WorkshopプロジェクトまたはWebアプリケーション・モジュールの名前

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

entityTypeID

監視対象エンティティのタイプ

applicationID

アプリケーションの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

deploymentID

Oracle WebLogicがアプリケーション・デプロイメントの管理に使用する一意のID

resourceID

ユーザーが構成した監視対象リソースの名前

displayNameID

表示名

controlContainerID

プロセスの実装クラス名

Metric.J2EE.ProcessType.Arrivals

インスツルメンテーション・メトリック: 受信数

Metric.J2EE.ProcessType.Aborts

インスツルメンテーション・メトリック: 中断数

Metric.J2EE.ProcessType.ElapsedTime

インスツルメンテーション・メトリック: 平均経過時間

Metric.J2EE.ProcessType.Active

インスツルメンテーション・メトリック: アクティブ・リクエスト数

Metric.J2EE.ProcessType.VisitCount

インスツルメンテーション・メトリック: 完了リクエスト数

Metric.J2EE.ProcessType.Exceptions

インスツルメンテーション・メトリック: 例外数


表6-9 エクスポート・ファイル名: metricBEA_TimerEventGenerator.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

チャネルの完全修飾名

channelID

チャネルの完全修飾名

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

channelTxID

チャネルの完全修飾名

domainID

Oracle WebLogic Serverドメインの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

Metric.J2EE.TimerEventGenerator.MessageCount

JMXメトリック

Metric.J2EE.TimerEventGenerator.ErrorCount

JMXメトリック


表6-10 エクスポート・ファイル名: metricJ2EE_Dispatcher.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

実行キューの完全修飾名

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

executeQueueID

ユーザーが構成した実行キューの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

Metric.J2EE.Dispatcher.ServicedRequestsTotalCount

JMXメトリック

Metric.J2EE.Dispatcher.IdleThreads

JMXメトリック

Metric.J2EE.Dispatcher.PendingRequests

JMXメトリック


表6-11 エクスポート・ファイル名: metricJ2EE_EJB_Entity.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

methodID

実行されるEJBメソッドの名前

domainID

Oracle WebLogic Serverドメインの名前

entityTypeID

監視対象エンティティのタイプ

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

ejbID

EJBの名前

webApplicationID

Webモジュールの名前

displayNameID

表示名

controlContainerTypeID

制御タイプの識別

elementID

実装クラス名

processID

プロセスの表示名

serviceID

サービスまたはJPDのURL

projectID

WorkshopプロジェクトまたはWebアプリケーション・モジュールの名前

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

ejbComponentID

このEJBを含むJ2EEコンポーネントの名前

applicationID

アプリケーションの名前

resourceID

ユーザーが構成した監視対象リソースの名前

controlContainerID

プロセスの実装クラス名

Metric.J2EE.EJB.Entity.Locking.LockManagerAccessCount

JMXメトリック

Metric.J2EE.EJB.Entity.ResponseTime

インスツルメンテーション・メトリック: レスポンス時間

Metric.J2EE.EJB.Entity.Cache.BeansCurrentCount

JMXメトリック

Metric.J2EE.EJB.Entity.Cache.AccessCount

JMXメトリック

Metric.J2EE.EJB.Entity.Pool.WaiterCurrentCount

JMXメトリック

Metric.J2EE.EJB.Entity.Transaction.CommittedTotalCount

JMXメトリック

Metric.J2EE.EJB.Entity.Locking.WaiterTotalCount

JMXメトリック

Metric.J2EE.EJB.Entity.Transaction.TimedOutTotalCount

JMXメトリック

Metric.J2EE.EJB.Entity.Cache.HitCount

JMXメトリック

Metric.J2EE.EJB.Entity.Locking.WaiterCurrentCount

JMXメトリック

Metric.J2EE.EJB.Entity.Pool.IdleCount

JMXメトリック

Metric.J2EE.EJB.Entity.Locking.EntriesCurrentCount

JMXメトリック

Metric.J2EE.EJB.Entity.VisitCount

インスツルメンテーション・メトリック: 呼出し数

Metric.J2EE.EJB.Entity.Locking.TimeoutTotalCount

JMXメトリック

Metric.J2EE.EJB.Entity.Pool.InUseCount

JMXメトリック

Metric.J2EE.EJB.Entity.Pool.WaiterTotalCount

JMXメトリック

Metric.J2EE.EJB.Entity.Pool.TimeoutTotalCount

JMXメトリック

Metric.J2EE.EJB.Entity.Transaction.RolledBackTotalCount

JMXメトリック

Metric.J2EE.EJB.Entity.Cache.ActivationCount

JMXメトリック

Metric.J2EE.EJB.Entity.Cache.PassivationCount

JMXメトリック


表6-12 エクスポート・ファイル名: metricJ2EE_EJB_Stateless.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

実装クラス名

projectID

WorkshopプロジェクトまたはWebアプリケーション・モジュールの名前

nodeID

物理マシンの名前

containerID

Oracle WebLogic Serverインスタンスの名前

domainID

Oracle WebLogic Serverドメインの名前

ejbComponentID

このEJBを含むJ2EEコンポーネントの名前

entityTypeID

監視対象エンティティのタイプ

applicationID

アプリケーションの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

ejbID

EJBの名前

resourceID

ユーザーが構成した監視対象リソースの名前

displayNameID

表示名

Metric.J2EE.EJB.Stateless.Transaction.TimedOutTotalCount

JMXメトリック

Metric.J2EE.EJB.Stateless.Pool.WaiterTotalCount

JMXメトリック

Metric.J2EE.EJB.Stateless.Pool.InUseCount

JMXメトリック

Metric.J2EE.EJB.Stateless.Transaction.CommittedTotalCount

JMXメトリック

Metric.J2EE.EJB.Stateless.Transaction.RolledBackTotalCount

JMXメトリック

Metric.J2EE.EJB.Stateless.Pool.IdleCount

JMXメトリック

Metric.J2EE.EJB.Stateless.Pool.TimeoutTotalCount

JMXメトリック


表6-13 エクスポート・ファイル名: metricJ2EE_JDBC_ConnectionPool.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

JDBC接続プールの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

Metric.J2EE.JDBC.ConnectionPool.WaitingForConnectionCurrentCount

JMXメトリック

Metric.J2EE.JDBC.ConnectionPool.WaitingForConnectionHighCount

JMXメトリック

Metric.J2EE.JDBC.ConnectionPool.ActiveConnectionsHighCount

JMXメトリック

Metric.J2EE.JDBC.ConnectionPool.ActiveConnectionsCurrentCount

JMXメトリック

Metric.J2EE.JDBC.ConnectionPool.FailuresToReconnectCount

JMXメトリック

Metric.J2EE.JDBC.ConnectionPool.WaitSecondsHighCount

JMXメトリック

Metric.J2EE.JDBC.ConnectionPool.ConnectionDelayTime

JMXメトリック


表6-14 エクスポート・ファイル名: metricJ2EE_JMS_Destination.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

JMS宛先の名前

nodeID

物理マシンの名前

containerID

Oracle WebLogic Serverインスタンスの名前

jmsServerRuntimeID

JMSサーバーの名前

domainID

Oracle WebLogic Serverドメインの名前

jmsDistributedQueueMemberID

JMS分散キュー・メンバーの名前

entityTypeID

監視対象エンティティのタイプ

jmsQueueID

JMSキューの名前

jmsRuntimeID

JMSサービスの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

jmsDistributedQueueID

JMS分散キューの名前

resourceID

ユーザーが構成した監視対象リソースの名前。

displayNameID

表示名

Metric.J2EE.JMS.Destination.ConsumersCurrentCount

JMXメトリック

Metric.J2EE.JMS.Destination.BytesCurrentCount

JMXメトリック

Metric.J2EE.JMS.Destination.MessagesPendingCount

JMXメトリック

Metric.J2EE.JMS.Destination.BytesThresholdTime

JMXメトリック

Metric.J2EE.JMS.Destination.MessagesHighCount

JMXメトリック

Metric.J2EE.JMS.Destination.BytesReceivedCount

JMXメトリック

Metric.J2EE.JMS.Destination.MessagesReceivedCount

JMXメトリック

Metric.J2EE.JMS.Destination.BytesHighCount

JMXメトリック

Metric.J2EE.JMS.Destination.MessagesCurrentCount

JMXメトリック

Metric.J2EE.JMS.Destination.ConsumersTotalCount

JMXメトリック

Metric.J2EE.JMS.Destination.ConsumersHighCount

JMXメトリック

Metric.J2EE.JMS.Destination.BytesPendingCount

JMXメトリック


表6-15 エクスポート・ファイル名: metricJ2EE_JMS_Service.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

JMSサービスの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

jmsRuntimeID

JMSサービスの名前

Metric.J2EE.JMS.Service.ConnectionsHighCount

JMXメトリック

Metric.J2EE.JMS.Service.ConnectionsCurrentCount

JMXメトリック

Metric.J2EE.JMS.Service.JMSServersCurrentCount

JMXメトリック

Metric.J2EE.JMS.Service.JMSServersHighCount

JMXメトリック

Metric.J2EE.JMS.Service.ConnectionsTotalCount

JMXメトリック

Metric.J2EE.JMS.Service.JMSServersTotalCount

JMXメトリック


表6-16 エクスポート・ファイル名: metricJ2EE_JVM.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

JVMの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

Metric.J2EE.JVM.JRockit.HeapSizeCurrent

JMXメトリック

Metric.J2EE.JVM.JRockit.HeapFreeCurrent

JMXメトリック

Metric.J2EE.JVM.JRockit.PhysMemTotal

JMXメトリック

Metric.J2EE.JVM.JRockit.PhysMemUsed

JMXメトリック

Metric.J2EE.JVM.JRockit.GarbageCollectionCountTotal

JMXメトリック

Metric.J2EE.JVM.JRockit.GarbageCollectionTimeTotal

JMXメトリック

Metric.J2EE.JVM.HeapFreeCurrent

JMXメトリック

Metric.J2EE.JVM.JRockit.PhysMemFree

JMXメトリック

Metric.J2EE.JVM.JRockit.NursurySizeTotal

JMXメトリック

Metric.J2EE.JVM.JRockit.ActiveDaemonThreads

JMXメトリック

Metric.J2EE.JVM.JRockit.ActiveThreads

JMXメトリック

Metric.J2EE.JVM.HeapSizeCurrent

JMXメトリック

Metric.J2EE.JVM.JRockit.HeapUsedCurrent

JMXメトリック


表6-17 エクスポート・ファイル名: metricJ2EE_Server.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

J2EEサーバー・インスタンスの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

containerID

J2EEサーバー・インスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

Metric.J2EE.Server.RestartsTotalCount

JMXメトリック


表6-18 エクスポート・ファイル名: metricJ2EE_Servlet.csv

フィールド 説明

StartTime

データ挿入の時刻(long)

EntityID

監視対象エンティティに対するCAMMの一意識別子

elementID

サーブレット実装クラスの名前

applicationID

アプリケーションの名前

infrastructureID

監視側インフラストラクチャのID。現時点で含まれる値はOracleのみです。

containerID

Oracle WebLogic Serverインスタンスの名前

nodeID

物理マシンの名前

domainID

Oracle WebLogic Serverドメインの名前

servletID

サーブレットの名前

webApplicationID

Webモジュールの名前

displayNameID

表示名

resourceID

ユーザーが構成した監視対象リソースの名前

entityTypeID

監視対象エンティティのタイプ

Metric.J2EE.Servlet.InvocationTotalCount

JMXメトリック

Metric.J2EE.Servlet.ExecutionTimeAverage

JMXメトリック