Get process activity

4D v20.1


Get process activity {( options )} -> 戻り値

引数	型	説明
options	倍長整数	返されるオプション
戻り値	オブジェクト	実行中のプロセスまたはユーザーセッション(4D Serverのみ)のスナップショット

説明

Get process activity コマンドは特定の時刻での、接続ユーザーセッションや関連する実行中のスナップショットを返します。このコマンドは、全てのプロセスを返します。これには、PROCESS PROPERTIES コマンドでもアクセスできない内部プロセスも含まれます。

サーバー上で実行され、options 引数を省略した場合には、Get process activity はデフォルトでユーザーセッションとプロセスの一覧の両方を、以下のように返します。

{
"sessions": [
          {
             "type": "remote",
             "userName": "Designer",
             "machineName": "iMac27caroline",
             "systemUserName": "Caroline Briaud",
             "IPAddress": "192.168.18.18",
             "hostType": "mac",
             "creationDateTime": "2017-09-22T12:46:39Z",
             "state": "postponed",
             "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
           },...
       ],
"processes": [
          {
             "name": "Application process",
             "sessionID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5",
             "number": 4,
             "ID": 4,
             "visible": true,
             "systemID": "123145476132864",
             "type": -18,
             "state": 0,
             "cpuUsage": 0,
             "cpuTime": 0.006769,
             "preemptive": false,
             "session": {   
                      "type": "remote",
                      "userName": "Designer",
                      "machineName": "iMac27caroline",
                      "systemUserName": "Caroline Briaud",
                      "IPAddress": "192.168.18.18",
                      "hostType": "mac",
                      "creationDateTime": "2017-09-22T12:46:39Z",
                      "state": "postponed",
                      "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
                       }
           },...
    ]
}

options 引数に"4D Environment"テーマ内にある以下の定数のいづれか一つを渡すことで、返される一覧を選択することができます:

定数	型	値	コメント
Processes only	倍長整数	1	プロセスの一覧のみを返します。
Sessions only	倍長整数	2	セッションの一覧のみを返します。

リモート、あるいはローカルモードの4D で実行された場合、Get process activity はプロセスの一覧のみを返します(この場合options 引数は意味を持ちません)。

セッションの一覧

"sessions" プロパティには、サーバーで実行中の全てのユーザーセッションを記述するオブジェクトのコレクションが格納されます。

それぞれのセッションオブジェクトには以下のプロパティが含まれます:

プロパティ名	型	詳細
type	テキスト (enum)	セッションのタイプ。取り得る値: "remote"、"storedProcedure"、"web"、"rest"
userName	テキスト	ユーザー名
machineName	テキスト	リモートマシンの名前
systemUserName	テキスト	リモートマシン上で開かれているシステムセッションの名前
IPAddress	テキスト	リモートマシンのIP アドレス
hostType	テキスト (enum)	ホストのタイプ。取り得る値: "windows"、"mac"、"browser"
creationDateTime	Date ISO 8601	リモートマシンの接続の日付と時刻
state	テキスト (enum)	セッションの状態。取り得る値: "active"、"postponed"、"sleeping"
ID	テキスト	セッション UUID
persistentID	テキスト	セッションの永続的な ID

プロセスの一覧

"process"プロパティには、サーバーで実行中の全てのプロセスを記述するオブジェクトのコレクションが格納されます。

それぞれのセッションオブジェクトには以下のプロパティが含まれます:

プロパティ名

型

詳細

name

テキスト

プロセス名

sessionID

テキスト

セッション UUID

number

Longint

プロセス番号

Longint

プロセスの固有ID

visible

Boolean

表示ならTrue、それ以外はFalse

systemID

Text

ユーザープロセス、4Dプロセス、あるいはスペアプロセスのID

type

倍長整数

実行中のプロセスの型。"Process Type"テーマ内の以下の定数を使用することができます:

定数	値	コメント
HTTP Log flusher	-58
Logger process	-57
HTTP Listener	-56
HTTP Worker pool server	-55
SQL Listener	-54
SQL Net Session manager	-53
SQL Worker pool server	-52
DB4D Listener	-51
DB4D Mirror	-50
DB4D Cron	-49
DB4D Worker pool user	-48
DB4D Garbage collector	-47
DB4D Flush cache	-46
DB4D Index builder	-45
ServerNet Session manager	-44
ServerNet Listener	-43
Worker pool spare	-42
Worker pool in use	-41
Other internal process	-40
Main 4D process	-39
SOAP process	-33
Web server spare process	-32
Client manager process	-31
Compiler process	-29
Monitor process	-26
Internal timer process	-25
SQL Method execution process	-24
MSC process	-22
Restore Process	-21
Log file process	-20
Backup process	-19
Internal 4D server process	-18
Method editor macro process	-17
On exit process	-16
Server interface process	-15
Execute on client process	-14
Web server process	-13
Web process on 4D remote	-12
Other 4D process	-10
External task	-9
Event manager	-8
Apple event manager	-7
Serial Port Manager	-6
Indexing process	-5
Cache manager	-4
Web process with no context	-3
Design process	-2
Main process	-1
None	0
Execute on server process	1
Created from menu command	2
Created from execution dialog	3
Other user process	4
Worker process	5	ユーザーによってローンチされたワーカープロセス

state

倍長整数

カレントの状態(Process State の定数の一覧を参照してください)

cpuUsage

実数

このプロセスに使用された時間の割合(0から1の間)

cpuTime

実数

実行時間(秒)

preemptive

ブール

プリエンプティブ実行中ならTrue、それ以外にはfalse

session

オブジェクト

プロセスが実行されている特定のセッション。Processes only 引数が渡された場合には未定義

url

テキスト

Web サーバー上で実行中のWeb(-3)あるいはSOAP(-33)プロセスのURLおよびそのパスと引数(あれば)。他のタイプのプロセスに対しては返されません。

例題

全てのユーザーセッションの情報を取得したい場合を考えます:

  //サーバー側で実行すること

 

 C_OBJECT($o)

 C_LONGINT($i)

 

 $o:=Get process activity //プロセスとセッションの情報を取得

 For($i;0;($o.processes.length)-1) // "processes" コレクションに対してループを実行

    $processName:=$o.processes[$i].name

    $userName:=String($o.processes[$i].session.userName) // userName に簡単にアクセスする

  // session オブジェクトがUndefined の場合があるのでString コマンドを必ず使用すること

 End for

参照

PROCESS PROPERTIES
WEB Get server info