Vector-agent#

nameOverride

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

""

fullnameOverride

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

""

role

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

"Agent"

rollWorkload

Добавляет контрольную сумму сгенерированного ConfigMap в аннотации workload, чтобы инициировать rolling update при изменении конфигурации

true

rollWorkloadSecrets

Добавляет контрольную сумму сгенерированного Secret в аннотации workload, чтобы инициировать rolling update при изменении секрета

true

rollWorkloadExtraObjects

Добавляет контрольную сумму объектов из extraObjects в аннотации workload, чтобы инициировать rolling update при их изменении

true

commonLabels

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

{}

image.repository

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

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

image.pullSecrets

Список imagePullSecrets для доступа к приватным registry из Pod Vector

[]

image.sha

Digest SHA образа Vector для фиксации точной версии образа

""

replicas

Количество Pod Vector. Используется для ролей Aggregator и Stateless-Aggregator

1

hostAliases

Дополнительные записи в /etc/hosts внутри Pod Vector. Пример конфигурации:

- ip: «127.0.0.1»
  hostnames:
  - «foo.local»
  - «bar.local»

[]

podManagementPolicy

Политика управления Pod StatefulSet для роли Aggregator. Обычно используется OrderedReady или Parallel

OrderedReady

secrets.generic

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

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

{}

autoscaling.enabled

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

false

autoscaling.annotations

Аннотации для ресурса HPA Vector

{}

autoscaling.maxReplicas

Максимальное количество реплик для HPA Vector

10

autoscaling.targetMemoryUtilizationPercentage

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

null

autoscaling.behavior

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

scaleDown:
  stabilizationWindowSeconds: 300

{}

podDisruptionBudget.enabled

Включает создание PodDisruptionBudget для Vector

false

podDisruptionBudget.maxUnavailable

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

null

rbac.create

Создает и использует RBAC-ресурсы. Актуально только для роли Agent

true

psp.create

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

false

serviceAccount.create

Создает ServiceAccount для Vector

true

serviceAccount.name

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

null

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 в privileged-режиме. Здесь это требуется для создания каталогов в /var/lib/vector

true

securityContext.readOnlyRootFilesystem

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

true

command

Переопределяет команду запуска контейнера Vector

[]

args

Переопределяет аргументы запуска контейнера Vector

- –config-dir
- «/etc/vector/»

env

Переменные окружения для контейнеров Vector. По умолчанию задает имя узла через поле Pod. Пример конфигурации:

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

- name: VECTOR_HOST
  valueFrom:
    fieldRef:
      fieldPath: spec.nodeName

envFrom

Импортирует переменные окружения из Secret или ConfigMap. Пример конфигурации:

- secretRef:
    name: vector

[]

containerPorts

Явно задает список containerPorts для Vector и отключает их автоматическую генерацию

[]

resources

Requests и limits ресурсов для контейнеров Vector. Пример конфигурации:

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

{}

lifecycle

Lifecycle hooks для контейнеров Vector, например preStop или postStart. Пример конфигурации:

preStop:
  exec:
    command:
    - /bin/sleep
    - «10»

{}

minReadySeconds

Минимальное количество секунд, которое новый Pod должен успешно проходить проверки, прежде чем будет считаться доступным

0

updateStrategy

Переопределяет стратегию обновления Pod Vector. Для DaemonSet используется DaemonSetUpdateStrategy, для StatefulSet — StatefulSetUpdateStrategy, для Deployment — DeploymentStrategy. Пример конфигурации:

type: RollingUpdate
rollingUpdate:
  maxUnavailable: 1

{}

terminationGracePeriodSeconds

Время в секундах, отводимое контейнерам Vector на корректное завершение работы

60

nodeSelector

Ограничивает размещение Pod Vector узлами с указанными labels

{}

tolerations

Tolerations для размещения Pod Vector на tainted-узлах

- key: node-role.kubernetes.io/master
  operator: Exists
  effect: NoSchedule
- key: node-role.kubernetes.io/control-plane
  operator: Exists
  effect: NoSchedule
- key: dedicated
  operator: Equal
  value: ingress
  effect: NoSchedule
- key: dedicated
  operator: Equal
  value: infra
  effect: NoSchedule
- operator: Exists

affinity

Правила node affinity и pod affinity/anti-affinity для Pod Vector

{}

topologySpreadConstraints

Правила равномерного распределения Pod Vector по доменам топологии. Используется для ролей Aggregator и Stateless-Aggregator

[]

service.enabled

Создает Service для Vector

true

service.annotations

Аннотации для Service Vector

{}

service.ports

Явно задает список портов Service и отключает их автоматическую генерацию

[]

service.internalTrafficPolicy

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

""

service.ipFamilyPolicy

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

""

service.trafficDistribution

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

""

serviceHeadless.enabled

Создает headless Service для Vector

true

ingress.enabled

Создает и использует Ingress для доступа к Vector

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 Service в соответствии с собственной конфигурацией. Имеет приоритет над customConfig и встроенной конфигурацией чарта

[]

dataDir

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

""

customConfig.api.address

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

127.0.0.1:8686

customConfig.api.playground

Включает playground для API Vector

false

customConfig.sources.host_metrics.type

Тип источника для сбора host metrics

host_metrics

customConfig.sources.host_metrics.filesystem.filesystems.excludes

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

- binfmt_misc

customConfig.sources.internal_metrics.type

Тип источника внутренних метрик Vector

internal_metrics

customConfig.sources.kubernetes_logs.type

Тип источника для сбора логов Kubernetes Pod

kubernetes_logs

customConfig.sources.k8s_audit.include

Список файлов audit-логов Kubernetes, которые будет читать Vector

- /var/log/kubernetes/audit.log
- /var/log/kubernetes/audit*.log

