pmlogger - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

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

СИНТАКСИС

pmlogger [-c конфігураційний файл] [-h господар] [-K spec] [-l файл журналу] [-L] [-m увагу] [-n файл pmns]
[-o] [-p ПІД] [-P] [-r] [-s кінцевий розмір] [-t інтервал] [-T час закінчення] [-u] [-U ім'я користувача] [-v
volsize] [-V версія] [-x fd] [-y] архів

ОПИС

pmlogger створює архівні журнали значень показників продуктивності, які можна "відтворити"
іншим льотчиком по продуктивності (див PCPIntro(1)) інструменти. Ці колоди становлять основу
Парадигма відеомагнітофону та сервіси ретроспективного аналізу продуктивності, загальні для інструментарію PCP.

Обов'язковий аргумент архів є базовим ім'ям для фізичних файлів, які становлять файл
журнал архіву.

Команда -V Параметр визначає версію створеного архіву. За замовчуванням a
Архів версії 2 створено, і це єдине значення, яке зараз підтримується версія є 2.

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

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

Обов'язковий рівень дозволяє універсальну специфікацію, що деякі метрики повинні бути записані, або
повинен НЕ зареєструватися. Стан за замовчуванням для всіх екземплярів усіх показників при pmlogger
запуски є обов'язковими, можливо, і рекомендаційними.

Скористайтесь pmlc(1) один раз запитати та змінити стан реєстрації pmlogger біжить.

Якщо стан показника є обов’язковим (увімкнено чи вимкнено) і надходить запит на його зміну
обов'язковий, можливо, новий стан є обов'язковим, можливо, і консультативним вимкненим. Якщо стан метрики
вже є рекомендаційним (увімкнено або вимкнено), і надходить запит змінити його на обов’язковий, можливо,
поточний стан зберігається.

