view xml/ru/docs/ngx_google_perftools_module.xml @ 2662:e4d370d43176

Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu. apt-key is deprecated since 2017 and will be removed after Debian 11 and Ubuntu 22.04. All distributions since at least 2013 support storing trusted keys in /etc/apt/trusted.gpg.d/ instead, so using it should be safe. A special workaround is added for Ubuntu 16.04 shipping gnupg 2.1, which is not compatible with the CLI invocation we use.
author Konstantin Pavlov <thresh@nginx.com>
date Wed, 17 Feb 2021 16:39:40 +0300
parents 16bad57a412a
children
line wrap: on
line source

<?xml version="1.0"?>

<!--
  Copyright (C) Nginx, Inc.
  -->

<!DOCTYPE module SYSTEM "../../../dtd/module.dtd">

<module name="Модуль ngx_google_perftools_module"
        link="/ru/docs/ngx_google_perftools_module.html"
        lang="ru"
        rev="1">

<section id="summary">

<para>
Модуль <literal>ngx_google_perftools_module</literal> (0.6.29) включает
поддержку профилирования рабочих процессов nginx при помощи
<link url="https://github.com/gperftools/gperftools">Google Performance Tools</link>.
Модуль предназначен для разработчиков nginx.
</para>

<para>
По умолчанию этот модуль не собирается, его сборку необходимо
разрешить с помощью конфигурационного параметра
<literal>--with-google_perftools_module</literal>.
<note>
Для сборки и работы этого модуля нужна библиотека
<link url="https://github.com/gperftools/gperftools">gperftools</link>.
</note>
</para>

</section>


<section id="example" name="Пример конфигурации">

<para>
<example>
google_perftools_profiles /path/to/profile;
</example>
Профили будут сохраняться как
<literal>/path/to/profile.&lt;worker_pid&gt;</literal>.
</para>

</section>


<section id="directives" name="Директивы">

<directive name="google_perftools_profiles">
<syntax><value>файл</value></syntax>
<default/>
<context>main</context>

<para>
Задаёт имя файла, который хранит информацию о профилировании
рабочего процесса nginx.
Идентификатор рабочего процесса всегда является частью имени файла
и добавляется в конце имени после точки.
</para>

</directive>

</section>

</module>