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

ПРОГРАММА:

ИМЯ

pmlogger - создать архивный журнал для показателей производительности

СИНТАКСИС

pmlogger [-c файл конфигурации] [-h кашель] [-K спецификация] [-l журнальный файл] [-L] [-m в своих размышлениях] [-n pmnsfile]
[-o] [-p ПИД-регулятор] [-P] [-r] [-s конец] [-t интервал] [-T время окончания] [-u] [-U username] [-v
размер] [-V версия] [-x fd] [-y] архив

ОПИСАНИЕ

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

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

The -V Опция указывает версию создаваемого архива. По умолчанию
создается архив версии 2, и единственное значение, поддерживаемое в настоящее время для версия это 2.

Если не направлено другому хосту -h вариант или при прямом использовании PMDA через -o
вариант, pmlogger свяжется с демоном сборщика показателей производительности (PMCD) на локальном
host и использовать его как источник регистрируемых значений метрики.

Для обеспечения необходимой гибкости и контроля над тем, что и когда регистрируется, pmlogger
поддерживает независимое двухуровневое состояние ведения журнала для каждого экземпляра каждого выступления
метрическая. На первом (обязательном) уровне допускается ведение журнала. on (с ассоциированным
интервал между выборками), или от or может быть. В последнем случае второй (рекомендательный)
уровень ведения журнала может быть on (с соответствующим интервалом между выборками), или от.

Обязательный уровень позволяет универсально указать, что некоторые показатели должны регистрироваться, или
обязательно быть зарегистрированным. Состояние по умолчанию для всех экземпляров всех показателей, когда pmlogger
запускается обязательно может быть и рекомендательный выкл.

Используйте пмлк(1) один раз опросить и изменить состояние регистрации pmlogger бежит.

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

Это невозможно для pmlogger для регистрации определенных экземпляров метрики и всех экземпляров
одна и та же метрика одновременно. Если регистрируются определенные экземпляры и запрос на регистрацию
все экземпляры созданы, тогда все экземпляры метрики будут регистрироваться в соответствии с
новый запрос, заменяющий любой предыдущий запрос на ведение журнала для метрики. Запрос на регистрацию всего
экземпляры метрики заменят любой предыдущий запрос на регистрацию всех экземпляров. Запрос
для регистрации определенных экземпляров метрики, когда все экземпляры уже зарегистрированы,
отказался. Для этого необходимо сначала отключить ведение журнала для всех экземпляров метрики. В
в каждом случае сначала проверяется действительность запроса; например, просьба изменить
состояние ведения журнала метрики для рекомендаций, когда оно в настоящее время является обязательным, выключено никогда
разрешено (сначала необходимо изменить состояние на обязательное).

По желанию каждая запущенная система пмкд(1) также может быть настроен для запуска `` основного ''
pmlogger пример. Этот pmlogger экземпляр запущен $ PCP_RC_DIR / pmlogger, И
затронутые файлами $ PCP_SYSCONF_DIR / pmlogger / элемент управления,
$ PCP_SYSCONF_DIR / pmlogger / элемент управления.d (используйте chkconfig(8) или аналогичные для конкретной платформы
команды для активации или отключения основного pmlogger пример),
$ PCP_SYSCONFIG_DIR / pmlogger (настройки переменных среды для основного pmlogger)
$ PCP_SYSCONF_DIR / pmlogger / pmlogger.options (параметры командной строки переданы основному
pmlogger) и расширение $ PCP_VAR_LIB / config / pmlogger / config.default (начальное значение по умолчанию
файл конфигурации для основного pmlogger).

Главная pmlogger экземпляр идентифицируется -P вариант. Может быть не более одного
`` первичный '' pmlogger экземпляр в каждой системе. Главная pmlogger экземпляр (если есть) должен
работать на том же хосте, что и пмкд(1) к которому он подключается (если есть), поэтому -h и -P
варианты являются взаимоисключающими.

