Azubarev: Новая страница: «= Prometheus Redis = Расширение предназначено для мониторинга Redis по метрикам Prometheus, публикуемым Redis Exporter. Расширение собирает показатели производительности Redis и самого экспортёра, создаёт связанные сущности Redis и Exporter и добавляет готовую обзорную панель. '''...»

2026-09-29T00:10:30Z

Новая страница: «= Prometheus Redis = Расширение предназначено для мониторинга Redis по метрикам Prometheus, публикуемым Redis Exporter. Расширение собирает показатели производительности Redis и самого экспортёра, создаёт связанные сущности Redis и Exporter и добавляет готовую обзорную панель. '''...»

Новая страница

= Prometheus Redis =

Расширение предназначено для мониторинга Redis по метрикам Prometheus, публикуемым Redis Exporter.

Расширение собирает показатели производительности Redis и самого экспортёра, создаёт связанные сущности Redis и Exporter и добавляет готовую обзорную панель.

'''Идентификатор расширения:''' <code>prometheus-redis</code>

== Схема работы ==

<pre>
Redis
|
| команды INFO, CONFIG, SLOWLOG и другие
v
Redis Exporter
|
| Prometheus /metrics
v
EEC
|
v
Ключ-АСТРОМ
</pre>

Расширение не подключается к Redis напрямую. Перед настройкой необходимо установить и запустить Redis Exporter.

== Возможности ==

* контроль доступности Redis;
* мониторинг памяти и фрагментации;
* контроль клиентов и соединений;
* анализ выполненных и отклонённых команд;
* мониторинг ключей, попаданий и промахов кеша;
* контроль удаления и истечения срока действия ключей;
* мониторинг RDB и AOF;
* контроль репликации;
* сбор сетевых показателей;
* мониторинг состояния Redis Exporter;
* расчёт коэффициента попаданий в кеш;
* создание сущностей Redis и Exporter.

== Требования ==

* Redis Exporter должен иметь сетевой доступ к Redis.
* Prometheus endpoint экспортёра должен быть доступен с сервера EEC.
* Межсетевой экран должен разрешать подключения от EEC к Redis Exporter.
* Пользователь Redis должен иметь права, необходимые экспортёру для получения статистики.
* Для каждого Redis Exporter рекомендуется задавать уникальное имя scraper.

По умолчанию Redis Exporter публикует метрики по адресу:

<pre>
http://exporter.example.local:9121/metrics
</pre>

== Установка Redis Exporter ==

Redis Exporter можно запустить как отдельный процесс, контейнер или компонент Kubernetes.

Пример файла переменных окружения:

<pre>
REDIS_ADDR=redis://redis.example.local:6379
REDIS_USER=monitoring
REDIS_PASSWORD=<password>
REDIS_EXPORTER_WEB_LISTEN_ADDRESS=0.0.0.0:9121
</pre>

Пример запуска контейнера:

<pre>
docker run -d \
--name redis-exporter \
--restart unless-stopped \
--env-file /etc/redis-exporter.env \
-p 9121:9121 \
ghcr.io/oliver006/redis_exporter:<version>
</pre>

Используйте протестированную в вашей среде версию Redis Exporter. Пароль Redis рекомендуется хранить в защищённом файле или системе управления секретами.

Проверьте работу экспортёра:

<pre>
curl http://exporter.example.local:9121/metrics
</pre>

В ответе должны присутствовать метрики с префиксом <code>redis_</code>. Метрика <code>redis_up</code> должна иметь значение <code>1</code>.

== Защита Redis Exporter ==

Доступ к порту <code>9121</code> рекомендуется разрешать только с серверов EEC и других систем мониторинга.

Redis Exporter также поддерживает Basic-аутентификацию:

<pre>
REDIS_EXPORTER_BASIC_AUTH_USERNAME=monitoring
REDIS_EXPORTER_BASIC_AUTH_PASSWORD=<password>
</pre>

Если Basic-аутентификация включена, те же учётные данные необходимо указать при настройке Prometheus endpoint в Ключ-АСТРОМ.

== Установка расширения ==

# Скачайте пакет расширения.
# В интерфейсе Ключ-АСТРОМ откройте раздел управления расширениями.
# Загрузите архив расширения.
# Откройте расширение <code>prometheus-redis</code>.
# Добавьте конфигурацию мониторинга.
# Выберите удалённый режим выполнения.
# Укажите группу EEC, с которой доступен Redis Exporter.
# Добавьте Prometheus endpoint.
# Выберите необходимые наборы функций.
# Сохраните и активируйте конфигурацию.

== Настройка подключения ==

Укажите URL Prometheus endpoint:

<pre>
http://exporter.example.local:9121/metrics
</pre>

Если Redis Exporter защищён Basic-аутентификацией, выберите соответствующий тип аутентификации и укажите имя пользователя и пароль.

В поле «If multiple separate scrapers are used please enter name» укажите понятное уникальное имя экспортёра, например:

<pre>
redis-exporter-production
</pre>

Значение добавляется в измерение <code>scrapername</code> и используется при создании сущности Exporter.

== Мониторинг нескольких Redis ==

Для каждого отдельного Redis Exporter можно создать собственный endpoint и указать уникальное значение <code>scrapername</code>.

Redis Exporter также поддерживает multi-target режим через endpoint:

<pre>
http://exporter.example.local:9121/scrape?target=redis://redis.example.local:6379
</pre>

При использовании multi-target режима создайте отдельный endpoint для каждого контролируемого Redis и убедитесь, что адрес Redis корректно закодирован в URL.

