Устанавливает путь к сокету, посредством которого модуль общается с демоном. Параметр глобальный и не может переопределяться в виртуальных хостах и htaccess файлах. Значение по умолчанию logs/perfsocket — что означает, что сокет будет создан в директории logs Apache. Т.е там, где сервер складывает свои логи.
Не рекомендуется использовать значение по умолчанию,т.к. не на всех системах модуль будет иметь доступ к сокету послестарта и создания. Рекомендуется придерживаться инструкций и хранить сокет в отдельном катлоге /opt/performance/, созданном специально для нужд модуля.
| Название: | PerformanceSocket |
|---|---|
| Расположение в конфигурационном файле: | Global1) |
| Значение по умолчанию: | logs/perfsocket |
| Пример: | PerformanceSocket /etc/httpd/logs/perf.sock |
Флажок — On/Off. Если этот флажок установлен глобально, то ведется наблюдение за всеми виртуальными хостами. Если параметр глобально выключен, то возможно включение его в отдельных виртуальных хостах2), тогда наблюдение будет производится только за этими хостами.
| Название: | PerformanceEnabled |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost3) |
| Значение по умолчанию: | Off |
| Пример: | PerformanceEnabled On |
Фильтр хостов, за которыми производится отслеживание.Список хостов через пробел.
При наличии трех условий PerformanceHostFilter, PerformanceScript, PerformanceURI условие выполняется только при положительной проверке трех фильтров. При наличии двух — условие выполняется при положительной проверке двумя фильтрами — третий не учитывается. Если не указан ни один фильтр — статистика не ведется ни для одного сайта. Отключить учет статистики можно можно установкой параметра PerformanceEnabled Off.
| Название: | PerformanceHostFilter |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost |
| Значение по умолчанию: | Null |
| Пример: | PerformanceHostFilter example.host1.com example.host2.com … |
Регулярное выражение, дляобработки только определенных выражением URI, иными словами - фильтр отслеживаемых запросов по URI(regexp синтаксис).
| Название: | PerformanceURI |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost |
| Значение по умолчанию: | Null |
| Пример: | PerformanceURI \.html$ |
Фильтр отслеживаемых запросов по вызываемому скрипту(regexp синтаксис).
| Название: | PerformanceScript |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost |
| Значение по умолчанию: | Null |
| Пример: | PerformanceURI \.php$ |
Хендлер веб-сервера — для вывода страницы отчета модуля. Статистика по всем хостам:
| Название: | PerformanceWorkHandler |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost |
| Значение по умолчанию: | performance-status |
| Пример: | PerformanceWorkHandler performance-status |
Хендлер веб-сервера — для вывода страницы отчета модуля. Статистика по вызываемому хосту:
| Название: | PerformanceUserHandler |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost |
| Значение по умолчанию: | user-status |
| Пример: | PerformanceUserHandler user-status |
Тип логирования — Log(сохранять информацию в лог PerformanceLog, PerformanceLogFormat), SQLite — сохранение информации в SQLite базу (PerformanceDB, PerformanceHistory), MySQL — сохранение информации в базу MySQL(PerformanceDbUserName, PerformanceDBPassword, PerformanceDBName, PerformanceDBHost, PerformanceHistory), Postgres — сохранение информации в базу PostgreSQL(PerformanceDbUserName, PerformanceDBPassword, PerformanceDBName, PerformanceDBHost, PerformanceHistory).
| Название: | PerformanceLogType |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | SQLite |
| Пример: | PerformanceLogType Log |
Путь к базе данных типа - SQLite
| Название: | PerformanceDB |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | logs/perfdb |
| Пример: | PerformanceDB /etc/httpd/log/perf.db |
Имя базы данных MySQL, PostgreSQL хранящей данные:
| Название: | PerformanceDBName |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | perf_db |
| Пример: | PerformanceDBName perfdb |
Пользователь базы данных MySQL, PostgreSQL хранящей данные:
| Название: | PerformanceDbUserName |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | perf_user |
| Пример: | PerformanceDbUserName perf |
Пароль базы данных MySQL, PostgreSQL хранящей данные:
| Название: | PerformanceDBPassword |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | perf_password |
| Пример: | PerformanceDBPassword pass |
Хост базы данных MySQL, PostgreSQL хранящей данные:
| Название: | PerformanceDBHost |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | localhost |
| Пример: | PerformanceDBHost host1.com |
Путь к файлу логов, где сохраняется информация по запросам в режиме Log:
| Название: | PerformanceLog |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost |
| Значение по умолчанию: | Null |
| Пример: | PerformanceLog logs/perf.log |
Формат выводимой в лог информации в режиме Log. Служебные переменные:
| Название: | PerformanceLogFormat |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | [%DATE%] from %HOST% (%URI%) script %SCRIPT%: cpu %CPU%, memory %MEM%, execution time %EXCTIME% |
| Пример: | PerformanceLogFormat [%DATE%] from %HOST% (%URI%) script %SCRIPT%: cpu %CPU%, memory %MEM%, execution time %EXCTIME% |
Число дней хранения истории для SQLite, MySQL, Postgres.
| Название: | PerformanceHistory |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | 30 |
| Пример: | PerformanceHistory 10 |
Максимальное число запускаемых одновременно нитей(из расчета 2 нити на запрос):
| Название: | PerformanceMaxThreads |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | 100 |
| Пример: | PerformanceMaxThreads 500 |
Размер стека для создаваемого следящего потока в Мб:
| Название: | PerformanceStackSize |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | 10 |
| Пример: | PerformanceStackSize 1 |
Позволяет игнорировать redirect-handler. Если для анализируемого скрипта или сайта используется mod_rewrite. Рекомендуется установить его в On:
| Название: | PerformanceUseCanonical |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | Off |
| Пример: | PerformanceUseCanonical On |
Использовать режим контроля выполняющихся потоков (для администратора). Позволяет контролировать список обрабатываемых демоном на текущий момент скриптов. Обратная сторона использования этого режима— увеличение времени обработки демоном запросов. Не рекомендуется долгое использование этого режима. Только при крайней необходимости, например за контролем нагрузки демона:
| Название: | PerformanceExtended |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | Off |
| Пример: | PerformanceExtended Off |
Режим подсчета % CPU. Irix - 100% - это когда загружены все ядра, например 4 ядра и одно загружено на 100%, то будет отображено 25%. Solaris - 100% - это когда одно ядро загружено на 100%. Например, если 2 ядра загружены на 100%, то будет отображаться - 200%.
| Название: | PerformanceUseCPUTopMode |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | Irix |
| Пример: | PerformanceUseCPUTopMode Solaris |
On/Off - включить режим слежения за демоном(CPU usage, Memory usage, IO usage). Т.е. отслеживается потребление ресурсов самим демоном. Данные о потребляемых ресурсах выводятся в лог сервера.
[SELFCHECKPERFDATA] cpu usage %f%%, memory usage %fMb, r/w usage %f(Kb|Blocks)
| Название: | PerformanceCheckDaemon |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | Off |
| Пример: | PerformanceCheckDaemon On |
Интервал отслеживания за ресурсами потребляемыми демоном в секундах. 0 — отключен.
| Название: | PerformanceCheckDaemonInterval |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | 1200 |
| Пример: | PerformanceCheckDaemonInterval 120 |
Дополнение к режиму потребляемых демоном ресурсов. Задает границу памяти в Мб. Если демон достиг указанной границы — он перезапускается.
| Название: | PerformanceCheckDaemonMemory |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | 0 |
| Пример: | PerformanceCheckDaemonMemory 20 |
Период выполнения демона или время перезапуска демона. В общем, временной интервал через который демон перезапустится. Необходим в случае, если демон потребляет много памяти.
В формате HH:MM:SS или HH-MM-SS или ddddd.
Если задано время, то ежедневно в это время демон будет перезапущен. Если задано число, то по истечении стольких секунд — демон будет перезапущен.
| Название: | PerformanceCheckDaemonTimeExec |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | NULL |
| Пример: | PerformanceCheckDaemonTimeExec 20:00:00 |
Экспериментальный параметр для MySQL базы данных. Запускает оптимизацию базы данных модуля в указанное параметром время — ежедневно. Время указывается в формате HH:MM:SS или HH-MM-SS.
| Название: | PerformanceFragmentationTime |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | NULL |
| Пример: | PerformanceFragmentationTime 20:00:00 |
On/Off включить или выключить молчаливый режим. Молчаливый режим - не выдавать сообщения о невозможности соединения с демоном в лог сервера.
| Название: | PerformanceSilentMode |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | On |
| Пример: | PerformanceSilentMode Off |
два параметра 1) число(в 1/100 секунды), 2) HARD/SOFT - задает минимальное время выполнения скрипта и способ его сохранения HARD(не сохранять)/SOFT(сохранять с 0 %CPU)
| Название: | PerformanceMinExecTime |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | NULL |
| Пример: | PerformanceMinExecTime 10 SOFT |
Фильтр отслеживаемых запросов по вызываемому скрипту(regexp синтаксис) для таких модулей как mod_suphp и пр.
| Название: | PerformanceExternalScript |
|---|---|
| Расположение в конфигурационном файле: | Global, VirtualHost |
| Значение по умолчанию: | Null |
| Пример: | PerformanceExternalScript \.php$ |
On или Off тихий режим, когда сообщения о том, что клиентский скрипт не смог соединиться с демоном или окончить сессию не падают в лог сервера
| Название: | PerformanceSilentMode |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | On |
| Пример: | PerformanceSilentMode Off |
Данный параметр и режим введены для уменьшения нагрузки на свободное пространство сервера. Невозможность соединения с демоном или неоконченная сессия не критичны для сервера и запроса, а также статистики
Используется в виде PerformanceSocketPermType 600 PID или PerformanceSocketPermType 777 NOPID. Используется для режимов работы mod_performance+mod_fcgid+php-cgi. Устанавливает права на сокет, указанные в этом параметре, а также модификацию имени сокета. По умолчанию, имя сокета задается как PerformanceSocket+.pid процесса. А для режима mod_fcgid, php-cgi должен знать точный путь к сокету, и чтоб он не менялся, задается режим NOPID. Если необходимо омтавить станадртные права, то задается PerformanceSocketPermType 000 NOPID. Для изменения прав сокета без смены названия - PerformanceSocketPermType 755 PID
| Название: | PerformanceSocketPermType |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | 000 PID |
| Пример: | PerformanceSocketPermType 777 NOPID |
On или Off продвинутый режим слежения за CPU и IO. По умолчанию CPU usage и IO usage снимаются в начале и в конце работы отслеживаемого процесса. Но в режиме mod_performance+suphp или mod_performance+mod_cgi нет возможности отследить конец процесса. Если процесс завершился до снятия данных по нему, то статистика теряется, т.к есть начальные данные, но нет конечных. Дабы избешать этой ситуации был введен режим периодической слежки. Если он включен, то наряду с отслеживанием памяти каждые 10 мс будет отслеживаться и CPU usage и IO usage, что позволяет не потерять данные по наблюдаемому процессу. Для mod_perforamcne+mod_php или mod_perforamacne+mod_fcgid+php-cgi включать этот режим нет необходимости. Этот режим увеличивает нагрузку на дисковую подсистему, т.к. добавляет операции чтения procfs.
| Название: | PerformancePeriodicalWatch |
|---|---|
| Расположение в конфигурационном файле: | Global |
| Значение по умолчанию: | Off |
| Пример: | PerformancePeriodicalWatch On |