Регистрация некоторых показателей возможна даже при отсутствии локального пмкд(1), используя
режим работы "локальный контекст". Это активируется с помощью -o вариант и причины
pmlogger использовать местные DSO PMDA вместо связи с пмкд(1). когда
работая с локальным контекстом, -K опция может использоваться для управления DSO PMDA, которые
должны быть доступны. В спецификация аргумент соответствует синтаксису, описанному в
__pmSpecLocalPMDA(3). Больше одного -K опция может быть использована.

При запуске в качестве неосновного экземпляра pmlogger немедленно выйдет, если
файл конфигурации не позволяет планировать регистрацию метрики. В -L опция отменяет это
поведение и вызывает неосновное pmlogger экземпляр, чтобы `` задержаться '', предположительно ожидающий
некоторая будущая динамическая реконфигурация и изменение состояния через пмлк(1). pmlogger будет также
задерживаться без -L опция используется, если все регистрируемые метрики регистрируются как один раз
только метрики. Когда будут зарегистрированы только единожды метрики, появится предупреждающее сообщение.
сгенерировано с указанием, что очередь событий пуста и больше никаких событий не планируется.

По умолчанию все диагностики и ошибки из pmlogger записываются в файл pmlogger.log
в каталоге, где pmlogger запущен. В -l опция может использоваться для отмены
поведение по умолчанию. Если файл журнала не может быть создан или недоступен для записи, вывод записывается
вместо этого к стандартной ошибке.

Если указано, -s вариант инструктирует pmlogger прекратить после определенного размера в
записей, байтов или единиц времени. Если конец является целым числом, тогда конец
записи будут записаны в журнал. Если конец целое число с суффиксом b or байт тогда
конец байты архивных данных будут записаны (обратите внимание, что архивный журнал
границы записи не будут нарушены, поэтому этот предел может быть немного превышен). Другой
Возможные единицы размера файла включают: K, Kb, Кбайт, килобайт для килобайт и M, Mb, мегабайт,
мегабайт за мегабайты и G, Gb, Гбайт, гигабайт за гигабайты. Эти единицы могут быть
необязательно с суффиксом s и может иметь смешанный случай. Альтернативно конец может быть
целое число или число с плавающей запятой с суффиксом с использованием единицы времени, как описано в PCPIIntro(1)
для интервал аргумент (к стандартному PCP -t параметр командной строки).
Некоторые примеры разных форматов:
-s 100
-s 100 байтов
-s 100K
-s 100Mb
-s 10 Гбайт
-s 10mins
-s 1.5hours
По умолчанию pmlogger бежать вечно.

The -r параметр определяет размер физических записей для каждой группы показателей и
ожидаемый вклад группы в размер архива PCP за один полный день
коллекцию, которую нужно сообщить в файле журнала. Эта информация сообщается впервые.
каждая группа успешно записана в архив.

The -U опция указывает учетную запись пользователя, под которой запускается pmlogger. По умолчанию
текущая учетная запись пользователя для интерактивного использования. При запуске в качестве демона непривилегированный "pcp"
учетная запись используется в текущих версиях PCP, но в более старых версиях учетная запись суперпользователя
("root") использовался по умолчанию.

Файл журнала потенциально представляет собой многотомный набор данных, и -v Вариант причины pmlogger в
начать новый том после того, как определенный размер в записях, байтах или единицах времени был
накоплено для текущего объема. Формат этой спецификации размера идентичен
это из -s вариант (см. выше). По умолчанию pmlogger создать единый том
бревно. Дополнительные переключатели громкости также можно принудительно активировать асинхронно, используя пмлк(1)
или отправка pmlogger сигнал SIGHUP (см. ниже). Обратите внимание: если запланированный переключатель громкости находится в
операция из-за -v вариант, то его счетчики будут сброшены после асинхронного
переключатель.

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

Обычная стоимость pmlogger работает с распределенным пространством имен показателей производительности (PMNS),
однако если -n указана опция, альтернативный локальный PMNS загружается из файла
pmnsfile.