== Наборы функций ==

Расширение позволяет отдельно включать следующие группы показателей:

* память и аллокатор;
* клиенты и соединения;
* команды Redis;
* базы данных и keyspace;
* удаление и истечение ключей;
* кластер и репликация;
* RDB и AOF;
* процессор, сеть и процесс Redis;
* Pub/Sub и модули;
* состояние Redis Exporter;
* процесс и среда Go экспортёра.

Для базового мониторинга рекомендуется включить:

* Memory metrics;
* Client metrics;
* Connected metrics;
* Command metrics;
* Database metrics;
* Keyspace metrics;
* Replication metrics;
* Exporter metrics.

Набор Standalone scraper metrics содержит показатели процесса Redis Exporter и среды Go.

Не включайте ненужные наборы функций: метки Prometheus автоматически становятся измерениями и могут увеличить количество временных рядов.

== Основные метрики ==

{| class="wikitable"
! Группа
! Метрики
! Назначение
|-
| Доступность
| <code>ru.ruscomtech.extension.prometheus_redis-redis_up</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_uptime_in_seconds</code>
| Доступность и время работы Redis.
|-
| Память
| <code>ru.ruscomtech.extension.prometheus_redis-redis_memory_used_bytes</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_memory_max_bytes</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_memory_used_rss_bytes</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_mem_fragmentation_ratio</code>
| Использование памяти и её фрагментация.
|-
| Клиенты
| <code>ru.ruscomtech.extension.prometheus_redis-redis_connected_clients</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_blocked_clients</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_rejected_connections_total.count</code>
| Подключённые и заблокированные клиенты, отклонённые подключения.
|-
| Команды
| <code>ru.ruscomtech.extension.prometheus_redis-redis_commands_processed_total.count</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_commands_failed_calls_total.count</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_commands_rejected_calls_total.count</code>
| Выполненные, завершившиеся ошибкой и отклонённые команды.
|-
| Keyspace
| <code>ru.ruscomtech.extension.prometheus_redis-redis_keyspace_hits_total.count</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_keyspace_misses_total.count</code> 
<code>func:ru.ruscomtech.extension.prometheus-redis_keyspace_cache_ratio.count</code>
| Попадания, промахи и рассчитанный коэффициент попаданий в кеш.
|-
| Базы данных
| <code>ru.ruscomtech.extension.prometheus_redis-redis_db_keys</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_db_keys_expiring</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_db_avg_ttl_seconds</code>
| Количество ключей и среднее время жизни.
|-
| Удаление ключей
| <code>ru.ruscomtech.extension.prometheus_redis-redis_evicted_keys_total.count</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_expired_keys_total.count</code>
| Ключи, удалённые из-за нехватки памяти или истечения TTL.
|-
| Репликация
| <code>ru.ruscomtech.extension.prometheus_redis-redis_master_repl_offset</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_replication_backlog_bytes</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_replica_resyncs_full</code>
| Состояние журнала репликации и повторной синхронизации.
|-
| Сеть
| <code>ru.ruscomtech.extension.prometheus_redis-redis_net_input_bytes_total.count</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_net_output_bytes_total.count</code>
| Входящий и исходящий сетевой трафик.
|-
| Экспортёр
| <code>ru.ruscomtech.extension.prometheus_redis-redis_exporter_last_scrape_error</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_exporter_last_scrape_duration_seconds</code> 
<code>ru.ruscomtech.extension.prometheus_redis-redis_exporter_scrapes_total.count</code>
| Ошибки, продолжительность и количество опросов Redis Exporter.
|}

Наличие отдельных метрик зависит от версии Redis, конфигурации Redis Exporter и включённых возможностей Redis.

== Сущности и топология ==

Расширение создаёт следующие сущности:

* '''Redis''' — контролируемый экземпляр Redis;
* '''Exporter''' — экземпляр Redis Exporter.

Сущность Redis связывается с соответствующим Exporter отношением «дочерняя сущность».

Для идентификации Redis используются адрес хоста, TCP-порт и доступные измерения инфраструктуры.

== Обзорная панель ==

В состав расширения входит готовая панель «Redis Extension 2.0». Она отображает:

* доступность экземпляров Redis;
* количество выполненных команд;
* использование памяти;
* попадания и промахи кеша;
* соединения;
* удалённые и просроченные ключи;
* состояние репликации;
* показатели Redis Exporter.

Расширение также добавляет страницы сущностей Redis и Exporter.

== Проверка работы ==

После активации конфигурации убедитесь, что:

* endpoint Redis Exporter доступен с сервера EEC;
* в ответе присутствуют метрики <code>redis_*</code>;
* метрика <code>redis_up</code> имеет значение <code>1</code>;
* конфигурация расширения не содержит ошибок;
* появляются сущности Redis и Exporter;
* данные отображаются на обзорной панели.

Если метрики экспортёра поступают, но метрики Redis отсутствуют, проверьте:

* адрес Redis в конфигурации экспортёра;
* имя пользователя и пароль Redis;
* сетевой доступ от экспортёра к Redis;
* значение <code>redis_exporter_last_scrape_error</code>.

== История изменений ==

{| class="wikitable"
! Версия
! Изменения
|-
| 20.22.13
|
* Добавлен сбор метрик Redis через Redis Exporter.
* Добавлены тематические наборы метрик памяти, клиентов, команд, keyspace, репликации, RDB и AOF.
* Добавлен расчёт коэффициента попаданий в кеш.
* Добавлены сущности Redis и Exporter.
* Добавлена готовая обзорная панель.
|}

Prometheus Redis - История изменений