Migrate_from_vector-agent.md

Migrate from vector-agent guide

To deploy the chart as a DaemonSet, set role: "Agent" in your values.yaml or with Helm arguments. The tolerations option is no longer populated with default values, to match previous behavior you can use the following:

tolerations:
  - key: node-role.kubernetes.io/master
    effect: NoSchedule

There have been a couple minor changes to the default configuration:

• Vector's API is enabled
• A console sink is now included
• The default prometheus_exporter sink was renamed from "prometheus_sink" to "prom_exporter"

To keep the original defaults, use the following customConfig:

customConfig:
  data_dir: /vector-data-dir
  api:
    enabled: false
  sources:
    kubernetes_logs:
      type: kubernetes_logs
    host_metrics:
      filesystem:
        devices:
          excludes: [binfmt_misc]
        filesystems:
          excludes: [binfmt_misc]
        mountPoints:
          excludes: ["*/proc/sys/fs/binfmt_misc"]
      type: host_metrics
    internal_metrics:
      type: internal_metrics
  sinks:
    prometheus_sink:
      type: prometheus_exporter
      inputs: [host_metrics, internal_metrics]
      address: 0.0.0.0:9090

Upgrading

Once you have determined the changes you need to make to your values.yaml the upgrade is as simple as:

helm upgrade -f values.yaml <ORIGINAL_RELEASE_NAME> vector/vector -n <ORIGINAL_NAMESPACE>

Vector values

Old parameter	New parameter	Comment
dataVolume.hostPath.path	persistence.hostPath.path
existingConfigMap and extraConfigDirSources	existingConfigMaps	All ConfigMaps in the existingConfigMaps list are projected into Vector's configuration directory
extraContainersPorts	containerPorts	Ports will be automatically generated from customConfig but can be manually set with containerPorts
globalOptions.*	∅	Deprecated
hostMetricsSource.*	∅	Deprecated
internalMetricsSource.*	∅	Deprecated
image.version, image.base	∅	Only image.tag is now used to set the Vector tag
imagePullSecrets	image.pullSecrets
logSchema.*	∅	Deprecated
kubernetesLogsSource.*	∅	Deprecated
maxUnavailable	∅	maxUnavailable should be passed in as part of the updateStrategy object
podMonitor.additionalLabels	∅
podMonitor.extraRelabelings	podMonitor.relabelings	The chart adds no default relabelings
podRollmeAnnotation andpodValuesChecksumAnnotation	∅	Replaced by rollWorkload, enabled by default
prometheusSink.*	∅	Deprecated
psp.enabled	psp.create
rbac.enabled	rbac.create
secrets.generic	⚠️	secrets.generic now takes raw values rather than base64 encoded values
sinks.*	∅	Deprecated
sources.*	∅	Deprecated
transforms.*	∅	Deprecated
updateStrategy	⚠️	updateStrategy now takes an object instead of a string
vectorApi.*	∅	Deprecated
vectorSink.*	∅	Deprecated