customConfig.sources.k8s_audit.ignore_older_secs

Игнорирует файлы старше указанного количества секунд

86400

customConfig.transforms.tag_k8s_pods.inputs

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

- kubernetes_logs

customConfig.transforms.tag_k8s_node.type

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

remap

customConfig.transforms.tag_k8s_node.source

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

.source_type = «k8s_node»

customConfig.transforms.k8s_audit_json.inputs

Список входов для transform разбора audit-логов

- k8s_audit

customConfig.transforms.add_host.type

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

remap

customConfig.transforms.add_host.source

VRL-скрипт, который заполняет поле host из переменной окружения VECTOR_HOST, если оно отсутствует

if !exists(.host)

customConfig.sinks.aggregator.address

Адрес удаленного Vector aggregator для отправки событий

vector-aggregator.dapp-logging.svc.cluster.local:6000

customConfig.sinks.prom_exporter.type

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

prometheus_exporter

customConfig.sinks.prom_exporter.inputs

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

- host_metrics
- internal_metrics

defaultVolumes

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

- name: var-log
  hostPath:
    path: «/var/log/»
- name: var-lib
  hostPath:
    path: «/var/lib/»
- name: procfs
  hostPath:
    path: «/proc»
- name: sysfs
  hostPath:
    path: «/sys»

defaultVolumeMounts

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

- name: var-log
  mountPath: «/var/log/»
  readOnly: true
- name: var-lib
  mountPath: «/var/lib»
  readOnly: true
- name: procfs
  mountPath: «/host/proc»
  readOnly: true
- name: sysfs
  mountPath: «/host/sys»
  readOnly: true

extraVolumes

Дополнительные volumes для Pod Vector

- name: run-log-journal
  hostPath:
    path: /run/log/journal
    type: Directory

- name: etc-machine-id
  hostPath:
    path: /etc/machine-id
    type: File

extraVolumeMounts

Дополнительные volumeMounts для контейнеров Vector

- name: run-log-journal
  mountPath: /run/log/journal
  readOnly: true

- name: etc-machine-id
  mountPath: /etc/machine-id
  readOnly: true

initContainers

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

- 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. Пример конфигурации:

whenDeleted: Retain
whenScaled: Retain

{}

persistence.size

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

10Gi

persistence.selectors

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

{}

persistence.hostPath.path

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

"/var/lib/vector"

dnsPolicy

Политика DNS для Pod Vector

ClusterFirst

dnsConfig

Дополнительная конфигурация DNS для Pod Vector. Пример конфигурации:

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

{}

shareProcessNamespace

Разрешает контейнерам внутри одного Pod Vector использовать общий namespace процессов

false

livenessProbe

Переопределяет стандартную livenessProbe контейнеров Vector. При использовании customConfig требуется включить customConfig.api.enabled. Пример конфигурации:

httpGet:
  path: /health
  port: api

{}

readinessProbe

Переопределяет стандартную readinessProbe контейнеров Vector. При использовании customConfig требуется включить customConfig.api.enabled. Пример конфигурации:

httpGet:
  path: /health
  port: api

{}

podMonitor.enabled

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

false

podMonitor.port

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

prom-exporter

podMonitor.interval

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

null

podMonitor.relabelings

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

[]

podMonitor.podTargetLabels

Список labels Pod, которые нужно перенести на target метрик

[]

podMonitor.honorLabels

Устанавливает honor_labels: true в scrape config

false

logLevel

Уровень логирования Vector, например trace, debug, info, warn, error

"info"

haproxy.enabled

Создает встроенный балансировщик HAProxy для Vector

false

haproxy.image.pullPolicy

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

IfNotPresent

haproxy.image.tag

Тег образа HAProxy

"2.6.12"

haproxy.replicas

Количество Pod HAProxy

1

haproxy.serviceAccount.annotations

Аннотации для ServiceAccount HAProxy

{}

haproxy.serviceAccount.automountToken

Автоматически монтирует API credentials в ServiceAccount HAProxy

true

haproxy.terminationGracePeriodSeconds

Время в секундах, отводимое HAProxy на корректное завершение работы

60

haproxy.podLabels

Labels для Pod HAProxy

{}

haproxy.podSecurityContext

PodSecurityContext для HAProxy. Пример конфигурации:

fsGroup: 2000

{}

haproxy.containerPorts

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

[]

haproxy.service.annotations

Аннотации для Service HAProxy

{}

haproxy.service.ports

Явно задает список портов Service HAProxy и отключает их автоматическую генерацию

[]

haproxy.service.loadBalancerIP

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

""

haproxy.service.ipFamilies

Список IP family для Service HAProxy в dual-stack конфигурации

[]

haproxy.customConfig

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

""

haproxy.extraVolumeMounts

Дополнительные volumeMounts для контейнеров HAProxy

[]

haproxy.extraContainers

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

[]

haproxy.autoscaling.external

Указывает, что HAProxy масштабируется внешним HorizontalPodAutoscaler

false

haproxy.autoscaling.maxReplicas

Максимальное количество реплик для HPA HAProxy

10

haproxy.autoscaling.targetMemoryUtilizationPercentage

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

null

haproxy.resources

Requests и limits ресурсов для HAProxy. Пример конфигурации:

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

{}

haproxy.readinessProbe.tcpSocket.port

TCP-порт для стандартной readinessProbe HAProxy

1024

haproxy.tolerations

Tolerations для Pod HAProxy

[]

extraObjects

Список дополнительных manifest-объектов Kubernetes, которые создаются через values и обрабатываются функцией tpl для шаблонизации. Пример конфигурации:

- apiVersion: v1
  kind: ConfigMap
  metadata:
    name: vector-dashboards
    labels:
      grafana_dashboard: «1»
  data:
    vector.json: |
      

[]