Модуль расширяет возможности модуля prometheus по мониторингу приложений пользователей.
Чтобы организовать сбор метрик с приложений модулем monitoring-custom
, необходимо:
- Поставить лейбл
prometheus.deckhouse.io/custom-target
на Service или Pod. Значение лейбла определит имя в списке target’ов Prometheus.-
В качестве значения label’а prometheus.deckhouse.io/custom-target стоит использовать название приложения (маленькими буквами, разделитель
-
), которое позволяет его уникально идентифицировать в кластере.При этом, если приложение ставится в кластер больше одного раза (staging, testing, etc) или даже ставится несколько раз в один namespace — достаточно одного общего названия, так как у всех метрик в любом случае будут лейблы namespace, Pod и, если доступ осуществляется через Service, лейбл service. То есть это название, уникально идентифицирующее приложение в кластере, а не единичную его инсталляцию.
-
-
Порту, с которого нужно собирать метрики, указать имя
http-metrics
иhttps-metrics
для подключения по HTTP или HTTPS соответственно.Если это невозможно (например, порт уже определен и назван другим именем), то необходимо воспользоваться аннотациями:
prometheus.deckhouse.io/port: номер_порта
для указания порта иprometheus.deckhouse.io/tls: "true"
, если сбор метрик будет проходить по HTTPS.-
Пример 1:
ports: - name: https-metrics containerPort: 443
-
Пример 2:
annotations: prometheus.deckhouse.io/port: "443" prometheus.deckhouse.io/tls: "true" # если метрики отдаются по http, эту аннотацию указывать не нужно
-
-
При использовании service mesh Istio в режиме STRICT mTLS, для сбора метрик необходимо указать следующую аннотацию у Service:
prometheus.deckhouse.io/istio-mtls: "true"
. Важно, что метрики приложения должны экспортироваться по протоколу HTTP без TLS. -
(Не обязательно) Указать дополнительные аннотации для более тонкой настройки.
prometheus.deckhouse.io/path
— путь для сбора метрик (по умолчанию:/metrics
)prometheus.deckhouse.io/query-param-$name
— GET параметры, будут преобразованы в map вида$name=$value
(по умолчанию: ‘’)-
возможно указать несколько таких аннотаций.
Например:
prometheus.deckhouse.io/query-param-foo=bar
иprometheus.deckhouse.io/query-param-bar=zxc
будут преобразованы в query:http://...?foo=bar&bar=zxc
-
prometheus.deckhouse.io/allow-unready-pod
— разрешает сбор метрик с Pod’ов в любом состоянии (по умолчанию метрики собираются только с Pod’ов в состоянии Ready). Эта опция полезна в очень редких случаях. Например, если ваше приложение запускается очень долго (при старте загружаются данные в базу или прогреваются кеши), но в процессе запуска уже отдаются полезные метрики, которые помогают следить за запуском приложения.prometheus.deckhouse.io/sample-limit
— сколько семплов разрешено собирать с Pod’а (по умолчанию 5000). Значение по умолчанию защищает от ситуации, когда приложение внезапно начинает отдавать слишком большое количество метрик, что может нарушить работу всего мониторинга. Эту аннотацию надо вешать на тот же ресурс, на котором висит лейблprometheus.deckhouse.io/custom-target
.
Пример: Service
apiVersion: v1
kind: Service
metadata:
name: my-app
namespace: my-namespace
labels:
prometheus.deckhouse.io/custom-target: my-app
annotations:
prometheus.deckhouse.io/port: "8061" # по умолчанию будет использоваться порт сервиса с именем http-metrics или https-metrics
prometheus.deckhouse.io/path: "/my_app/metrics" # по умолчанию /metrics
prometheus.deckhouse.io/query-param-format: "prometheus" # по умолчанию ''
prometheus.deckhouse.io/allow-unready-pod: "true" # по умолчанию Pod'ы НЕ в Ready игнорируются
prometheus.deckhouse.io/sample-limit: "5000" # по умолчанию принимается не больше 5000 метрик от одного Pod'а
spec:
ports:
- name: my-app
port: 8060
- name: http-metrics
port: 8061
targetPort: 8061
selector:
app: my-app
Пример: Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-app
labels:
app: my-app
spec:
selector:
matchLabels:
app: my-app
template:
metadata:
labels:
app: my-app
prometheus.deckhouse.io/custom-target: my-app
annotations:
prometheus.deckhouse.io/sample-limit: "5000" # по умолчанию принимается не больше 5000 метрик от одного Pod'а
spec:
containers:
- name: my-app
image: my-app:1.7.9
ports:
- name: https-metrics
containerPort: 443