Visit Azul.com Support

zing-ps Command Output

For the reserve-at-launch memory reservation option, Upper Limits are set to each of the System Azul Zulu Prime Builds of OpenJDK (Azul Zulu Prime JVM) memory pools used by the JVM. This includes the Java Heap, Contingency and Pause Prevention memory pools.

When using reserve-at-launch, the Java Heap’s memory will only be reserved from the Reservable memory pool of System Azul Zulu Prime JVM memory when the process is launched. In zing-ps, if no Azul Zulu Prime JVM process is running then the Reservable used will be zero.

Likewise, for the Contingency and Pause Prevention memory pools, when no Azul Zulu Prime JVM process is running the zing-ps will show zero memory use for both pools. When a Azul Zulu Prime JVM process is launched, a minimum amount of memory is reserved. This reserved Contingency and Pause Prevention memory is, in most cases, not used by the Azul Zulu Prime JVM process when it starts. In zing-ps, this reserved, unused memory is shown as free memory. If the Azul Zulu Prime JVM does use Pause Prevention or Contingency memory then the JVM will reserve that amount of memory plus an additional amount equal to the minimum free memory specified when the ZST was configured using system-config-zing-memory.

Memory Use Analysis with zing-ps -s

The following examples show how to obtain detailed summary information about memory use, both System Linux and System Azul Zulu Prime JVM memory.

The "Physical Total" memory pool refers to the total of the "Physical Used" and "Physical Free" memory pools, where "Physical Used" is equal to the sum of the "Linux Used" and "Zing Used" memory pools.

For monitoring active running processes on a Linux system, the zing-ps -s command reports "Zing Used" as the sum of the "Zing Reservable", "Contingency, Free", and "Pause Prevention Free" memory pools.

Summary of Total Memory Usage: Example 1: reserve-at-config

The memory for the Reservable, Contingency and Pause Prevention memory pools is reserved when system-config-zing-memory is run.

No Azul Zulu Prime JVM processes running

System Zing Memory reserved at configuration (reserve-at-config)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

90254

16740

73514

0

0

0

Free:

6430

6430

0

65778

3868

3868

Total:

96684

23170

73514

65778

3868

3868

Found 0 processes.

One Azul Zulu Prime JVM processes running

System Zing Memory reserved at configuration (reserve-at-config)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

90254

16855

73514

9750

0

0

Free:

6366

6366

0

56028

3868

3868

Total:

96735

23221

73514

65778

3868

3868

Found 1 process.

 USER PID TIME LRSS ZRSS Xmx CTG PP JSYS CMD

juser 23874 00:00:04 93 1861 9750 0 0 3 java myApplication 

One Azul Zulu Prime JVM process running and using more Java heap memory

System Zing Memory reserved at configuration (reserve-at-config)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

90475

16961

73514

9750

0

0

Free:

6260

6260

0

56028

3868

3868

Total:

96735

23221

73514

65778

3868

3868

Found 1 process.

 USER PID TIME LRSS ZRSS Xmx CTG PP JSYS CMD
juser 23874 00:00:29 198 6887 9750 0 0 6 java myApplication 

One Azul Zulu Prime JVM process running and using Contingency memory

System Zing Memory reserved at configuration (reserve-at-config)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

90534

17020

73514

9750

3092

0

Free:

6201

6201

0

56028

776

3868

Total:

96735

23221

73514

65778

3868

3868

Found 1 process.

 USER PID TIME LRSS ZRSS Xmx CTG PP JSYS CMD
juser 23874 00:02:34 257 12569 9750 3090 0 9 java myApplication 
Note
"Zing Used" refers to the total amount of memory that has been reserved for running Azul Zulu Prime JVMs. The sum of "Reservable Used", "Contingency Used", and "PausePrev Used” is equal to the amount of "Zing Used."

Summary of Total Memory Usage: Example 3 - reserve-at-launch with Upper Limits for Reservable, Contingency and PausePrev

Sample output of zing-ps –s on a system configured to reserve Azul Zulu Prime JVM memory when Java processes are launched, when no Azul Zulu Prime JVM processes are running.

System Zing Memory reserved at process launch (reserve-at-launch) for Reservable, Contingency and PausePrev Memory withMinimumFreeMemory specified for Contingency and PausePrevention.

No Azul Zulu Prime JVM processes running

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

1231

1231

0

0

0

0

Free:

95504

-

-

-

0

0

Total:

96735

-

0

0

0

0

UpperLimit

-

-

72550

65298

3626

3626

Found 0 processes

One Azul Zulu Prime JVM process running showing used, free and total memory for Zing, Reservable, Contingency and Pause Prevention

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

73873

1323

72550

65298

0

0

Free:

22862

-

-

-

3626

3626

Total:

96735

-

72550

65298

3626

3626

UpperLimit

-

-

72550

65298

3626

3626

Found 1 process

 USER PID TIME LRSS ZRSS Xmx CTG PP JSYS CMD
juser 9688 00:00:07 103 3606 65298 0 0 2 java -jar myApplication.jar 

Summary of Total Memory Usage: Example 3 - reserve-at-launch with Upper Limits for Reservable, Contingency and PausePrev

No Azul Zulu Prime JVM processes running

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

1157

1157

0

0

0

0

