Vector-agent#

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

1

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

false

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.runAsUser

UID пользователя, от имени которого запускаются контейнеры в pod Vector

0

podSecurityContext.seccompProfile.type

Тип Seccomp-профиля для pod Vector

RuntimeDefault

workloadResourceAnnotations

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

{}

securityContext.privileged

Запуск контейнера Vector в привилегированном режиме. Требуется для создания каталогов в /var/lib/vector

true

securityContext.readOnlyRootFilesystem

Монтирование корневой файловой системы в режиме «только для чтения»

true

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

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.host_metrics.filesystem.devices.excludes

Список устройств, исключаемых из сбора метрик файловых систем

customConfig.sources.host_metrics.filesystem.mountpoints.excludes

Список mountpoint-шаблонов, исключаемых из сбора метрик файловых систем

customConfig.sources.journald.type

Тип источника для чтения журнала systemd

journald

customConfig.sources.k8s_audit.type

Тип источника для чтения audit-логов Kubernetes из файлов

file

customConfig.sources.k8s_audit.read_from

Точка начала чтения файлового источника

beginning

customConfig.transforms.tag_k8s_pods.type

Тип transform для маркировки логов pod Kubernetes

remap

customConfig.transforms.tag_k8s_pods.source

VRL-скрипт для установки признака источника логов pod

customConfig.transforms.tag_k8s_node.inputs

Список входов для transform маркировки логов узла

customConfig.transforms.k8s_audit_json.type

Тип transform для разбора audit-логов Kubernetes

remap

customConfig.transforms.k8s_audit_json.source

VRL-скрипт для парсинга JSON audit-событий, фильтрации шума и нормализации ключевых полей

customConfig.transforms.add_host.inputs

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

customConfig.sinks.aggregator.type

Тип sink для отправки данных в upstream Vector aggregator

vector

customConfig.sinks.aggregator.inputs

Список входов для sink отправки в aggregator

customConfig.sinks.prom_exporter.address

Адрес и порт, на которых Prometheus exporter будет слушать соединения

0.0.0.0:9090

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.retentionPolicy

Политика сохранения PersistentVolumeClaim для StatefulSet Vector. Актуально для роли Aggregator.
Пример конфигурации:

whenDeleted: Retain
whenScaled: Retain

{}

persistence.accessModes

Список access modes для PersistentVolumeClaim. Актуально для роли Aggregator

persistence.finalizers

Список finalizers для PersistentVolumeClaim. Актуально для роли Aggregator

persistence.hostPath.enabled

Включение хранения данных через hostPath для роли Agent. При отключении для роли Agent используется emptyDir

true

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

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

httpGet:
  path: /health
  port: 8686

{}

readinessProbe

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

httpGet:
  path: /health
  port: 8686

{}

startupProbe

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

httpGet:
  path: /health
  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 }}

[]