Vector-aggregator#

nameOverride

Переопределение базового имени ресурсов чарта для генерации имен

""

fullnameOverride

Полное переопределение имени для всех создаваемых ресурсов чарта

""

role

Роль экземпляра Vector.
Возможные значения: для роли Agent создается DaemonSet, для Aggregator – StatefulSet, для Stateless-Aggregator – Deployment

Agent

daemonSet.apiVersion

Переопределение версии API для DaemonSet (действует для роли Agent)

""

statefulSet.apiVersion

Переопределение версии API для StatefulSet (действует для роли Aggregator)

""

rollWorkload

Активация добавления контрольной суммы сгенерированного ConfigMap в аннотации workload для инициирования rolling update при изменении конфигурации

true

rollWorkloadSecrets

Активация добавления контрольной суммы сгенерированного Secret в аннотации workload для инициирования rolling update при изменении секрета

true

rollWorkloadExtraObjects

Активация добавления контрольной суммы объектов из extraObjects в аннотации workload для инициирования rolling update при их изменении

true

commonLabels

Дополнительные метки, добавляемые ко всем создаваемым ресурсам

{}

image.repository

Переопределение реестра и имени образа Vector

'{{ .Values.global.image.registry }}/{{ .Values.global.image.repository }}/{{ .Values.global.dappVersion }}/dapp-vector/vector'

image.pullSecrets

Список ImagePullSecrets для доступа к приватным реестрам из pod Vector

[]

image.sha

SHA-хеш образа для проверки целостности

""

replicas

Количество реплик pod

2

hostAliases

Список псевдонимов хостов для добавления в /etc/hosts.
Пример конфигурации:

- ip: "127.0.0.1"
  hostnames:
  - "foo.local"
  - "bar.local"

[]

podManagementPolicy

Политика управления pod для StatefulSet (действует для роли Aggregator).
Возможные значения: OrderedReady или Parallel

OrderedReady

secrets.generic

Набор произвольных ключей и значений, добавляемых в Secret. Значения указываются в открытом виде без base64-кодирования. Обычно используется для учетных данных и параметров доступа.
Пример конфигурации:

my_variable: "my-secret-value"
datadog_api_key: "api-key"
awsAccessKeyId: "access-key"
awsSecretAccessKey: "secret"

{}

autoscaling.enabled

Создание HorizontalPodAutoscaler. Применяется к ролям Aggregator и Stateless-Aggregator

false

autoscaling.annotations

Аннотации, добавляемые ко всем создаваемым ресурсам

{}

autoscaling.maxReplicas

Максимальное количество реплик при автоматическом масштабировании

10

autoscaling.targetMemoryUtilizationPercentage

Целевой процент утилизации памяти для HPA Vector

~

autoscaling.behavior

Раздельная настройка поведения scale-up и scale-down для HPA.
Пример конфигурации:

scaleDown:
  stabilizationWindowSeconds: 300

{}

podDisruptionBudget.enabled

Включение PodDisruptionBudget

true

podDisruptionBudget.maxUnavailable

Максимальное количество pod, которое может быть недоступно после вытеснения (eviction)

~

rbac.create

Активация автоматического создания ресурсов RBAC

true

psp.create

Создание ресурса PodSecurityPolicy для роли Agent (PodSecurityPolicy устарел, начиная с Kubernetes 1.21, и удален в 1.25)

false

serviceAccount.create

Включение создания ServiceAccount

true

serviceAccount.name

Имя ServiceAccount. При пустом значении и включенном создании имя генерируется по шаблону fullname

~

podAnnotations

Аннотации, добавляемые на pod Vector

{}

podLabels.vector.dev/exclude

Метка для pod Vector. Обычно используется для исключения логов Vector из сбора метрик

"true"

podPriorityClassName

Имя PriorityClass, назначаемое pod Vector

""

podHostNetwork

Активация запуска pod Vector в сетевом пространстве узла

false

podSecurityContext

Переопределяет стандартный PodSecurityContext для pod Vector

{}

workloadResourceAnnotations

Аннотации для ресурса DaemonSet, Deployment или StatefulSet, которым разворачивается Vector

{}

securityContext

Контекст безопасности для контейнеров Vector

{}

command

Команда запуска контейнера, переопределяющая стандартный entrypoint образа контейнера

