Skip to content

Commit b073f1a

Browse files
VasilenkovDenisDenis Vasilenkov
VasilenkovDenis
and
Denis Vasilenkov
authored
Installation instructions (#61)
Co-authored-by: Denis Vasilenkov <denis.vasilenkov@gmonit.ru>
1 parent 04b9fc5 commit b073f1a

4 files changed

Lines changed: 241 additions & 0 deletions

File tree

‎_sidebar.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@
1414
- [MySQL](agent_installation_guide/Infra/database_monitoring/mysql_agents_install.md)
1515
- [PostgreSQL](agent_installation_guide/Infra/database_monitoring/postgresql_agents_install.md)
1616
- [Oracle Database](agent_installation_guide/Infra/database_monitoring/oracle_database.md)
17+
- [Nginx](agent_installation_guide/Infra/database_monitoring/nginx_agents_install.md)
18+
- [RabbitMQ](agent_installation_guide/Infra/database_monitoring/rabbitmq_agents_install.md)
19+
- [Redis](agent_installation_guide/Infra/database_monitoring/redis_agents_install.md)
1720
- [Мониторинг браузера (web)](agent_installation_guide/RUM/real_user_monitoring.md)
1821
- [Мобильный мониторинг](agent_installation_guide/Mobile/mobile_monitoring.md)
1922
- Модули GMonit

‎agent_installation_guide/Infra/database_monitoring/nginx_agents_install.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# Мониторинг Nginx с использованием New Relic
2+
3+
Для настройки мониторинга Nginx выполните следующие шаги:
4+
5+
6+
### Шаг 1: Установка интеграции Nginx
7+
8+
1. **Установите пакет интеграции Nginx**:
9+
10+
Для Ubuntu/Debian выполните:
11+
```bash
12+
sudo apt-get update
13+
sudo apt-get install nri-nginx
14+
```
15+
16+
2. **Создайте файл конфигурации**:
17+
Добавьте файл `/etc/newrelic-infra/integrations.d/nginx-config.yml` с содержимым:
18+
```yaml
19+
integrations:
20+
- name: nri-nginx
21+
env:
22+
STATUS_URL: http://127.0.0.1/nginx_status
23+
METRICS: 1
24+
INVENTORY: 1
25+
EVENTS: 1
26+
labels:
27+
env: production
28+
role: nginx
29+
```
30+
31+
32+
### Шаг 2: Настройка Nginx для включения модуля статуса
33+
34+
1. Убедитесь, что в конфигурации Nginx (`nginx.conf`) включён модуль статуса. Добавьте следующий блок:
35+
```nginx
36+
location /nginx_status {
37+
stub_status on;
38+
access_log off;
39+
allow 127.0.0.1;
40+
deny all;
41+
}
42+
```
43+
44+
2. Перезагрузите Nginx, чтобы применить изменения:
45+
```bash
46+
sudo systemctl reload nginx
47+
```
48+
49+
50+
### Шаг 3: Перезапуск инфраструктурного агента
51+
52+
После настройки интеграции перезапустите агент:
53+
```bash
54+
sudo systemctl restart newrelic-infra
55+
```
56+
57+
58+
### Дополнительно
59+
60+
- Для получения дополнительной информации, включая расширенные настройки и устранение неполадок, обратитесь к [официальной документации New Relic по интеграции Nginx](https://docs.newrelic.com/install/nginx/).

‎agent_installation_guide/Infra/database_monitoring/rabbitmq_agents_install.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# Мониторинг RabbitMQ с использованием New Relic
2+
3+
Для настройки мониторинга RabbitMQ выполните следующие шаги:
4+
5+
6+
### Предварительные действия
7+
8+
1. Убедитесь, что установлен и настроен плагин [RabbitMQ Management](https://www.rabbitmq.com/management.html). Этот плагин обеспечивает доступ к метрикам и событиям RabbitMQ через HTTP API.
9+
10+
2. Убедитесь, что инструмент командной строки RabbitMQ (`rabbitmqctl`) находится в `PATH` пользователя `root`.
11+
12+
13+
### Шаг 1: Создание файла конфигурации
14+
15+
1. Создайте файл `rabbitmq-config.yml` в директории `/etc/newrelic-infra/integrations.d`:
16+
17+
```bash
18+
sudo touch /etc/newrelic-infra/integrations.d/rabbitmq-config.yml
19+
```
20+
21+
2. Откройте файл `rabbitmq-config.yml` и добавьте конфигурацию в зависимости от того, какие данные вы хотите собирать: события, метрики, или оба типа данных.
22+
23+
24+
### Пример конфигурации для сбора событий
25+
26+
```yaml
27+
integrations:
28+
- name: nri-rabbitmq
29+
env:
30+
EVENTS: true
31+
HOSTNAME: localhost
32+
PORT: 15672
33+
USERNAME: "admin"
34+
PASSWORD: "my_password" # Замените на ваш пароль
35+
NODE_NAME_OVERRIDE: local_node_name@localhost
36+
interval: 15s
37+
labels:
38+
env: production
39+
role: rabbitmq
40+
inventory_source: config/rabbitmq
41+
```
42+
43+
### Пример конфигурации для сбора метрик
44+
45+
```yaml
46+
integrations:
47+
- name: nri-rabbitmq
48+
env:
49+
METRICS: true
50+
HOSTNAME: localhost
51+
PORT: 15672
52+
USERNAME: "admin"
53+
PASSWORD: "my_password" # Замените на ваш пароль
54+
NODE_NAME_OVERRIDE: local_node_name@localhost
55+
56+
# Укажите конкретные очереди, которые нужно мониторить
57+
QUEUES: '["myQueue1","myQueue2"]'
58+
QUEUES_REGEXES: '["queue[0-9]+",".*"]'
59+
60+
# Укажите конкретные обменники
61+
EXCHANGES: '["exchange1","exchange2"]'
62+
EXCHANGES_REGEXES: '["exchange[0-9]+",".*"]'
63+
64+
# Укажите виртуальные хосты
65+
VHOSTS: '["vhost1","vhost2"]'
66+
VHOSTS_REGEXES: '["vhost[0-9]+",".*"]'
67+
interval: 15s
68+
labels:
69+
env: production
70+
role: rabbitmq
71+
inventory_source: config/rabbitmq
72+
```
73+
74+
### Шаг 2: Проверка данных
75+
76+
После добавления конфигурации перезапуск инфраструктурного агента не требуется.
77+
78+
79+
### Дополнительно
80+
- Для получения дополнительной информации об интеграции ознакомьтесь с [официальной документацией New Relic](https://docs.newrelic.com/install/rabbitmq/#config).

‎agent_installation_guide/Infra/database_monitoring/redis_agents_install.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
# Мониторинг Redis с использованием New Relic
2+
3+
Для настройки мониторинга Redis с использованием инфраструктурного агента New Relic выполните следующие шаги:
4+
5+
6+
### Шаг 1: Создание файла конфигурации для Redis
7+
8+
1. Создайте файл конфигурации `redis-config.yml` в директории `/etc/newrelic-infra/integrations.d`.
9+
10+
2. Добавьте в файл следующий контент, откорректировав данные подключения к Redis:
11+
12+
```yaml
13+
integrations:
14+
- name: nri-redis
15+
env:
16+
METRICS: true
17+
HOSTNAME: localhost
18+
PORT: 6379
19+
PASSWORD: "my_password" # Укажите пароль для подключения (если требуется)
20+
REMOTE_MONITORING: true
21+
interval: 15s
22+
labels:
23+
environment: production
24+
25+
- name: nri-redis
26+
env:
27+
INVENTORY: true
28+
HOSTNAME: localhost
29+
PORT: 6379
30+
PASSWORD: "my_password" # Укажите пароль для подключения (если требуется)
31+
REMOTE_MONITORING: true
32+
interval: 60s
33+
labels:
34+
environment: production
35+
inventory_source: config/redis
36+
```
37+
38+
39+
### Шаг 2: Пример базового контейнера с инфраструктурным агентом
40+
41+
Если вы хотите использовать контейнер с инфраструктурным агентом для мониторинга Redis, выполните следующие действия:
42+
43+
1. Создайте папку `integrations.d`, в которую поместите файл конфигурации для Redis (`redis-config.yml`).
44+
2. Создайте `compose.yaml` с описанием сервиса:
45+
46+
```yaml
47+
infra_services:
48+
restart: unless-stopped
49+
image: newrelic/infrastructure-bundle:latest
50+
volumes:
51+
- ./integrations.d:/etc/newrelic-infra/integrations.d
52+
environment:
53+
NRIA_IS_FORWARD_ONLY: 'true'
54+
NRIA_LICENSE_KEY: "0123456789012345678901234567890123456789" # Ключ (заглушка, не меняем)
55+
NRIA_COLLECTOR_URL: https://gmonit-collector.name.com/infra/infra-api
56+
NRIA_COMMAND_CHANNEL_URL: https://gmonit-collector.name.com/infra/command-api
57+
NRIA_IDENTITY_URL: https://gmonit-collector.name.com/infra/identity-api
58+
```
59+
60+
61+
### Шаг 3: Добавление переменной PASSWORD (и опционально USERNAME для Redis 6+)
62+
63+
Если ваш Redis требует аутентификации, добавьте переменные `PASSWORD` и (опционально) `USERNAME` в конфигурацию:
64+
65+
```yaml
66+
integrations:
67+
- name: nri-redis
68+
env:
69+
METRICS: true
70+
HOSTNAME: localhost
71+
PORT: 6379
72+
PASSWORD: "my_password" # Пароль для подключения
73+
REMOTE_MONITORING: true
74+
interval: 15s
75+
labels:
76+
environment: production
77+
78+
- name: nri-redis
79+
env:
80+
INVENTORY: true
81+
HOSTNAME: localhost
82+
PORT: 6379
83+
PASSWORD: "my_password" # Пароль для подключения
84+
REMOTE_MONITORING: true
85+
interval: 60s
86+
labels:
87+
environment: production
88+
inventory_source: config/redis
89+
```
90+
91+
### Шаг 4: Проверка данных
92+
93+
После добавления конфигурации перезапуск инфраструктурного агента не требуется.
94+
95+
96+
### Дополнительная информация
97+
98+
- Для получения дополнительной информации ознакомьтесь с [официальной документацией New Relic по интеграции Redis](https://docs.newrelic.com/docs/infrastructure/host-integrations/host-integrations-list/redis/redis-integration/).

0 commit comments

Comments
 (0)