Skip to main content

HostPath Mapper


Pro Feature

This feature is available in the vCluster Pro tier. Contact us for more details and to start a trial.

Virtual cluster internal logging relies on a separate component called the HostPath Mapper. This component resolves the virtual pod and container names to their physical counterparts.

If you don't map host paths, logs for vCluster pods are incorrectly resolved by log collectors such as Loki, ELK, and Fluentd.

vCluster open source

Set enabled: true to configure vCluster to deploy a HostPath Mapper DaemonSet per Node per vCluster instance.

vCluster pro

The Centralized HostPath Mapper feature supports the following use cases in the virtual cluster:

  • Container-based logging used by tools such as fluentd and Logstash.
  • Pod-based logging used by Grafana Loki.
  • Velero restic backups.
  • KubeVirt workloads.

Set central: true to configure vCluster to deploy one HostPath Mapper DaemonSet that is used by multiple virtual clusters.

Config reference

hostPathMapper required object pro

HostPathMapper defines if vCluster should rewrite host paths.

enabled required boolean pro

Enabled specifies if the host path mapper will be used

central required boolean pro

Central specifies if the central host path mapper will be used