pmlogextract - Интернет в облаке

ПРОГРАММА:

ИМЯ

pmlogextract - уменьшать, извлекать, объединять и объединять архивы Performance Co-Pilot

СИНТАКСИС

pmlogextract [-dfwz] [-c файл конфигурации] [-S время начала] [-s образцы] [-T время окончания] [-v
объемные сэмплы] [-Z часовой пояс] вход [...] выходной

ОПИСАНИЕ

pmlogextract читает один или несколько архивных журналов Performance Co-Pilot (PCP), идентифицированных вход
и создает временно объединенный и / или сокращенный архивный журнал PCP выходной. Природа
слияние контролируется количеством входных архивных журналов, в то время как характер данных
сокращение контролируется аргументами командной строки. Входные данные должны быть архивом PCP.
журналы, созданные pmlogger(1) с данными о производительности, собранными из то же хозяин, но
обычно в разные периоды времени и, возможно (хотя и не обычно) с разными
регистрируются показатели производительности.

Если бы только один вход указано, то поведение по умолчанию просто копирует входной PCP
архивный журнал в выходной архивный журнал PCP. Когда два или более архивных журнала PCP
указано как вход, журналы объединяются (или объединяются) и записываются в выходной.

В выходной архивный журнал будет вставлена ​​запись с пометкой сразу после конца.
каждого из входных архивных журналов, чтобы указать на возможный временной разрыв между
конец одного входного архивного журнала и начало следующего входного архивного журнала. Увидеть
МАРК РЕКОРДЫ раздел ниже для получения дополнительной информации. После
конец последний (во временном порядке) входных архивных журналов.

КОМАНДА ЛИНИЯ ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Параметры командной строки для pmlogextract заключаются в следующем:

-c файл конфигурации
Извлекайте только те показатели, которые указаны в файл конфигурации из вход Архивные журналы PCP.
" файл конфигурации синтаксис принят pmlogextract более подробно объясняется в
Конфигурация Файл Синтаксис .

-d Отчаянный режим. Обычно, если возникает фатальная ошибка, все следы частично
письменный архив PCP выходной удален. С -d вариант, выходной архивный журнал
не удаляется.

-f В большинстве случаев все входящие архивные журналы собираются в
тот же часовой пояс. Но если это не так, то pmlogextract должен выбрать один из
часовые пояса из входных архивных журналов, которые будут использоваться в качестве часового пояса для выходных
архивный журнал. По умолчанию используется часовой пояс из последний входной архивный журнал.
" -f опция принудительно устанавливает часовой пояс из первый входной архивный журнал, который будет использоваться.

-S время начала
Определите начало временного окна, чтобы ограничить извлекаемые образцы, или укажите
`` естественное '' выравнивание выходных времен выборки; Ссылаться на PCPIIntro(1 г.). Смотрите также
-w опцию.

-s образцы
Аргумент образцы определяет количество семплов для записи в выходной. Если
образцы это 0 или -s не указано, pmlogextract будет пробовать до конца
Архивный журнал PCP или конец временного окна, как указано -T, что бы ни случилось
первый. -s опция переопределит -T вариант, если это произойдет раньше.

-T время окончания
Определите окончание временного окна, чтобы ограничить извлекаемые образцы или
указать `` естественное '' выравнивание выходных времен выборки; Ссылаться на PCPIIntro(1).
См. Также -w опцию.

-v объемные сэмплы
" выходной архивный журнал потенциально представляет собой многотомный набор данных, и -v вариант
Причины pmlogextract начать новый том после объемные сэмплы записи журнала были
записывается в архивный журнал.

Независимо от каких-либо -v вариант, каждый том архива ограничен не более чем
2 ^ 31 байт, поэтому pmlogextract автоматически создаст новый том для архива
до того, как будет достигнут этот предел.

-w где -S и -T указать временное окно в пределах одного дня, -w флаг вызовет
данные в пределах временного окна, которые должны быть извлечены, за каждый день в архивном журнале.
Например, варианты -w -S @11: 00 -T @15: 00 указать, что pmlogextract должен
включать записи архивного журнала только за периоды с 11:3 до XNUMX:XNUMX каждого дня.
После появления -w Используется, выходной архивный журнал будет содержать записи `` пометки '' для обозначения
временной разрыв между концом одного временного окна и началом
Далее.

-Z часовой пояс
Используйте часовой пояс при отображении даты и времени. Часовой пояс находится в формате
переменная среды TZ как описано в среда(7).

-z Используйте местный часовой пояс хоста из входных архивных журналов. По умолчанию
изначально используйте часовой пояс локального хоста.

КОНФИГУРАЦИЯ ФАЙЛОВ СИНТАКСИС