[]

args

Аргументы, переопределяющие стандартные аргументы запуска контейнера

env

Переменные окружения контейнера.
Пример конфигурации:

- name: MY_VARIABLE
  valueFrom:
    secretKeyRef:
      name: vector
      key: key
- name: AWS_ACCESS_KEY_ID
  valueFrom:
    secretKeyRef:
      name: vector
      key: key

[]

envFrom

Источники переменных окружения (Secret или ConfigMap) для pod.
Пример конфигурации:

- secretRef:
    name: vector

[]

containerPorts

Cписок портов контейнера с отключением автоматической генерации

[]

resources

Запросы и ограничения ресурсов для контейнера.
Пример конфигурации:

requests:
  cpu: 200m
  memory: 256Mi
limits:
  cpu: 200m
  memory: 256Mi

{}

lifecycle

Параметры lifecycle для контейнера.
Пример конфигурации:

preStop:
  exec:
    command:
    - /bin/sleep
    - "10"

{}

minReadySeconds

Время в состоянии Ready, после которого pod считается доступным

0

revisionHistoryLimit

Количество предыдущих версий ресурса, сохраняемых для отката

10

updateStrategy

Стратегия обновления ресурса.
Пример конфигурации:

type: RollingUpdate
rollingUpdate:
  maxUnavailable: 1

{}

terminationGracePeriodSeconds

Время, отведенное на корректное завершение работы pod

60

nodeSelector

Селектор узлов для планирования pod

{}

tolerations

Toleration для размещения pod на узлах с ограничениями (taints)

[]

affinity

Настройки правила привязки (affinity и anti-affinity) pod к узлам

{}

topologySpreadConstraints

Ограничения топологии для равномерного распределения pod по зонам доступности и узлам

[]

service.enabled

Активация создания Service

true

service.annotations

Аннотации, добавляемые ко всем создаваемым ресурсам

{}

service.ports

Список портов Service Vector с отключением автоматической генерации

[]

service.internalTrafficPolicy

Политика маршрутизации внутреннего трафика для Service внутри кластера

""

service.ipFamilyPolicy

Политика использования IPv4/IPv6 для Service

""

service.trafficDistribution

Параметр распределения трафика для Service с учетом topology-aware routing

""

serviceHeadless.enabled

Создание headless-сервиса

true

ingress.enabled

Включение Ingress для компонента сервера

false

ingress.annotations

Аннотации Ingress.
Пример конфигурации:

kubernetes.io/ingress.class: nginx
kubernetes.io/tls-acme: "true"

{}

ingress.tls

Массив объектов TLS для Ingress.
Пример конфигурации:

- secretName: chart-example-tls
  hosts:
    - chart-example.local

[]

existingConfigMaps

Список существующих ConfigMap с конфигурацией Vector вместо создания новой. Требует заполнения dataDir, а также явного задания containerPorts, service.ports и параметров headless-сервиса. Параметр имеет приоритет над customConfig и встроенной конфигурацией чарта

[]

dataDir

Путь к каталогу данных Vector при использовании существующих ConfigMap с конфигурацией

""

customConfig.api.address

API-адрес Vector для healthcheck, introspection и playground

127.0.0.1:8686

customConfig.data_dir

Каталог хранения данных Vector

/vector-data-dir

customConfig.sources.datadog_agent.type

Тип источника для приема данных Datadog Agent

datadog_agent

customConfig.sources.fluent.type

Тип источника для приема событий Fluent

fluent

customConfig.sources.logstash.address

Адрес прослушивания входа Logstash

0.0.0.0:5044

customConfig.sources.splunk_hec.address

Адрес прослушивания входа Splunk HEC

0.0.0.0:8080

customConfig.sources.statsd.address

Адрес прослушивания входа StatsD

0.0.0.0:8125

customConfig.sources.statsd.type

Тип источника для приема метрик StatsD

statsd

customConfig.sources.syslog.mode

Режим работы входа Syslog, например tcp или udp

tcp

customConfig.sources.vector.address

Адрес прослушивания входа Vector

0.0.0.0:6000

customConfig.sources.vector.version

Версия протокола источника Vector

"2"

customConfig.transforms.ensure_source_type.inputs

Список входов для transform нормализации поля источника