Free:

95578

-

-

-

0

0

Total:

96735

-

0

0

0

0

UpperLimit

-

-

87060

82224

48366

48366

Found 0 processes

One Azul Zulu Prime JVM process running showing used, free and total memory for Zing, Reservable, Contingency and Pause Prevention

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

83945

1321

82624

0

0

0

Free:

12790

-

-

-

200

200

Total:

96735

-

82624

82224

200

200

UpperLimit

-

-

87060

82224

48366

48366

Found 1 process

 USER PID TIME LRSS ZRSS Xmx CTG PP JSYS CMD
juser 12216 00:00:06 102 4438 82224 0 0 2 java -jar myApplication.jar 

One Azul Zulu Prime JVM process running and using Contingency memory

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

27631

17037

10594

9750

444

0

Free:

69104

-

-

-

200

200

Total:

96735

-

10594

9750

644

200

UpperLimit

-

-

87060

82224

48366

48366

Found 1 process

 USER PID TIME LRSS ZRSS Xmx CTG PP JSYS CMD
juser 23539 00:01:13 241 9614 9750 441 0 8 java myApplication 

One Azul Zulu Prime JVM process running and using large amounts of Contingency memory

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

29667

17059

12608

9750

2458

0

Free:

67068

-

-

-

200

200

Total:

96735

-

12608

9750

2658

200

UpperLimit

-

-

87060

82224

48366

48366

Found 1 process

 USER PID TIME LRSS ZRSS Xmx CTG PP JSYS CMD
juser 23539 00:07:39 260 11635 9750 2462 0 9 java myApplication 
Note
"Zing UpperLimit" is the maximum amount of memory allowed for Zing processes, but it is not all reserved. "Zing UpperLimit" is OverallUpperLimit. The total reserved memory for Zing, at the time of running the zing-ps command, is equal to the sum of Reservable Total, Contingency Total, and PausePrev Total. The actual Zing memory in use is the sum of Reservable Used, Contingency Used and PausePrev Used.
Physical Linux Zing Reservable Contingency PausePrev

Used:

144241

113921

30320

19456

1164

0

Free:

651

-

-

-

4268

5432

Total:

144893

-

30320

19456

5432

5432

Physical

Linux

Zing

Reservable

Contingency

PausePrev

Used:

83601

83601

0

0

0

0

Free:

61292

-

-

-

0

0

Total:

144893

0

-

0

0

0

UpperLimit

-

-

108668

97804

5432

5432

Note
"Zing UpperLimit" is the maximum amount of memory allowed for Zing processes, but it is not all reserved. "Zing UpperLimit" is the sum of Reservable UpperLimit, Contingency UpperLimit, and PausePrev UpperLimit. The total reserved memory for Zing, at the time of running the zing-ps command, is equal to the sum of Reservable Total, Contingency Total, and PausePrev Total. The actual Zing memory in use is the sum of Reservable Used, Contingency Used and PausePrev Used.

Summary of Total Memory Usage: Example 4

Sample output from a system with multiple zing partitions.

Partition 0: Zing Memory reserved at process launch (reserve-at-launch)

Partition 0 Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

N/A

N/A

23636

14336

0

0

Free:

N/A

N/A

-

-

4650

4650

Total:

N/A

N/A

23636

14336

4650

4650

UpperLimit

N/A

N/A

93030

83730

4650

4650

Partition 1: Zing Memory reserved at process launch (reserve-at-launch)

Partition 1 Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

N/A

N/A

0

0

0

0

Free:

N/A

N/A

-

-

0

0

Total:

N/A

N/A

0

0

0

0

UpperLimit

N/A

N/A

93030

83730

4650

4650

Partition 2: Zing Memory reserved at process launch (reserve-at-launch)

Partition 2 Usage Summary Physical Linux Zing Reservable Contingency PausePrev

Used:

N/A

N/A

0

0

0

0

Free:

N/A

N/A

-

-

0

0

Total:

N/A

N/A

0

0

0

0

UpperLimit

N/A

N/A

93030

83730

4650

4650

Consolidated Summary

Memory Usage Summary Physical Linux Zing

Used:

54167

30531

23636

Free:

462673

-

-

Total:

516840

-

23636

Memory Usage for Each Running Azul Zulu Prime JVM Process

 Found 7 processes

 USER   PID   TIME     LRSS  ZRSS  ZCTG  ZXmx CMD

 user1 25160  00:00:03  63   434   0     1024 java -cp invokeinstruction MH

 user2 21990  00:02:25  203  1152  0     6144 java -jar gcLogAnalyser-99.99.99.99-295.jar

 user3 30900  00:01:43  66   472   0     1024 tnameserv -ORBInitialPort 18322

 user4 30849  08:26:34  181  452   0     1024 rmid -port 18321 -log Rmid

 user5 30337  00:02:44  61   460   0     1024 tnameserv -ORBInitialPort 16848

 user6 30043  00:02:30  44   446   0     1024 rmid -port 16847 -log Rmid

 user7 4324   00:31:18  47   570   0     1024 tnameserv tnameserv -ORBInitialPort 20735 

The default for zing-ps return is the same as zing-ps -j. Including zing-ps command options adds or removes return content relative to the default -j return. To not display the per process detail, add the -d option.