| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
SystemInfo.AppResourceUsageStatistics
Queries application resource usage statistics for current application.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| SystemInfo | 15.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes, on macOS | ❌ No |
MBS( "SystemInfo.AppResourceUsageStatistics" { ; Version } ) More
Parameters
| Parameter | Description | Example | Flags |
|---|---|---|---|
| Version | The version of info requested. Default is version 6 with all information. You can pass lower number if you need less information. |
6 | Optional |
Result
Returns JSON or error.
Description
Queries application resource usage statistics for current application.The SystemInfo.AppResourceUsageStatistics function is a macOS-specific function that retrieves detailed resource usage statistics for the current process.
It fills a versioned rusage info structure with metrics such as CPU time, memory footprint, disk I/O, and energy usage. This API is part of the libproc library and allows fine-grained performance monitoring, including per-QoS and power-weighted data, not available through standard POSIX interfaces. Our plugin returns this as JSON.
| Field | Version | Description |
|---|---|---|
| uuid | 0 | UUID of the process |
| user_time | 0 | User CPU time in nanoseconds |
| system_time | 0 | System CPU time in nanoseconds |
| pkg_idle_wkups | 0 | Package idle wakeups |
| interrupt_wkups | 0 | Interrupt wakeups |
| pageins | 0 | Number of page-ins (from disk to memory) |
| wired_size | 0 | Wired memory size in bytes |
| resident_size | 0 | Resident memory size in bytes |
| phys_footprint | 0 | Physical memory footprint in bytes (more accurate than resident size) |
| proc_start_abstime | 0 | Absolute time (mach timebase) when the process started |
| proc_exit_abstime | 0 | Absolute time when the process exited (0 if still running) |
| child_user_time | 1 | Total user CPU time of child processes (nanoseconds) |
| child_system_time | 1 | Total system CPU time of child processes (nanoseconds) |
| child_pkg_idle_wkups | 1 | Package idle wakeups of children |
| child_interrupt_wkups | 1 | Interrupt wakeups of children |
| child_pageins | 1 | Page-ins by child processes |
| child_elapsed_abstime | 1 | Wall clock time used by child processes (absolute time units) |
| diskio_bytesread | 2 | Total bytes read from disk |
| diskio_byteswritten | 2 | Total bytes written to disk |
| cpu_time_qos_default | 3 | CPU time at default QoS level (nanoseconds) |
| cpu_time_qos_maintenance | 3 | CPU time at maintenance QoS level |
| cpu_time_qos_background | 3 | CPU time at background QoS level |
| cpu_time_qos_utility | 3 | CPU time at utility QoS level |
| cpu_time_qos_legacy | 3 | CPU time at legacy QoS level |
| cpu_time_qos_user_initiated | 3 | CPU time at user-initiated QoS level |
| cpu_time_qos_user_interactive | 3 | CPU time at user-interactive QoS level |
| billed_system_time | 3 | Billed system time (may differ from actual system time) |
| serviced_system_time | 3 | Actual system service time |
| logical_writes | 4 | Logical write calls (may be coalesced or buffered writes) |
| lifetime_max_phys_footprint | 4 | Max physical memory footprint reached during the process lifetime |
| instructions | 4 | Number of instructions executed (if supported) |
| cycles | 4 | Number of CPU cycles consumed (if supported) |
| billed_energy | 4 | Energy billed (nanojoules) |
| serviced_energy | 4 | Energy actually used (nJ) |
| interval_max_phys_footprint | 4 | Peak memory in recent sample interval |
| runnable_time | 4 | Time spent runnable, eg, on CPU run queue |
| flags | 5 | Internal status flags |
| user_ptime | 6 | Power-weighted user time |
| system_ptime | 6 | Power-weighted system time |
| pinstructions | 6 | Power-weighted instructions |
| pcycles | 6 | Power-weighted cycles |
| energy_nj | 6 | Total energy used (nanojoules) |
| penergy_nj | 6 | Power-weighted energy |
| secure_time_in_system | 6 | Secure system time (likely TEE/SEP-related) |
| secure_ptime_in_system | 6 | Power-weighted secure system time |
| neural_footprint | 6 | Neural engine memory used |
| lifetime_max_neural_footprint | 6 | Max neural footprint lifetime |
| interval_max_neural_footprint | 6 | Max neural footprint in interval |
Examples
Query the resource usage:
Set Variable [ $json; Value: MBS( "SystemInfo.AppResourceUsageStatistics" ) ]
Example result:
{ "proc_start_abstime" : 19488832800055, "flags" : 0, "energy_nj" : 12930421197, "cycles" : 19548064738, "neural_footprint" : 0, "pageins" : 801, "system_ptime" : 18468967, "billed_system_time" : 37294579, "diskio_byteswritten" : 479232, "proc_exit_abstime" : 0, "child_user_time" : 0, "cpu_time_qos_user_interactive" : 13764390, "system_time" : 36430490, "cpu_time_qos_utility" : 109626, "child_system_time" : 0, "cpu_time_qos_legacy" : 19151865, "version" : 6, "uuid" : "C68ECD17-38FB-31DC-AA31-83B7CD11C613", "wired_size" : 0, "pkg_idle_wkups" : 142, "cpu_time_qos_background" : 401773, "runnable_time" : 183496960, "penergy_nj" : 12401806171, "child_pageins" : 0, "interval_max_neural_footprint" : 0, "serviced_system_time" : 6166545, "diskio_bytesread" : 128475136, "phys_footprint" : 588584512, "user_ptime" : 70919191, "child_interrupt_wkups" : 0, "child_elapsed_abstime" : 0, "cpu_time_qos_user_initiated" : 6066361, "cpu_time_qos_maintenance" : 0, "billed_energy" : 1512777578, "instructions" : 46808473151, "cpu_time_qos_default" : 127422445, "lifetime_max_phys_footprint" : 596039232, "interval_max_phys_footprint" : 596039232, "lifetime_max_neural_footprint" : 0, "user_time" : 130485970, "child_pkg_idle_wkups" : 0, "serviced_energy" : 66274559, "interrupt_wkups" : 3443, "resident_size" : 521551872, "pinstructions" : 39884283671, "pcycles" : 13315772972, "secure_time_in_system" : 0, "secure_ptime_in_system" : 0, "logical_writes" : 2412548 }
Example result:
{ "proc_start_abstime" : 19488832800055, "flags" : 0, "energy_nj" : 12930421197, "cycles" : 19548064738, "neural_footprint" : 0, "pageins" : 801, "system_ptime" : 18468967, "billed_system_time" : 37294579, "diskio_byteswritten" : 479232, "proc_exit_abstime" : 0, "child_user_time" : 0, "cpu_time_qos_user_interactive" : 13764390, "system_time" : 36430490, "cpu_time_qos_utility" : 109626, "child_system_time" : 0, "cpu_time_qos_legacy" : 19151865, "version" : 6, "uuid" : "C68ECD17-38FB-31DC-AA31-83B7CD11C613", "wired_size" : 0, "pkg_idle_wkups" : 142, "cpu_time_qos_background" : 401773, "runnable_time" : 183496960, "penergy_nj" : 12401806171, "child_pageins" : 0, "interval_max_neural_footprint" : 0, "serviced_system_time" : 6166545, "diskio_bytesread" : 128475136, "phys_footprint" : 588584512, "user_ptime" : 70919191, "child_interrupt_wkups" : 0, "child_elapsed_abstime" : 0, "cpu_time_qos_user_initiated" : 6066361, "cpu_time_qos_maintenance" : 0, "billed_energy" : 1512777578, "instructions" : 46808473151, "cpu_time_qos_default" : 127422445, "lifetime_max_phys_footprint" : 596039232, "interval_max_phys_footprint" : 596039232, "lifetime_max_neural_footprint" : 0, "user_time" : 130485970, "child_pkg_idle_wkups" : 0, "serviced_energy" : 66274559, "interrupt_wkups" : 3443, "resident_size" : 521551872, "pinstructions" : 39884283671, "pcycles" : 13315772972, "secure_time_in_system" : 0, "secure_ptime_in_system" : 0, "logical_writes" : 2412548 }
Check disk I/O for setting a field:
# We capture statistics before
Set Variable [ $j1 ; Value: MBS( "SystemInfo.AppResourceUsageStatistics") ]
Pause/Resume Script [ Duration (seconds): ,5 ]
#
Set Field [ Test::test ; Random ]
# Ask FileMaker to save changes
Commit Records/Requests [ With dialog: Off ]
# flush caches to make sure FileMaker does write
Flush Cache to Disk
#
# We capture statistics after
Pause/Resume Script [ Duration (seconds): ,5 ]
Set Variable [ $j2 ; Value: MBS( "SystemInfo.AppResourceUsageStatistics") ]
#
# calculate difference and show
Set Variable [ $w1 ; Value: JSONGetElement ( $j1 ; "logical_writes" ) ]
Set Variable [ $w2 ; Value: JSONGetElement ( $j2 ; "logical_writes" ) ]
Set Variable [ $d1 ; Value: JSONGetElement ( $j1 ; "diskio_byteswritten" ) ]
Set Variable [ $d2 ; Value: JSONGetElement ( $j2 ; "diskio_byteswritten" ) ]
Show Custom Dialog [ "bytes written" ; ($w2 - $w1) & " bytes logical" & ¶ & ($d2 - $d1) & " bytes written" ]
Set Variable [ $j1 ; Value: MBS( "SystemInfo.AppResourceUsageStatistics") ]
Pause/Resume Script [ Duration (seconds): ,5 ]
#
Set Field [ Test::test ; Random ]
# Ask FileMaker to save changes
Commit Records/Requests [ With dialog: Off ]
# flush caches to make sure FileMaker does write
Flush Cache to Disk
#
# We capture statistics after
Pause/Resume Script [ Duration (seconds): ,5 ]
Set Variable [ $j2 ; Value: MBS( "SystemInfo.AppResourceUsageStatistics") ]
#
# calculate difference and show
Set Variable [ $w1 ; Value: JSONGetElement ( $j1 ; "logical_writes" ) ]
Set Variable [ $w2 ; Value: JSONGetElement ( $j2 ; "logical_writes" ) ]
Set Variable [ $d1 ; Value: JSONGetElement ( $j1 ; "diskio_byteswritten" ) ]
Set Variable [ $d2 ; Value: JSONGetElement ( $j2 ; "diskio_byteswritten" ) ]
Show Custom Dialog [ "bytes written" ; ($w2 - $w1) & " bytes logical" & ¶ & ($d2 - $d1) & " bytes written" ]
See also
Release notes
- Version 15.3
- Added SystemInfo.AppResourceUsageStatistics function.
Blog Entries
- MBS FileMaker Plugin 15.3 News
- Check how much disk I/O a script step causes
- Neues MBS Plugin 15.3 für Claris FileMaker
- MBS Plugin 15.3 for Claris FileMaker
- MBS FileMaker Plugin, version 15.3pr4
This function is free to use.
Created 17th June 2025, last changed 5th September 2025