customConfig.transforms.add_cluster.type

Тип transform для добавления имени кластера в событие

remap

customConfig.transforms.add_cluster.source

VRL-скрипт, который заполняет поле cluster значением имени кластера из Helm values

customConfig.transforms.add_unit_hint.inputs

Список входов для transform добавления поля unit

customConfig.transforms.route_streams.type

Тип transform для маршрутизации потоков по категориям

route

customConfig.transforms.route_streams.route.audit

Условие маршрута для audit-событий Kubernetes

'.source_type == "k8s_audit"'

customConfig.transforms.route_streams.route.node

Условие маршрута для логов узла и внешних источников

'.source_type == "k8s_node" || .source_type == "external"'

customConfig.transforms.normalize_pod_labels.inputs

Список входов для transform нормализации pod labels

customConfig.sinks.loki_pods.type

Тип sink для отправки логов pod в Loki

loki

customConfig.sinks.loki_pods.dangerously_allow_unconfined_template_resolution

Разрешает неограниченное разрешение шаблонов для sink логов pod

true

customConfig.sinks.loki_pods.encoding.codec

Кодек сериализации событий перед отправкой в Loki

json

customConfig.sinks.loki_pods.batch.max_bytes

Максимальный размер batch в байтах при отправке в Loki

1048576

customConfig.sinks.loki_pods.batch.timeout_secs

Тайм-аут batch перед принудительной отправкой в Loki

2

customConfig.sinks.loki_pods.request.rate_limit_duration_secs

Интервал rate limit для запросов к Loki

1

customConfig.sinks.loki_pods.request.retry_initial_backoff_secs

Начальный backoff при повторных попытках отправки в Loki

1

customConfig.sinks.loki_pods.request.timeout_secs

Тайм-аут HTTP-запроса к Loki

30

customConfig.sinks.loki_pods.buffer.max_size

Максимальный размер буфера sink логов pod в байтах

268435456

customConfig.sinks.loki_pods.labels.job

Статическая метка job для логов pod в Loki

k8s-pods

customConfig.sinks.loki_pods.labels.source_type

Шаблон метки source_type для логов pod в Loki

'{{ "{{" }} source_type {{ "}}" }}'

customConfig.sinks.loki_pods.labels.namespace

Шаблон метки namespace для логов pod в Loki

'{{ "{{" }} kubernetes.pod_namespace {{ "}}" }}'

customConfig.sinks.loki_pods.labels.container

Шаблон метки container для логов pod в Loki

'{{ "{{" }} kubernetes.container_name {{ "}}" }}'

customConfig.sinks.loki_pods.labels.app_kubernetes_io_name

Шаблон метки app_kubernetes_io_name для логов pod в Loki

'{{ "{{" }} app_kubernetes_io_name {{ "}}" }}'

customConfig.sinks.loki_pods.out_of_order_action

Действие для событий, пришедших не по порядку времени

accept

customConfig.sinks.loki_node.endpoint

HTTP эндпоинт Loki для записи логов узлов

http://loki.dapp-logging.svc.cluster.local:3100

customConfig.sinks.loki_node.inputs

Список входов для sink логов узлов

customConfig.sinks.loki_node.compression

Алгоритм сжатия запросов sink логов узлов

snappy

customConfig.sinks.loki_node.batch.max_events

Максимальное количество событий в batch для логов узлов

5000

customConfig.sinks.loki_node.request.concurrency

Количество параллельных запросов sink логов узлов

2

customConfig.sinks.loki_node.request.rate_limit_num

Максимальное количество запросов sink логов узлов за интервал

50

customConfig.sinks.loki_node.request.retry_max_duration_secs

Максимальная длительность повторных попыток sink логов узлов

600

customConfig.sinks.loki_node.buffer.type

Тип буфера sink логов узлов

memory

customConfig.sinks.loki_node.buffer.when_full

Поведение при заполнении буфера sink логов узлов

block

customConfig.sinks.loki_node.labels.cluster

Шаблон метки cluster для логов узлов в Loki

'{{ "{{" }} cluster {{ "}}" }}'

customConfig.sinks.loki_node.labels.host

Шаблон метки host для логов узлов в Loki

'{{ "{{" }} host {{ "}}" }}'

customConfig.sinks.loki_node.out_of_order_action