При нормальных обстоятельствах, pmlogger будет работать вечно (кроме -s вариант или
сигнал завершения). В -T опция может использоваться для ограничения времени выполнения с помощью
формат времени, как предписано PCPIIntro(1). Время интерпретируется в пределах часового пояса
сервера PMCD, если только -y дается опция, в этом случае часовой пояс в этом
используется хост регистратора.
Некоторые примеры разных форматов:
-T 10mins
-T '@ 11:30 '
Из этого видно, что -T 10mins и -s 10mins выполнять идентичные действия.

В качестве альтернативы, pmlogger время выполнения может быть ограничено временем жизни другого процесса с помощью
-p or --ПИД возможность назначить PID интересующего процесса. В этом случае
pmlogger выйдет, когда другой процесс больше не существует.

После появления pmlogger получает сигнал SIGHUP, текущий том журнала закрывается и новый
том открыт. Этот механизм (или альтернативный механизм через пмлк(1)) можно использовать
для управления ростом файлов журнала - после закрытия тома журнала этот файл может быть
заархивированы без вреда для продолжения работы pmlogger, См. Также -v
вариант выше.

Исторически буферы для текущего журнала могут быть сброшены на диск с помощью промывать
командование пмлк(1), или отправив pmlogger сигнал SIGUSR1 или с помощью -u опцию.
Текущая версия pmlogger и libpcp рутины, лежащие в основе pmlogger
безоговорочно использовать небуферизованную запись и один FWRITE(3) для каждой логической записи
записаны, и поэтому `` очистка '' не приводит к необходимости записи дополнительных данных в файл
система. -u опция, обработка SIGUSR1 и пмлк(1) промывать команда сохранена
для обратной совместимости.

При запуске с -x опция, pmlogger будет принимать запросы асинхронного управления на
дескриптор файла fd. Предполагается, что эта опция будет использоваться только PCP внутри компании.
приложения, поддерживающие `` режим записи в реальном времени ''.

The -m опция позволяет строку в своих размышлениях быть добавленным к файлу карты для этого экземпляра
pmlogger в $ PCP_TMP_DIR / pmlogger каталог. В настоящее время используется для внутренних целей
задокументируйте файловый дескриптор (fd) когда -x используется опция, или чтобы указать, что это
pmlogger экземпляр был запущен под управлением pmlogger_check(1).

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

Файл конфигурации может быть указан с -c вариант. Если это не так, конфигурация
спецификации считываются со стандартного ввода.

If файл конфигурации не существует, то поиск производится в каталоге
$ PCP_VAR_LIB / config / pmlogger для файла с тем же именем, и если он обнаружен, этот файл используется,
например, если config.mumble не существует в текущем каталоге и файл
$ PCP_VAR_LIB / config / pmlogger / config.mumble действительно существует, тогда -c config.mumble и -c
$ PCP_VAR_LIB / config / pmlogger / config.mumble эквивалентны.

Синтаксис файла конфигурации следующий.

1. Слова разделяются пробелом (пробел, табуляция или новая строка).

2. Символ «#» (решетка) вводит комментарий, а весь текст до следующей новой строки
игнорируются.

3. Ключевые слова (показаны в булавка ниже) должно быть написано буквально (то есть строчными буквами).

4. Каждая спецификация начинается с необязательного ключевого слова. журнал, за которым следует один из
утверждает обязательный on, обязательный от, обязательный может быть, консультативный on or консультативный от.

5. Для on состояния, интервал регистрации должен следовать с использованием синтаксиса ``консолидировать'', или
``по умолчанию'' или ''каждую N единицы времени'' или просто ``N единицы времени'' - N беззнаковый
целое число и единицы времени одно из ключевых слов мс, миллисекунды, сек, второй, мин,
минут, час или форма множественного числа одного из вышеперечисленных.
Внутренние ограничения требуют, чтобы интервал был меньше (приблизительно) 74
часы. Нулевое значение интервала является синонимом консолидировать. Интервал по умолчанию
означает использовать интервал регистрации по умолчанию, равный 60 секундам; это значение по умолчанию может быть
изменился на интервал с -t командной строки.

The интервал аргумент следует синтаксису, описанному в PCPIIntro(1), а в
простейшей формой может быть целое число без знака (подразумеваемые единицы в этом случае
секунд).

