Text refactoring (#57)

Co-authored-by: Denis Vasilenkov <denis.vasilenkov@gmonit.ru>

Author: VasilenkovDenis

agent_installation_guide/APM/java.md

@@ -2,7 +2,6 @@
 
 Для интеграции APM-агента в Java-приложение выполните следующие шаги:
 
----
 
 ### 1. **Загрузка агента**
 1. Скачайте архив с агентом с официального сайта New Relic:
@@ -13,7 +12,7 @@
 
 2. (Опционально) Ознакомьтесь с [официальной инструкцией по установке APM-агента для Java](https://docs.newrelic.com/install/java/) для получения дополнительных подробностей.
 
----
+
 
 ### 2. **Распаковка агента**
 Распакуйте загруженный архив в предпочтительный каталог. Например:
@@ -25,7 +24,7 @@ sudo unzip newrelic-java.zip -d /opt/newrelic
 
 > **Важно:** Убедитесь, что файлы `.jar` агента **не находятся** в пути к классам или в каталогах, перечисленных в `java.endorsed.dirs`.
 
----
+
 
 ### 3. **Настройка конфигурации агента**
 Настройте файл `newrelic.yml` или используйте переменные окружения для конфигурации агента.
@@ -53,7 +52,6 @@ sudo unzip newrelic-java.zip -d /opt/newrelic
 
 > При необходимости более тонкой настройки параметров агента смотрите также официальную [документацию по конфигурации агента для Java](https://docs.newrelic.com/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file/).
 
----
 
 ### 4. **Интеграция агента с приложением**
 Добавьте флаг запуска агента в команду запуска вашего Java-приложения:
@@ -67,14 +65,11 @@ sudo unzip newrelic-java.zip -d /opt/newrelic
 java -javaagent:/opt/newrelic/newrelic.jar -jar my-app.jar
 ```
 
----
-
 ### 5. **Проверка работы агента**
 После запуска приложения убедитесь, что агент успешно подключился:
 - В логах агента (`stdout`) должно появиться сообщение об успешном подключении.
 - В интерфейсе мониторинга GMonit появятся метрики приложения.
 
----
 
 ### 6. **Подробнее**
 Для более детальной информации о конфигурации и настройке агента обратитесь к [официальной документации New Relic](https://docs.newrelic.com/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file/).
@@ -84,7 +79,6 @@ java -javaagent:/opt/newrelic/newrelic.jar -jar my-app.jar
 
 Для интеграции агента New Relic в Java-приложение, работающее в Kubernetes, выполните следующие шаги:
 
----
 
 ### Шаг 1: Загрузка и распаковка агента New Relic
 
@@ -101,7 +95,6 @@ java -javaagent:/opt/newrelic/newrelic.jar -jar my-app.jar
 
    > **Важно**: Если агент будет расположен в другом месте, убедитесь, что `.jar` файлы агента **не находятся** в директориях, указанных в `java.endorsed.dirs` или в пути к классам.
 
----
 
 ### Шаг 2: Настройка агента New Relic
 
@@ -119,7 +112,6 @@ java -javaagent:/opt/newrelic/newrelic.jar -jar my-app.jar
 
 2. Если используются самоподписанные сертификаты, убедитесь, что путь к бандлу сертификатов добавлен в настройки (см. предыдущие разделы).
 
----
 
 ### Шаг 3: Подготовка Docker-образа с агентом
 
@@ -143,7 +135,4 @@ java -javaagent:/opt/newrelic/newrelic.jar -jar my-app.jar
    kind load docker-image my-java-app-with-newrelic:latest
    ```
 
----
-
 После выполнения этих шагов ваш Docker-образ с интегрированным APM-агентом готов для развертывания в Kubernetes. Убедитесь, что поды с приложением запускаются корректно, а метрики появляются в интерфейсе GMonit.
-```

agent_installation_guide/APM/nodejs.md

@@ -2,7 +2,6 @@
 
 Для интеграции APM-агента New Relic в Node.js выполните следующие шаги:
 
----
 
 ### 1. Установка пакета New Relic
 
@@ -15,7 +14,6 @@ npm install newrelic --save
 # Через Yarn
 yarn add newrelic
 ```
----
 
 ### 2. Копирование файла конфигурации
 
@@ -25,8 +23,6 @@ yarn add newrelic
 cp ./node_modules/newrelic/newrelic.js ./<your-destination>
 ```
 
----
-
 ### 3. Настройка файла конфигурации
 
 Откройте скопированный файл `newrelic.js` и добавьте или измените следующие параметры:
@@ -39,7 +35,6 @@ exports.config = {
 };
 ```
 
----
 
 ### 4. Запуск программы с модулем агента
 
@@ -55,8 +50,6 @@ node -r newrelic your-program.js
 const newrelic = require('newrelic');
 ```
 
----
-
 ### 5. Настройка для исключения установки модуля Native Metrics
 
 В стандартной поставке включён модуль Node.js VM, который использует `gyp` и требует установленного Python для сборки бинарных файлов. Если Python отсутствует на хосте, вы можете исключить установку модуля Native Metrics, определив переменную окружения:
@@ -67,7 +60,6 @@ export NR_NATIVE_METRICS_NO_DOWNLOAD=true
 
 Подробнее о Node.js VM и связанных измерениях можно найти в [документации New Relic](https://docs.newrelic.com/docs/apm/agents/nodejs-agent/extend-your-instrumentation/nodejs-vm-measurements/)
 
----
 
 ### Подробнее
 

agent_installation_guide/APM/php.md

@@ -6,7 +6,6 @@
 
 Ниже собрана полная инструкция по установке и настройке данного агента в различных окружениях (Ubuntu/Debian, CentOS, контейнерные среды). Если требуется дополнительная информация, обращайтесь к [официальной документации](https://docs.newrelic.com/docs/apm/agents/php-agent/installation/php-agent-installation-overview).
 
----
 
 ### Обязательные настройки агента
 
@@ -27,7 +26,6 @@ newrelic.logfile = stdout #Логирование агента в stdout
 > export NEW_RELIC_LOG=stdout #Логирование агента в stdout
 > ```
 
----
 
 ### 1. Установка агента New Relic для PHP на Ubuntu и Debian
 
@@ -69,7 +67,6 @@ newrelic.logfile = stdout #Логирование агента в stdout
 6. **Проверка работы**  
    Сгенерируйте трафик к вашему приложению и проверьте метрики в интерфейсе GMonit.
 
----
 
 ### 2. Установка агента New Relic для PHP на CentOS
 
@@ -103,7 +100,6 @@ newrelic.logfile = stdout #Логирование агента в stdout
 6. **Проверка работы**  
    Сгенерируйте трафик к вашему приложению и проверьте метрики в интерфейсе GMonit.
 
----
 
 ### 3. Установка агента New Relic для PHP в контейнерных средах (Docker и др.)
 
@@ -147,7 +143,6 @@ newrelic.logfile = stdout #Логирование агента в stdout
 4. **Проверка работы**  
    Сгенерируйте трафик к вашему приложению и проверьте метрики в интерфейсе GMonit.
 
----
 
 ### Дополнительная информация
 
@@ -156,7 +151,6 @@ newrelic.logfile = stdout #Логирование агента в stdout
 
 - Если требуются более тонкие настройки агента и прокси-демона (`newrelic-daemon`), в том числе указание кастомного `cafile`, использование дополнительных сетевых параметров и т. д., обратитесь к [разделу конфигурации демона](https://docs.newrelic.com/docs/apm/agents/php-agent/configuration/proxy-daemon-newreliccfg-settings/#proxy-settings).
 
----
 
 # Добавление кастомного параметра
 
@@ -198,7 +192,6 @@ newrelic_add_custom_parameter(string $key, scalar $value)
 
 Для правильной идентификации и отслеживания транзакций в мониторинге вы можете задавать имена транзакций с помощью функции `newrelic_name_transaction`. Это позволяет организовать мониторинг и избежать избыточного числа уникальных имён транзакций, которые могут затруднить анализ данных.
 
----
 
 #### Пример: Задание имени транзакции для `Uri/index.php`
 
@@ -225,7 +218,6 @@ function example() {
 
 Подробности можно найти в официальной документации [New Relic](https://docs.newrelic.com/docs/apm/agents/php-agent/php-agent-api/newrelic_name_transaction/)
 
----
 
 ### Пример: Добавление имени транзакции для конкретного URI
 

agent_installation_guide/APM/python.md

@@ -2,7 +2,6 @@
 
 Для установки и настройки Python-агента New Relic в Django выполните следующие шаги:
 
----
 
 ### 1. Установка пакета New Relic
 
@@ -12,13 +11,11 @@
 pip install newrelic
 ```
 
----
 
 ### 2. Настройка агента
 
 Для начала работы агенту Python необходимы базовые настройки. Их можно задать двумя способами: через конфигурационный файл или переменные окружения.
 
----
 
 #### Способ 1: Использование конфигурационного файла
 
@@ -36,7 +33,6 @@ pip install newrelic
    app_name = "MY_AWESOME_APP" # Название приложения
    ```
 
----
 
 #### Способ 2: Использование переменных окружения
 
@@ -48,19 +44,16 @@ NEW_RELIC_HOST=gmonit-collector.<DOMAIN>.ru # Домен коллектора
 NEW_RELIC_APP_NAME="MY_AWESOME_APP" # Название приложения
 ```
 
----
 
 ### Подробнее
 
 Для более детальной информации о конфигурации агента обратитесь к [официальной документации New Relic](https://docs.newrelic.com/install/python/).
 
----
 
 # Установка Python-агента для FastAPI
 
 Для установки и настройки Python-агента New Relic в FastAPI выполните следующие шаги:
 
----
 
 ### 1. Установка пакета New Relic
 
@@ -70,13 +63,11 @@ NEW_RELIC_APP_NAME="MY_AWESOME_APP" # Название приложения
 pip install newrelic
 ```
 
----
 
 ### 2. Настройка агента
 
 Агенту Python необходимы базовые настройки. Их можно задать через конфигурационный файл или переменные окружения.
 
----
 
 #### Способ 1: Использование конфигурационного файла
 
@@ -94,7 +85,6 @@ pip install newrelic
    app_name = "MY_FAST_API_APP" # Название приложения
    ```
 
----
 
 #### Способ 2: Использование переменных окружения
 
@@ -106,7 +96,6 @@ NEW_RELIC_HOST=gmonit-collector.<DOMAIN>.ru # Домен коллектора
 NEW_RELIC_APP_NAME= "MY_FAST_API_APP" # Название приложения
 ```
 
----
 
 ### 3. Интеграция агента с FastAPI
 
@@ -122,7 +111,6 @@ newrelic-admin run-program uvicorn main:app --host 0.0.0.0 --port 8000
 - **`--host 0.0.0.0`** — слушать на всех интерфейсах.
 - **`--port 8000`** — порт, на котором будет доступно ваше приложение.
 
----
 
 #### Пример запуска приложения с Gunicorn:
 
@@ -133,7 +121,6 @@ newrelic-admin run-program gunicorn main:app -w 4 -k uvicorn.workers.UvicornWork
 - **`-w 4`** — количество рабочих процессов.
 - **`-k uvicorn.workers.UvicornWorker`** — использование `UvicornWorker` для асинхронной обработки.
 
----
 
 ### Подробнее