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. Следующая таблица приводит доступные параметры. Используйте - опции общая опция, чтобы вывести на экран список опций для определенной установки платформы.

Опция	Дисплеи...
класс	Статистика по поведению загрузчика класса.
компилятор	Статистика поведения 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.

- Опция класса

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

- Опция gc

Опция-gccapacity

Опция-gccause

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

Опция-gcnew

Опция-gcnewcapacity

Опция-gcold

Опция-gcoldcapacity

Опция-gcpermcapacity

Опция-gcutil

Опция-printcompilation

ПРИМЕРЫ

Этот раздел представляет некоторые примеры контроля локальной 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).

СМ. ТАКЖЕ

• java - Средство запуска Приложения Java
• jps - Приложение Состояния Процесса Java
• jstatd - jvmstat демон
• rmiregistry - Реестр Удаленного объекта Java

---

Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Свяжитесь с Нами