Действие для событий логов узлов, пришедших не по порядку времени

accept

customConfig.sinks.loki_audit.endpoint

HTTP эндпоинт Loki для записи audit-логов Kubernetes

http://loki.dapp-logging.svc.cluster.local:3100

customConfig.sinks.loki_audit.inputs

Список входов для sink audit-логов

customConfig.sinks.loki_audit.compression

Алгоритм сжатия запросов sink audit-логов

snappy

customConfig.sinks.loki_audit.batch.max_events

Максимальное количество событий в batch для audit-логов

5000

customConfig.sinks.loki_audit.request.concurrency

Количество параллельных запросов sink audit-логов

2

customConfig.sinks.loki_audit.request.rate_limit_num

Максимальное количество запросов sink audit-логов за интервал

50

customConfig.sinks.loki_audit.request.retry_max_duration_secs

Максимальная длительность повторных попыток sink audit-логов

600

customConfig.sinks.loki_audit.buffer.type

Тип буфера sink audit-логов

memory

customConfig.sinks.loki_audit.buffer.when_full

Поведение при заполнении буфера sink audit-логов

block

customConfig.sinks.loki_audit.labels.cluster

Шаблон метки cluster для audit-логов Kubernetes в Loki

'{{ "{{" }} cluster {{ "}}" }}'

customConfig.sinks.loki_audit.labels.host

Шаблон метки host для audit-логов Kubernetes в Loki

'{{ "{{" }} host {{ "}}" }}'

customConfig.sinks.loki_audit.labels.apiGroup

Шаблон метки apiGroup для audit-логов Kubernetes в Loki

'{{ "{{" }} apiGroup {{ "}}" }}'

customConfig.sinks.loki_audit.labels.subresource

Шаблон метки subresource для audit-логов Kubernetes в Loki

'{{ "{{" }} subresource {{ "}}" }}'

customConfig.sinks.loki_audit.labels.code

Шаблон метки code для audit-логов Kubernetes в Loki

'{{ "{{" }} code {{ "}}" }}'

customConfig.sinks.prom_exporter.type

Тип sink для экспорта метрик в формате Prometheus

prometheus_exporter

customConfig.sinks.prom_exporter.inputs

Список входов для Prometheus exporter

defaultVolumes

Тома, монтируемые в pod Vector по умолчанию. Обычно изменять не требуется. Для пользовательских томов используются extraVolumes и extraVolumeMounts

defaultVolumeMounts

Стандартные volumeMounts, соответствующие томам из defaultVolumes

extraVolumes

Дополнительные тома Volume для pod Vector

[]

extraVolumeMounts

Список дополнительных точек монтирования томов (VolumeMounts) в контейнере

[]

initContainers

Список init-контейнеров, запускаемых перед основными.
Пример конфигурации:

- name: test
  image: busybox:latest
  command:
    - cp
  args:
    - /bin/sleep
    - /test/sleep
  volumeMounts:
    - name: test
      mountPath: /test

[]

extraContainers

Дополнительные контейнеры для pod Vector. Поддерживает шаблоны Helm.
Пример конфигурации:

- name: test
  command:
    - cp
  args:
    - /bin/sleep
    - /test/sleep
  image: busybox:latest
  volumeMounts:
    - name: test
      mountPath: /test

[]

persistence.enabled

Создание и использование PersistentVolumeClaim для хранения данных Vector

false

persistence.storageClassName

Указывает storageClassName для PersistentVolumeClaim. Актуально для роли Aggregator

~

persistence.annotations

Аннотации, добавляемые ко всем создаваемым ресурсам

{}

persistence.size

Размер PersistentVolumeClaim для хранения данных Vector. Актуально для роли Aggregator

10Gi

persistence.selectors

Label selectors для выбора подходящего PersistentVolume. Актуально для роли Aggregator

{}

persistence.hostPath.path

Путь hostPath для хранения данных роли Agent. Для роли Agent хранение используется всегда

/var/lib/vector

dnsPolicy

Политика разрешения DNS для pod

ClusterFirst

dnsConfig

Пользовательская конфигурация DNS для pod.
Пример конфигурации:

nameservers:
  - 1.2.3.4
searches:
  - ns1.svc.cluster-domain.example
  - my.dns.search.suffix