6. После спецификации состояния и возможных интервалов идет знак "{", за которым следует
список из одной или нескольких характеристик метрики и закрывающего символа "}". Список белый
через пробел (или запятую). Если в списке есть только одна метрическая спецификация,
фигурные скобки не являются обязательными.

7. Спецификация метрики состоит из названия метрики, за которым может следовать набор
имена экземпляров. Название метрики соответствует стандартным соглашениям об именах PCP, см.
вечерние часы(5), и если имя метрики не является листовым узлом в PMNS (см. вечерние часы(5)), то
pmlogger будет рекурсивно спускаться по PMNS и применять спецификацию ведения журнала ко всем
имена потомков метрик, которые являются конечными узлами в PMNS. Набор имен экземпляров
представляет собой символ "[", за которым следует список из одного или нескольких имен, разделенных пробелами (или запятыми),
числа или строки и закрывающий символ "]". Числовые элементы в списке
предполагается, что это внутренние идентификаторы экземпляра, другие элементы считаются
идентификаторы внешних экземпляров - см. pmGetInDom(3) для получения дополнительной информации.

Если экземпляры не указаны, то спецификация ведения журнала применяется ко всем экземплярам.
связанной метрики.

8. Может быть произвольное количество спецификаций регистрации.

9. В соответствии со всеми спецификациями ведения журнала может быть дополнительный контроль доступа.
раздел, введенный буквальным токеном [доступ]. После этого идет контроль доступа
правила, разрешающие или запрещающие операции с определенных хостов или групп хостов.

Операции могут использоваться для опроса или управления работающим pmlogger через пмлк(1)
и попадают в следующие классы:

спрашивать допросить статус pmlogger и показатели, которые он регистрирует
консультативный Измените консультативный журнал.
обязательный Измените обязательное ведение журнала.
ВСЕ Все вышеперечисленное.

Правила контроля доступа имеют вид ''позволять список хостов : список операций ;'' а также
``Disallow список хостов : список операций ;''.

The список хостов следует синтаксису и семантике используемых механизмов контроля доступа
PMCD и полностью задокументированы в пмкд(1). список операций через запятую
список операций консультативный, обязательный, спрашивать и ВСЕ.

Пропавший без вести [доступ] раздел разрешает любой доступ и эквивалентен позволять * : все;.

Конфигурация (либо со стандартного ввода, либо файл конфигурации) изначально сканируется
pmcpp(1) с опциями -рс и -I $ PCP_VAR_LIB / config / pmlogger. Это расширяет
синтаксис файла конфигурации с включенной обработкой файла (%включают), обычное место для
поиск включаемых файлов ($ PCP_VAR_LIB / config / pmlogger), макроопределения (%определять),
расширение макроса (%имя и %{имя}) и условное включение строк (% ifdef имя ...
%еще ... % endif и % ifndef имя ... %еще ... % endif).

ПРИМЕРЫ

Для каждой утилиты PCP есть образец pmlogger файл конфигурации, который можно использовать для
создать архивный журнал, подходящий для воспроизведения с помощью этого инструмента (т.е. включает все
показатели производительности, используемые инструментом). Для инструмента с именем Foo этот файл конфигурации
находится в $ PCP_VAR_LIB / config / pmlogger / config.foo.

Ниже приведен простой файл конфигурации по умолчанию для основного pmlogger экземпляр, и
демонстрирует большинство возможностей языка спецификации конфигурации.

входить обязательно один раз {hinv.ncpu hinv.ndisk}
входить обязательно каждые 10 минут {
диск.all.write
диск.все.читать
network.interface.in.packets ["et0"]
network.interface.out.packets ["et0"]
nfs.server.reqs ["поиск" "getattr" "чтение" "запись"]
}

журнал каждые 30 минут {
Environment.temp
pmcd.pdu_in.total
pmcd.pdu_out.total
}

% включают "macros.default"

% ifdef% disk_detail
регистрировать обязательно на% disk_detail_freq {
диск.dev
}
% endif

[доступ]
disallow *: все, кроме запроса;
разрешить localhost: обязательный, рекомендательный;

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