GETMETRICDATA  
説明

サーバーのパフォーマンスの測定値を取得します。

 
戻り値

mode 値に基づいた測定値を含む ColdFusion 構造体

 
カテゴリ

システム関数

 
関数のシンタックス
GetMetricData(mode)
 
ヒストリ

ColdFusion MX: cachepops パラメータが使用禁止になりました。今後のリリースでは動作せず、エラーが発生する可能性があります。

 
パラメータ

 
使用方法

mode = "perf_monitor" の場合、この関数は次のデータフィールドを持つ構造体を返します。

   
InstanceName
ColdFusion サーバー名です。デフォルト値は cfserver です。
PageHits
ColdFusion MX が起動してから受け取った HTTP リクエストの数です。
ReqQueued
ステージングキュー内で処理待ちの HTTP リクエストの数です。
DBHits
サーバーが起動してからのデータベースリクエストの数です。
ReqRunning
現在実行中の HTTP リクエストの数です。
ColdFusion Administrator で、同時に実行するリクエストの最大数を設定できます。
ReqTimedOut
ステージングキューにあるときまたは実行中に、タイムアウトになった HTTP リクエストの数 です。
BytesIn
ColdFusion MX への HTTP リクエストのバイト数です。
BytesOut
ColdFusion MX からの HTTP レスポンスのバイト数です。
AvgQueueTime
最後の 2 つの HTTP リクエスト (現在およびその前のリクエスト) の、ステージングキューでの 平均待ち時間です。
AvgReqTime
最後の 2 つの HTTP リクエスト (現在およびその前のリクエスト) について、サーバーでのその リクエストの処理にかかった平均時間です。
AvgDBTime
最後の 2 つの HTTP リクエスト (現在および前のリクエスト) について、サーバーでのそのリク エスト内の CFQueries の処理にかかった平均時間です。
cachepops
このパラメータは使用禁止となりました。ColdFusion はこの値を自動的に -1 に設定します。

 
<!--- この例では、Windows NT の PerfMonitor から測定データを取り込んで表示しています。 --->
<cfset pmData = GetMetricData( "PERF_MONITOR" ) >
<cfoutput>
   現在の PerfMonitor データ:<p>
   InstanceName:   #pmData.InstanceName# <p>
   PageHits:      #pmData.PageHits# <p>
   ReqQueued:       #pmData.ReqQueued# <p>
   DBHits:    #pmData.DBHits# <p>
   ReqRunning:       #pmData.ReqRunning# <p>
   ReqTimedOut:#pmData.ReqTimedOut# <p>
   BytesIn:       #pmData.BytesIn# <p>
   BytesOut:       #pmData.BytesOut# <p>
   AvgQueueTime:#pmData.AvgQueueTime# <p>
   AvgReqTime       #pmData.AvgReqTime# <p>
   AvgDBTime:       #pmData.AvgDBTime# <p>
</cfoutput>
MODE  
perf_monitor
内部データを構造体で返します。
データを受け取るには、この関数を実行する前に、ColdFusion Administrator の パフォーマンスモニターを有効にしておく必要があります。
Windows の場合、ColdFusion Administrator のパフォーマンスモニターを有効 にしていなければ、このデータは Windows の PerfMonitor に表示されます。
  simple_load サーバーの内部キューのステートから計算された整数値を返します。サーバーの 全体的な負荷を示します。   prev_req_time サーバーが前のリクエスト処理に要した時間をミリ秒単位で返します。   avg_req_time サーバーがリクエスト処理に要した平均時間をミリ秒単位で返します。 この設定を 0 に変更すると、サーバーで平均の計算が行われなくなるため、デー タ収集に関連するオーバーヘッドがなくなります。 デフォルトは 120 秒です。