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 秒です。