Spec-Zone .ru
спецификации, руководства, описания, API
Содержание документации

jstat - Контрольный Инструмент Статистики виртуальной машины Java

РЕЗЮМЕ

jstat [ generalOption | outputOptions vmid [interval[s|ms] [count]] ]

ПАРАМЕТРЫ

generalOption
Единственный общий параметр командной строки (-справка, - опции, или - версия)
outputOptions
Один или более выходные опции, состоя из единственного statOption, плюс любой из-t,-h, и-J опции.
vmid
Идентификатор виртуальной машины, строка, указывающая на целевую виртуальную машину Java (JVM). Общий синтаксис
[protocol:][//]lvmid[@hostname[:port]/servername]
Синтаксис строки vmid в значительной степени соответствует синтаксису URI. vmid может измениться от простого целого числа, представляющего локальную JVM более сложной конструкции, определяющей коммуникационный протокол, номер порта, и другие специфичные для реализации значения. См. Идентификатор Виртуальной машины для деталей.
interval[s|ms]
Интервал выборки в указанных модулях, секунды (ы) или миллисекунды (мс). Модули значения по умолчанию являются миллисекундами. Должно быть положительное целое число. Если определено, jstat произведет свой вывод в каждом интервале.
count
Число выборок, чтобы вывести на экран. Значение по умолчанию является бесконечностью; то есть, jstat статистика дисплеев, пока целевая JVM не завершается, или jstat команда завершается. Должно быть положительное целое число.

ОПИСАНИЕ

jstat инструмент выводит на экран статистику производительности для инструментованной виртуальной машины Java HotSpot (JVM). Целевая JVM идентифицируется ее идентификатором виртуальной машины, или vmid опцией, описанной ниже.

ОТМЕТЬТЕ: Эта утилита неподдерживается и, возможно, не доступна в будущих версиях JDK. Это не в настоящий момент доступно на Windows 98 и Windows ME. платформы.

ИДЕНТИФИКАТОР ВИРТУАЛЬНОЙ МАШИНЫ

Синтаксис строки vmid в значительной степени соответствует синтаксису URI:

[protocol:][//]lvmid[@hostname][:port][/servername]
protocol
Коммуникационный протокол. Если протокол опускается, и имя узла не определяется, протокол значения по умолчанию является платформой определенный оптимизированный локальный протокол. Если протокол опускается, и имя узла определяется, то протокол значения по умолчанию является rmi.
lvmid
Локальный идентификатор виртуальной машины для целевой JVM. lvmid является специфичным для платформы значением, которое однозначно определяет JVM на системе. lvmid является единственным необходимым компонентом идентификатора виртуальной машины. lvmid обычно, но не обязательно, идентификатор процесса операционной системы для целевого процесса JVM. Можно использовать jps команду, чтобы определить lvmid. Кроме того, можно определить lvmid на платформах Unix с командой постскриптума, и на Windows с Windows Task Manager.
hostname
Имя узла или IP-адрес, указывающий на целевой узел. Если имя узла опускается, то целевой узел является локальным узлом.
port
Порт значения по умолчанию для того, чтобы связаться с удаленным сервером. Если имя узла опускается, или протокол определяет оптимизированный, локальный протокол, то порт игнорируется. Иначе, обработка параметра порта является определенной реализацией. Для значения по умолчанию rmi протокол, порт указывает на номер порта для rmiregistry на удаленном узле. Если порт опускается, и протокол указывает на rmi, то значение по умолчанию rmiregistry порт (1099) используется.
servername
Обработка этого параметра зависит от реализации. Для оптимизированного локального протокола игнорируется это поле. Для rmi протокола это представляет имя удаленного объекта RMI на удаленном узле.

ОПЦИИ

jstat команда поддерживает два типа опций, общих параметров и выходных опций. Общие параметры заставляют jstat выводить на экран простое использование и информацию о версии. Выходные опции определяют контент и формат статистического вывода.

ОТМЕТЬТЕ: Все опции, и их функциональность подвержены изменениям или удаление в будущих выпусках.

ОБЩИЕ ПАРАМЕТРЫ

Если Вы определяете одни из общих параметров, невозможно определить никакую другую опцию или параметр.

- справка
Сообщение справки дисплея.
- версия
Выведите на экран информацию о версии.
- опции
Дисплейный список опций статистики. См. Выходной раздел Опций ниже.

ВЫХОДНЫЕ ОПЦИИ

Если Вы не определяете общую опцию, то можно определить выходные опции. Выходные опции определяют контент и формат вывода jstat, и состоят из единственного statOption, плюс любая из других выходных опций (-h,-t, и-J). statOption должен быть на первом месте.

Вывод форматируется, поскольку таблица, со столбцами разделяются пробелами. Строка заголовка с заголовками описывает столбцы. Используйте-h опцию, чтобы установить частоту, в которой выводится на экран заголовок. Имена заголовка столбца являются обычно непротиворечивыми между различными вариантами. Вообще, если две опции предоставляют столбцу то же самое имя, то источник данных для двух столбцов является тем же самым.

Используйте-t опцию, чтобы вывести на экран столбец метки времени, маркированный Timestamp как первый столбец вывода. Timestamp столбец содержит прошедшее время, в секундах, начиная с запуска целевой JVM. Разрешение метки времени зависит от различных факторов и подвергается изменению из-за задержанного планирования потоков на в большой степени загруженных системах.

Используйте интервал и параметры количества, чтобы определить, как часто и сколько времен, соответственно, jstat выводит на экран его вывод.

ОТМЕТЬТЕ: Вам советуют не записать сценарии, чтобы проанализировать вывод jstat, так как формат может измениться в будущих выпусках. Если Вы хотите писать сценарии, которые анализируют вывод jstat, ожидают изменять их для будущих выпусков этого инструмента.

-statOption
Определяет информацию о статистике это дисплеи jstat. Следующая таблица приводит доступные параметры. Используйте - опции общая опция, чтобы вывести на экран список опций для определенной установки платформы.

Опция Дисплеи...
class Статистика по поведению загрузчика class.
компилятор Статистика поведения HotSpot Своевременный компилятор.
gc Статистика поведения собранной "мусор" "кучи".
gccapacity Статистика емкостей поколений и их соответствующих пробелов.
gccause Сводка статистики сборки "мусора" (то же самое как-gcutil), с причиной последнего и текущего (если применимый) события сборки "мусора".
gcnew Статистика поведения нового поколения.
gcnewcapacity Статистика размеров новых поколений и ее соответствующих пробелов.
gcold Статистика поведения старых и постоянных поколений.
gcoldcapacity Статистика размеров старой генерации.
gcpermcapacity Статистика размеров постоянной генерации.
gcutil Сводка статистики сборки "мусора".
printcompilation Статистика метода компиляции HotSpot.
-h n
Выведите на экран заголовок столбца каждый n выборки (выходные строки), где n является положительным целым числом. Значение по умолчанию 0, который выводит на экран заголовок столбца выше первой строки данных.
-t n
Выведите на экран столбец метки времени как первый столбец вывода. Метка времени является временем со времени запуска целевой JVM.
-JjavaOption
Передайте javaOption к средству запуска приложения java. Например,-J-Xms48m устанавливает память запуска в 48 мегабайтов. Для полного списка опций см. java - средство запуска приложения Java

STATOPTIONS И ВЫВОД

Следующие таблицы суммируют столбцы что jstat выводы для каждого statOption.

Опция-class

Статистика Загрузчика класса
Столбец Описание
Загруженный Число классов загружалось.
Байты Число Килобайтов загружалось.
Разгруженный Число классов разгрузилось.
Байты Число Килобайтов разгрузилось.
Время Время, проведенное, выполняя class, загружает и разгружает операции.

- Опция компилятора

HotSpot Своевременная Статистика Компилятора
Столбец Описание
Скомпилированный Число задач компиляции выполняется.
Отказавший Число задач компиляции, которые перестали работать.
Недопустимый Число задач компиляции, которые были лишены законной силы.
Время Время, проведенное, выполняя задачи компиляции.
FailedType Скомпилируйте тип последней отказавшей компиляции.
FailedMethod Имя класса и метод для последней отказавшей компиляции.

- Опция gc

Собранная "мусор" статистика "кучи"
Столбец Описание
S0C Текущее пространство оставшегося в живых 0 емкостей (Кбайт).
S1C Текущее пространство оставшегося в живых 1 емкость (Кбайт).
S0U Пространство оставшегося в живых 0 использований (Кбайт).
S1U Пространство оставшегося в живых 1 использование (Кбайт).
EC Текущая емкость пространства рая (Кбайт).
EU Использование пространства рая (Кбайт).
OC Текущая старая емкость пространства (Кбайт).
OU Старое использование пространства (Кбайт).
PC Текущая постоянная емкость пространства (Кбайт).
PU Постоянное использование пространства (Кбайт).
YGC Число молодых Событий GC генерации.
YGCT Молодое время сборки "мусора" генерации.
FGC Число полных событий GC.
FGCT Целое время сборки "мусора".
GCT Полное время сборки "мусора".

Опция-gccapacity

Генерация Пула памяти и Емкости Пространства
Столбец Описание
NGCMN Минимальная емкость нового поколения (Кбайт).
NGCMX Максимальная емкость нового поколения (Кбайт).
NGC Текущая емкость нового поколения (Кбайт).
S0C Текущее пространство оставшегося в живых 0 емкостей (Кбайт).
S1C Текущее пространство оставшегося в живых 1 емкость (Кбайт).
EC Текущая емкость пространства рая (Кбайт).
OGCMN Минимальная старая емкость генерации (Кбайт).
OGCMX Максимальная старая емкость генерации (Кбайт).
OGC Текущая старая емкость генерации (Кбайт).
OC Текущая старая емкость пространства (Кбайт).
PGCMN Минимальная постоянная емкость генерации (Кбайт).
PGCMX Максимальная Постоянная емкость генерации (Кбайт).
PGC Текущая Постоянная емкость генерации (Кбайт).
PC Текущая Постоянная емкость пространства (Кбайт).
YGC Число Молодых Событий GC генерации.
FGC Число Полных Событий GC.

Опция-gccause

Эта опция выводит на экран ту же самую сводку статистики сборки "мусора" как-gcutil опция, но включает причины последнего события сборки "мусора" и (если применимый) текущее событие сборки "мусора". В дополнение к столбцам, перечисленным для-gcutil, эта опция добавляет следующие столбцы:

Статистика Сборки "мусора", Включая События GC
Столбец Описание
LGCC Причина последней Сборки "мусора".
GCC Причина текущей Сборки "мусора".

Опция-gcnew

Статистика Нового поколения
Столбец Описание
S0C Текущее пространство оставшегося в живых 0 емкостей (Кбайт).
S1C Текущее пространство оставшегося в живых 1 емкость (Кбайт).
S0U Пространство оставшегося в живых 0 использований (Кбайт).
S1U Пространство оставшегося в живых 1 использование (Кбайт).
TT Порог Tenuring.
MTT Максимум tenuring порог.
DSS Требуемый размер оставшегося в живых (Кбайт).
EC Текущая емкость пространства рая (Кбайт).
EU Использование пространства рая (Кбайт).
YGC Число молодых событий GC генерации.
YGCT Молодое время сборки "мусора" генерации.

Опция-gcnewcapacity

Статистика Размера Пространства Нового поколения
Столбец Описание
NGCMN
Минимальная емкость нового поколения (Кбайт).
NGCMX Максимальная емкость нового поколения (Кбайт).
NGC Текущая емкость нового поколения (Кбайт).
S0CMX Максимальное пространство оставшегося в живых 0 емкостей (Кбайт).
S0C Текущее пространство оставшегося в живых 0 емкостей (Кбайт).
S1CMX Максимальное пространство оставшегося в живых 1 емкость (Кбайт).
S1C Текущее пространство оставшегося в живых 1 емкость (Кбайт).
ECMX Максимальная емкость пространства рая (Кбайт).
EC Текущая емкость пространства рая (Кбайт).
YGC Число молодых событий GC генерации.
FGC Число Полных Событий GC.

Опция-gcold

Старая и Постоянная Статистика Генерации
Столбец Описание
PC Текущая постоянная емкость пространства (Кбайт).
PU Постоянное использование пространства (Кбайт).
OC Текущая старая емкость пространства (Кбайт).
OU старое использование пространства (Кбайт).
YGC Число молодых событий GC генерации.
FGC Число полных событий GC.
FGCT Целое время сборки "мусора".
GCT Полное время сборки "мусора".

Опция-gcoldcapacity

Старая Статистика Генерации
Столбец Описание
OGCMN Минимальная старая емкость генерации (Кбайт).
OGCMX Максимальная старая емкость генерации (Кбайт).
OGC Текущая старая емкость генерации (Кбайт).
OC Текущая старая емкость пространства (Кбайт).
YGC Число молодых событий GC генерации.
FGC Число полных событий GC.
FGCT Целое время сборки "мусора".
GCT Полное время сборки "мусора".

Опция-gcpermcapacity

Постоянная Статистика Генерации
Столбец Описание
PGCMN Минимальная постоянная емкость генерации (Кбайт).
PGCMX Максимальная постоянная емкость генерации (Кбайт).
PGC Текущая постоянная емкость генерации (Кбайт).
PC Текущая постоянная емкость пространства (Кбайт).
YGC Число молодых событий GC генерации.
FGC Число полных событий GC.
FGCT Целое время сборки "мусора".
GCT Полное время сборки "мусора".

Опция-gcutil

Сводка Статистики Сборки "мусора"
Столбец Описание
S0 Пространство оставшегося в живых 0 использований как процент текущей емкости пространства.
S1 Пространство оставшегося в живых 1 использование как процент текущей емкости пространства.
E Использование пространства рая как процент текущей емкости пространства.
O Старое использование пространства как процент текущей емкости пространства.
P Постоянное использование пространства как процент текущей емкости пространства.
YGC Число молодых событий GC генерации.
YGCT Молодое время сборки "мусора" генерации.
FGC Число полных событий GC.
FGCT Целое время сборки "мусора".
GCT Полное время сборки "мусора".

Опция-printcompilation

Статистика Метода Компилятора HotSpot
Столбец Описание
Скомпилированный Число задач компиляции выполняется.
Размер Число байтов байт-кода для метода.
Ввести Тип компиляции.
Метод Имя класса и имя метода, идентифицирующее скомпилированный метод. Имя класса использует "/" вместо"." в качестве разделителя пространства имен. Имя метода является методом в пределах данного class. Формат для этих двух полей является непротиворечивым с HotSpot - XX: + опция PrintComplation.

ПРИМЕРЫ

Этот раздел представляет некоторые примеры контроля локальной JVM с lvmid 21891.

Используя gcutil опцию

Этот пример присоединяет к lvmid 21891 и берет 7 выборок в 250 интервалах миллисекунды и выводит на экран вывод как определено-gcutil опцией.

jstat -gcutil 21891 250 7
S0 S1 E O P YGC YGCT FGC FGCT GCT
12.44 0.00 27.20 9.49 96.70 78 0.176 5 0.495 0.672
12.44 0.00 62.16 9.49 96.70 78 0.176 5 0.495 0.672
12.44 0.00 83.97 9.49 96.70 78 0.176 5 0.495 0.672
0.00 7.74 0.00 9.51 96.70 79 0.177 5 0.495 0.673
0.00 7.74 23.37 9.51 96.70 79 0.177 5 0.495 0.673
0.00 7.74 43.82 9.51 96.70 79 0.177 5 0.495 0.673
0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673

Вывод этого примера показывает, что молодой набор генерации произошел между 3-ьей и 4-ой выборкой. Набор занял 0.001 секунды и продвинул объекты от пространства рая (E) к старому пространству (O), приводя к увеличению старого использования пространства от 9.49 % до 9.51 %. Перед набором пространство оставшегося в живых составляло используемые 12.44 %, но после этого набора, это - используемые только 7.74 %.

Повторение строки заголовка столбца

Этот пример присоединяет к lvmid 21891 и берет выборки в 250 интервалах миллисекунды и выводит на экран вывод как определено-gcutil опцией. Кроме того, это использует-h3 опцию, чтобы вывести заголовок столбца после каждых 3 строк данных.

jstat -gcnew -h3 21891 250
S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
64.0 64.0 0.0 31.7 31 31 32.0 512.0 178.6 249 0.203
64.0 64.0 0.0 31.7 31 31 32.0 512.0 355.5 249 0.203
64.0 64.0 35.4 0.0 2 31 32.0 512.0 21.9 250 0.204
S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
64.0 64.0 35.4 0.0 2 31 32.0 512.0 245.9 250 0.204
64.0 64.0 35.4 0.0 2 31 32.0 512.0 421.1 250 0.204
64.0 64.0 0.0 19.0 31 31 32.0 512.0 84.4 251 0.204
S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204

В дополнение к показу повторяющейся строки заголовка этот пример показывает, что между 2-ыми и 3-ьими выборками, молодой GC произошел. Его продолжительность составляла 0.001 секунды. Набор, найденный достаточно многими живыми данными, что пространство оставшегося в живых 0 использований (S0U) было бы, превысит требуемый Размер оставшегося в живых (DSS). В результате объекты были продвинуты на старую генерацию (не видимый в этом выводе), и tenuring порог (TT) был понижен от 31 до 2.

Другой набор происходит между 5-ыми и 6-ыми выборками. Этот набор, найденный очень немногими оставшимися в живых и, возвратил tenuring порог 31.

Включая метку времени для каждой выборки

Этот пример присоединяет к lvmid 21891 и берет 3 выборки в 250 интервалах миллисекунды.-t опция используется, чтобы генерировать метку времени для каждой выборки в первом столбце.

jstat -gcoldcapacity -t 21891 250 3
Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT
150.1 1408.0 60544.0 11696.0 11696.0 194 80 2.874 3.799
150.4 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863

Timestamp столбец сообщает о прошедшем времени в секундах начиная с запуска целевой JVM. Кроме того, вывод-gcoldcapacity показывает старую емкость генерации (OGC) и старую емкость пространства (OC), увеличивающийся, поскольку "куча" расширяется, чтобы удовлетворить требованиям выделения и/или продвижения. Старая емкость генерации (OGC) выросла к от 11696 Кбайт до 13820 Кбайт после 81-ого Полного GC (FGC). Максимальная емкость генерации (и пространство) составляет 60544 Кбайта (OGCMX), таким образом, это все еще имеет пространство, чтобы расшириться.

Инструментарий монитора для удаленной JVM

Этот пример присоединяет к lvmid 40496 на системе, названной remote.domain использование-gcutil опции с выборками, взятыми каждую секунду неопределенно.

jstat -gcutil 40496@remote.domain 1000
... output omitted

lvmid объединяется с именем удаленного узла, чтобы создать vmid 40496@remote.domain. Этот vmid приводит к использованию rmi протокола, чтобы передать к значению по умолчанию jstatd сервер на удаленном узле. jstatd сервер располагается, используя rmiregistry на remote.domain, который связывается со значением по умолчанию rmiregistry порт (порт 1099).

СМ. ТАКЖЕ


Oracle и/или его филиалы Авторское право © 1993, 2012, Oracle и/или его филиалы. Все права защищены.
Свяжитесь с Нами