" файл конфигурации содержит интересующие метрики - только упомянутые метрики (или экземпляры)
явно или неявно в файл конфигурации будет включен в выходной архив.
Каждая спецификация должна начинаться с новой строки и может охватывать несколько строк в
конфигурационный файл. Экземпляры также могут быть указаны, но они не являются обязательными. Формат
для каждой спецификации

метрика [[экземпляр [, экземпляр ...]]]

в котором метрический может быть конечным или не конечным именем в пространстве имен показателей производительности (PMNS,
посмотреть вечерние часы(5)). Если метрика относится к нелистовому узлу в PMNS, pmlogextract предусматривает
рекурсивно спускаться по PMNS и включать все метрики, соответствующие дочернему листу
узлы.

Экземпляры не являются обязательными и могут быть указаны в виде списка из одного или нескольких пробелов (или запятых).
разделенные имена, числа или строки (заключенные в одинарные или двойные кавычки). Элементы в
список, состоящий из чисел, считается внутренними идентификаторами экземпляра - см.
pmGetInDom(3) для получения дополнительной информации. Если экземпляры не указаны, то ВСЕ экземпляры
связанные метрики будут извлечены.

Любые дополнительные пробелы игнорируются, и комментарии могут быть добавлены с префиксом «#».

КОНФИГУРАЦИЯ ФАЙЛОВ ПРИМЕР

Это пример действительного файл конфигурации:

#
# конфигурационный файл для pmlogextract
#

ядро.все.процессор
kernel.percpu.cpu.sys ["cpu0", "cpu1"]
disk.dev ["dks0d1"]

МАРК РЕКОРДЫ

Когда более одного журнала входящего архива вносят данные о производительности в выходной архив
log, затем вставляются записи `` пометки '', чтобы указать на возможное нарушение последовательности в
данные о производительности.

Запись `` метка '' содержит отметку времени и не содержит данных о производительности и используется для обозначения
что в архивном журнале PCP есть период времени, когда нам неизвестны значения любой
показатели производительности, потому что не было pmlogger(1) сбор данных о производительности во время
этот период. Поскольку эти периоды часто связаны с перезапуском службы или
пмкд(1) или системы, могут возникнуть значительные сомнения в непрерывности работы
данные за этот период времени.

Обоснование записи `` отметок '' можно продемонстрировать на примере. Рассмотрим один
входной архивный журнал, который начинается в 00:10 и заканчивается в 09:15 того же дня, а другой
входной архивный журнал, который начинается в 09:20 того же дня и заканчивается в 00:10 следующего
утро. Это было бы очень распространенным случаем для архивов, управляемых и вращаемых
pmlogger_check(1) и pmlogger_daily(1).

Выходной архивный журнал будет содержать:
00: 10.000 первая запись из первого входного журнала архива
...
09: 15.000 последняя запись из журнала первого входа архива
09: 15.001
09: 20.000 первая запись из второго входа архивный журнал
...
01: 10.000 последняя запись из журнала архива второго входа

Период времени, когда отсутствуют данные о производительности, начинается сразу после 09:15 и заканчивается.
незадолго до 09:20. Когда выходной архивный журнал обрабатывается с помощью любого из отчетов PCP
инструменты, запись `` отметка '' используется для обозначения периода отсутствия данных. Например в
архив выше, если кто-то сообщал среднюю скорость ввода-вывода с 30-минутными интервалами,
выровнены по часам, тогда будут данные для интервалов, заканчивающихся в 09:00 и 10:00.
но никаких данных за интервал, заканчивающийся в 09:30, не сообщается, поскольку он охватывает запись `` отметки ''.

Наличие отметок в журнале архива PCP можно установить с помощью
pmdumplog(1) где отметка времени и аннотация используется для обозначения `` отметки ''
записи.

METADATA ПРОВЕРКИ

Когда более одного вход указан архив, pmlogextract выполняет ряд проверок, чтобы
убедитесь, что метаданные согласованы для показателей, появляющихся более чем в одном из вход
архивы. Эти проверки включают:

* тип данных метрики тот же
* метрическая семантика такая же
* метрические единицы такие же
* метрика всегда является единственной или всегда имеет один и тот же домен экземпляра
* метрики с одинаковым именем имеют одинаковый PMID
* метрики с одинаковым PMID имеют одинаковое имя

Если какая-либо из этих проверок не удалась, pmlogextract сообщает подробности и прекращает работу без создания
выходной архив.

Чтобы решить эти семантические проблемы, используйте pmlogпереписать(1) перевести вход архивы в
эквивалентные архивы с согласованными метаданными перед использованием pmlogextract.

Используйте pmlogextract онлайн с помощью сервисов onworks.net