Vector-aggregator#

nameOverride

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

""

fullnameOverride

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

""

role

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

"Aggregator"

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

2

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

true

podDisruptionBudget.maxUnavailable

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

null

rbac.create

Создает и использует RBAC-ресурсы. В исходном чарте отмечен как параметр, актуальный только для роли Agent

true

psp.create

Создает ресурс PodSecurityPolicy. 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

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

{}

workloadResourceAnnotations

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

{}

securityContext

SecurityContext для контейнеров Vector

{}

command

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

[]

args

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

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

env

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

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

[]

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-узлах

[]

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.datadog_agent.address

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

0.0.0.0:8282

customConfig.sources.fluent.address

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

0.0.0.0:24224

customConfig.sources.internal_metrics.type

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

internal_metrics

customConfig.sources.logstash.type

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

logstash

customConfig.sources.splunk_hec.type

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

splunk_hec

customConfig.sources.statsd.mode

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

tcp

customConfig.sources.syslog.address

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

0.0.0.0:9000

customConfig.sources.syslog.type

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

syslog

customConfig.sources.vector.type

Тип источника для приема событий от других экземпляров Vector

vector

customConfig.transforms.ensure_source_type.type

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

remap

customConfig.transforms.ensure_source_type.source

VRL-скрипт, который добавляет значение external в поле source_type, если оно отсутствует

if !exists(.source_type)

customConfig.transforms.add_cluster.inputs

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

- ensure_source_type

customConfig.transforms.add_unit_hint.type

Тип transform для добавления подсказки unit для логов узла и внешних источников

remap

customConfig.transforms.add_unit_hint.source

VRL-скрипт, который пытается определить systemd unit из systemd.unit или SYSLOG_IDENTIFIER и сохраняет его в поле unit

if .source_type == «k8s_node»

customConfig.transforms.route_streams.inputs

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

- add_unit_hint

customConfig.transforms.route_streams.route.pods

Условие маршрута для логов Pod Kubernetes

“.source_type == «k8s_pods»“

customConfig.transforms.normalize_pod_labels.type

Тип transform для нормализации pod labels перед отправкой в Loki

remap

customConfig.transforms.normalize_pod_labels.source

VRL-скрипт, который извлекает ключевые pod labels в отдельные поля и подставляет unknown, если label отсутствует

if exists(.kubernetes) && exists(.kubernetes.pod_labels) && exists(.kubernetes.pod_labels.app) {
  .app = .kubernetes.pod_labels.app
} else {
  .app = «unknown»
}

if exists(.kubernetes) && exists(.kubernetes.pod_labels) && exists(.kubernetes.pod_labels.»app.kubernetes.io/name») {
  .app_kubernetes_io_name = .kubernetes.pod_labels.»app.kubernetes.io/name»
} else {
  .app_kubernetes_io_name = «unknown»
}

if exists(.kubernetes) && exists(.kubernetes.pod_labels) && exists(.kubernetes.pod_labels.»app.kubernetes.io/instance») {
  .app_kubernetes_io_instance = .kubernetes.pod_labels.»app.kubernetes.io/instance»
} else {
  .app_kubernetes_io_instance = «unknown»
}

customConfig.sinks.loki_pods.endpoint

HTTP endpoint Loki для записи логов Pod

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

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

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

k8s-pods

customConfig.sinks.loki_pods.labels.source_type

Шаблон label source_type для логов Pod в Loki

“{{ source_type » }}“

customConfig.sinks.loki_pods.labels.namespace

Шаблон label namespace для логов Pod в Loki

“{{ kubernetes.pod_namespace » }}“

customConfig.sinks.loki_pods.labels.container

Шаблон label container для логов Pod в Loki

“{{ kubernetes.container_name » }}“

customConfig.sinks.loki_pods.labels.app_kubernetes_io_name

Шаблон label 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 endpoint Loki для записи логов узлов

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

customConfig.sinks.loki_node.encoding.codec

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

json

customConfig.sinks.loki_node.batch.max_bytes

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

1048576

customConfig.sinks.loki_node.batch.timeout_secs

Таймаут batch перед отправкой логов узлов

2

customConfig.sinks.loki_node.request.rate_limit_duration_secs

Интервал rate limit для запросов sink логов узлов

1

customConfig.sinks.loki_node.request.retry_initial_backoff_secs

Начальный backoff повторных попыток sink логов узлов

1

customConfig.sinks.loki_node.request.timeout_secs

Таймаут HTTP-запроса sink логов узлов

30

customConfig.sinks.loki_node.buffer.max_size

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

268435256

customConfig.sinks.loki_node.labels.job

Статическая label job для логов узлов в Loki

k8s-node

customConfig.sinks.loki_node.labels.source_type

Шаблон label source_type для логов узлов в Loki

“{{ source_type » }}“

customConfig.sinks.loki_node.labels.unit

Шаблон label unit для логов узлов в Loki

“{{ unit » }}“

customConfig.sinks.loki_audit.type

Тип sink для отправки audit-логов Kubernetes в Loki

loki

customConfig.sinks.loki_audit.inputs

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

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

Шаблон label cluster для audit-логов Kubernetes в Loki

“{{ cluster » }}“

customConfig.sinks.loki_audit.labels.host

Шаблон label host для audit-логов Kubernetes в Loki

“{{ host » }}“

customConfig.sinks.loki_audit.labels.apiGroup

Шаблон label apiGroup для audit-логов Kubernetes в Loki

“{{ apiGroup » }}“

customConfig.sinks.loki_audit.labels.subresource

Шаблон label subresource для audit-логов Kubernetes в Loki

“{{ subresource » }}“

customConfig.sinks.loki_audit.labels.code

Шаблон label code для audit-логов Kubernetes в Loki

“{{ code » }}“

customConfig.sinks.prom_exporter.type

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

prometheus_exporter

customConfig.sinks.prom_exporter.inputs

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

- 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»
- name: run-log-journal
  hostPath:
    path: /run/log/journal
    type: Directory
- name: etc-machine-id
  hostPath:
    path: /etc/machine-id
    type: File

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
- name: run-log-journal
  mountPath: /run/log/journal
  readOnly: true
- name: etc-machine-id
  mountPath: /etc/machine-id
  readOnly: true

extraVolumes

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

[]

extraVolumeMounts

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

[]

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: |
      

[]