options:
  - name: ndots
    value: "2"
  - name: edns0

{}

shareProcessNamespace

Включение общего пространства имен процессов между контейнерами pod. Позволяет контейнерам видеть процессы друг друга и взаимодействовать через сигналы (например, с sidecar-контейнерами)

false

livenessProbe

Настройка параметров проверки работоспособности контейнера.
Пример конфигурации:

grpc:
  port: 8686

{}

readinessProbe

Настройка параметров проверки готовности контейнера.
Пример конфигурации:

grpc:
  port: 8686

{}

startupProbe

Настройка проверки успешного запуска приложения внутри контейнера. Пока не завершится успешно, проверки работоспособности и готовности не запускаются.
Пример конфигурации:

grpc:
  port: 8686

{}

podMonitor.enabled

Создание PodMonitor. Требует установленный CRD PodMonitor

false

podMonitor.port

Имя порта, используемого для scrape

prom-exporter

podMonitor.interval

Интервал опроса метрик Prometheus

~

podMonitor.relabelings

RelabelConfigs, применяемые к samples перед scrape

[]

podMonitor.podTargetLabels

Список меток pod, переносимых на target метрик

[]

podMonitor.honorLabels

Установка honor_labels: true в scrape config

false

logLevel

Уровень логирования Vector.
Возможные значения: trace, debug, info, warn, error

info

haproxy.enabled

Создание встроенного балансировщика HAProxy

false

haproxy.image.pullPolicy

Политика загрузки образа HAProxy

IfNotPresent

haproxy.image.tag

Тег образа контейнера

2.6.12

haproxy.replicas

Количество реплик pod

1

haproxy.serviceAccount.annotations

Аннотации, добавляемые ко всем создаваемым ресурсам

{}

haproxy.serviceAccount.automountToken

Автоматический монтаж учетных данных API в ServiceAccount HAProxy

true

haproxy.terminationGracePeriodSeconds

Время, отведенное на корректное завершение работы pod

60

haproxy.podLabels

Метки для pod HAProxy

{}

haproxy.podSecurityContext

Параметры контекста безопасности pod.
Пример конфигурации:

fsGroup: 2000

{}

haproxy.containerPorts

Явное задание containerPorts для HAProxy с отключением автоматической генерации

[]

haproxy.service.annotations

Аннотации, добавляемые ко всем создаваемым ресурсам

{}

haproxy.service.ports

Список портов Service HAProxy с отключением автоматической генерации

[]

haproxy.service.loadBalancerIP

Статический IP-адрес для Service HAProxy типа LoadBalancer

""

haproxy.service.ipFamilies

Список IP-семейств, поддерживаемых Service

[]

haproxy.customConfig

Полное переопределение конфигурации HAProxy. Поддерживает шаблоны Helm для подстановки значений. По умолчанию конфигурация генерируется на основе customConfig Vector

""

haproxy.extraVolumeMounts

Список дополнительных точек монтирования томов (VolumeMounts) в контейнере

[]

haproxy.extraContainers

Дополнительные контейнеры для pod HAProxy. Поддерживает шаблоны Helm

[]

haproxy.autoscaling.external

Масштабирование HAProxy внешним HorizontalPodAutoscaler

false

haproxy.autoscaling.maxReplicas

Максимальное количество реплик при автоматическом масштабировании

10

haproxy.autoscaling.targetMemoryUtilizationPercentage

Целевой процент утилизации памяти для HPA HAProxy

~

haproxy.resources

Запросы и ограничения ресурсов для контейнера.
Пример конфигурации:

limits:
  cpu: 100m
  memory: 128Mi
requests:
  cpu: 100m
  memory: 128Mi

{}

haproxy.readinessProbe.tcpSocket.port

TCP-порт для стандартной проверки готовности контейнера HAProxy

1024

haproxy.tolerations

Toleration для размещения pod на узлах с ограничениями (taints)

[]

extraObjects

Добавление дополнительных динамических объектов в Helm-чарте.
Пример конфигурации:

- apiVersion: v1
  kind: ConfigMap
  metadata:
    name: vector-dashboards
    labels:
      grafana_dashboard: "1"
  data:
    vector.json: |
      {{ .Files.Get "dashboards/vector.json" | fromJson | toJson }}

[]