Це неможливо для pmlogger для реєстрації окремих екземплярів метрики та всіх екземплярів
той самий показник одночасно. Якщо реєструються певні екземпляри та запит на реєстрацію
створено всі екземпляри, тоді всі екземпляри метрики будуть зареєстровані відповідно до
новий запит, замінюючи будь-який попередній запит на реєстрацію для метрики. Запит на реєстрацію всіх
екземпляри метрики замінять будь-який попередній запит на реєстрацію всіх екземплярів. Запит
реєструвати окремі екземпляри метрики, коли всі екземпляри вже реєструються
відмовився. Для цього потрібно спочатку вимкнути журналювання для всіх екземплярів метрики. в
у кожному випадку спочатку перевіряється обґрунтованість запиту; наприклад, запит на зміну a
стан журналу метрики до рекомендацій, коли він наразі є обов’язковим вимкненням, ніколи
дозволено (потрібно спочатку змінити стан на обов'язковий, можливо).

За бажанням, кожна система працює pmcd(1) також можна налаштувати на запуск "основного"
pmlogger екземпляр. Це pmlogger екземпляр запускається за допомогою $PCP_RC_DIR/pmlogger, І
на які вплинули файли $PCP_SYSCONF_DIR/pmlogger/control,
$PCP_SYSCONF_DIR/pmlogger/control.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 екземпляр (якщо є) повинен
працювати на тому ж хості, що й файл pmcd(1), до якого він з’єднується (якщо є), тож -h та -P
варіанти є взаємовиключними.

Реєстрація деяких метрик можлива навіть за відсутності локального pmcd(1), використовуючи
режим роботи «локальний контекст». Це активується за допомогою -o варіант і причини
pmlogger використовувати локальні DSO PMDA замість спілкування з ними pmcd(1). Коли
діючи з використанням локального контексту -K Опція може використовуватися для керування DSO PMDA, які
має бути доступним. The spec аргумент відповідає синтаксису, описаному в
__pmSpecLocalPMDA(3). Більше одного -K може бути використаний варіант.

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

За замовчуванням вся діагностика та помилки від pmlogger записуються у файл pmlogger.log
в каталозі де pmlogger запускається. The -l параметр може використовуватися для заміни
поведінка за замовчуванням. Якщо файл журналу неможливо створити або він недоступний для запису, запис записується
замість стандартної помилки.

Якщо вказано, то -s опція інструктує pmlogger закінчуватися після певного розміру в
записів, байтів або одиниць часу накопичено. Якщо кінцевий розмір тоді є цілим числом кінцевий розмір
записи будуть записані в журнал. Якщо кінцевий розмір є цілим числом із суфіксом b or bytes потім
кінцевий розмір будуть записані байти архівних даних (однак зверніть увагу, що журнал архіву
межі рекордів не будуть порушені, тому ця межа може бути трохи перевищена). Інший
життєздатні одиниці розміру файлу включають: K, Kb, Кбайт, кілобайт за кілобайти і M, Mb, Мбайт,
мегабайт за мегабайти і G, Gb, Гбайт, гігабайт за гігабайти. Ці одиниці можуть бути
необов’язково суфіксом an s і може бути змішаного випадку. Як варіант кінцевий розмір може бути
ціле число або число з плаваючою комою із суфіксом із використанням одиниці часу, як описано в п PCPIntro(1)
для інтервал аргумент (до стандартного PCP -t параметр командного рядка).
Кілька прикладів різних форматів:
-s 100
-s 100байт
-s 100K
-s 100Mb
-s 10 Гбайт
-s 10 хв
-s 1.5hours
За замовчуванням призначено для pmlogger бігти вічно.

Команда -r Параметр визначає розмір фізичного запису(ів) для кожної групи показників і
очікуваний внесок групи до розміру архіву PCP за один повний день
колекція, яка буде повідомлена у файлі журналу. Ця інформація повідомляється вперше
кожна група успішно записана в архів.

Команда -U Параметр визначає обліковий запис користувача, під яким запускати pmlogger. За замовчуванням є
поточний обліковий запис користувача для інтерактивного використання. При запуску як демон непривілейований "pcp"
обліковий запис використовується в поточних версіях PCP, але в старих версіях обліковий запис суперкористувача
("root") використовувався за замовчуванням.

Файл журналу потенційно є багатотомним набором даних, і -v варіант причин pmlogger до
розпочати новий том після певного розміру в записах, байтах або одиницях часу
накопичений для поточного обсягу. Формат цієї специфікації розміру ідентичний
що з -s варіант (див. вище). За замовчуванням призначено для pmlogger щоб створити єдиний том
журнал. Додаткові перемикачі гучності також можуть бути примусово асинхронними за допомогою будь-якого з них pmlc(1)
або відправлення pmlogger сигнал SIGHUP (див. нижче). Зверніть увагу, якщо ввімкнено запланований перемикач гучності
операція через -v параметр, то його лічильники будуть скинуті після асинхронного
перемикач.

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

Зазвичай pmlogger працює в розподіленому просторі імен показників продуктивності (PMNS),
однак, якщо -n вказано параметр альтернативний локальний PMNS завантажується з файлу
pmns-файл.

При нормальних обставинах, pmlogger працюватиме вічно (крім a -s варіант або а
сигнал припинення). The -T Опція може бути використана для обмеження часу виконання за допомогою
формат часу, визначений ст PCPIntro(1). Час інтерпретується в межах часового поясу
сервера PMCD, якщо не -y надається параметр, у цьому випадку часовий пояс у цьому
використовується хост журналу.
Кілька прикладів різних форматів:
-T 10 хв
-T '@ 11:30
З цього видно, що -T 10 хв та -s 10 хв виконувати ідентичні дії.

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

Коли pmlogger отримує сигнал SIGHUP, поточний том журналу закривається, а новий
том відкривається. Цей механізм (або альтернативний механізм через pmlc(1)) можна використовувати
щоб керувати зростанням файлів журналів - як тільки том журналу закрито, цей файл може бути
заархівовано без негативного впливу на подальшу роботу pmlogger. Див. Також -v
варіант вище.

Історично буфери для поточного журналу можуть бути скинуті на диск за допомогою врівень
командування pmlc(1), або надіславши pmlogger сигналом SIGUSR1 або за допомогою -u варіант.
Поточна версія pmlogger і libpcp рутини, які лежать в основі pmlogger
беззастережно використовувати небуферизовані записи та одиночний запис fwrite(3) для кожного логічного запису
записується, тому ``змивання'' не змушує записувати у файл додаткові дані
система The -u опція, обробка SIGUSR1 і pmlc(1) врівень команда зберігається
для зворотної сумісності.

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

Команда -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 параметр командного рядка.

Команда інтервал аргумент відповідає синтаксису, описаному в PCPIntro(1), а в
Найпростішою формою може бути ціле число без знака (в даному випадку маються на увазі одиниці
секунд).

6. Після стану та можливих специфікацій інтервалу йде ``{'', за яким слід a
список з однієї чи кількох специфікацій метрики та завершуючого ``}''. Список білий
через пробіл (або кому). Якщо в списку є лише одна специфікація показника,
брекети є необов'язковими.

7. Специфікація метрики складається з назви метрики, за якими необов'язково слідує набір
назви екземплярів. Ім’я метрики відповідає стандартним конвенціям щодо іменування PCP, див
pmns(5), і якщо ім’я метрики є нелистовим вузлом у PMNS (див pmns(5)), то
pmlogger буде рекурсивно спускатися до PMNS і застосовувати специфікацію журналу до всіх
нащадкові назви показників, які є листовими вузлами в PMNS. Набір імен екземплярів
є ``['', за яким слідує список з одного або кількох імен, розділених пробілом (або комою),
числа або рядки, а також закриваючий ``]''. Елементи в списку, які є числами
вважаються внутрішніми ідентифікаторами екземплярів, інші елементи вважаються такими
зовнішні ідентифікатори екземплярів - див pmGetInDom(3) для отримання додаткової інформації.

Якщо екземпляри не вказані, то специфікація ведення журналу застосовується до всіх екземплярів
відповідної метрики.

8. Може бути довільна кількість специфікацій журналу.

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

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

запитати запитати статус pmlogger і метрики, які він реєструє
консультативний Змінити рекомендаційний журнал.
обов'язковий Змінити обов'язкову реєстрацію.
всі Все вищеперераховане.

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

Команда список хостів дотримується синтаксису та семантики використовуваних механізмів контролю доступу
PMCD і повністю задокументовані в pmcd(1). Ан список операцій відокремлюється комою
перелік операцій консультативний, обов'язковий, запитати та всі.

Зниклий [доступ] розділ надає повний доступ і еквівалентний дозволяти * : всі;.

Конфігурація (або зі стандартного введення, або конфігураційний файл) спочатку сканується
pmcpp(1) з параметрами -rs та -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 хвилин {
disk.all.write
disk.all.read
network.interface.in.packets [ "et0" ]
network.interface.out.packets [ "et0" ]
nfs.server.reqs [ "шукати" "getattr" "читати" "записувати" ]
}

реєструвати рекомендації кожні 30 хвилин {
оточення.тем
pmcd.pdu_in.total
pmcd.pdu_out.total
}

%include "macros.default"

%ifdef %disk_detail
обов'язковий журнал на %disk_detail_freq {
disk.dev
}
%endif

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

Використовуйте pmlogger онлайн за допомогою служб onworks.net