host-linux-lvm datasource

The host-linux-lvm datasource collects information about LVM components from the operating system on Linux hosts and creates metric data points, entities, and events.Events

Metrics

Metric data points include the following groups and name styles:

Physical volumes

Name	Units	Description
`lvm_physical_vol.free`	bytes	The amount of available free space
`lvm_physical_vol.size`	bytes	The size of a physical volume
`lvm_physical_vol.used`	bytes	The amount of used space on a physical volume
`lvm_physical_vol.utilization`	percent	The percentage of utilized space on a physical volume

Logical volumes

Name	Units	Description
`lvm_logical_vol.data_utilization`	percent	The percentage of utilized data space on a logical volume
`lvm_logical_vol.metadata_utilization`	percent	The percentage of utilized metadata space on a logical volume
`lvm_logical_vol.size`	bytes	The size of a logical volume

Volume groups

Name	Units	Description
`lvm_vol_group.free`	bytes	The amount of available free space
`lvm_vol_group.logical_volume_count`	logical volumes	The number of logical volumes in a volume group
`lvm_vol_group.physical_volume_count`	physical volumes	The number of physical volumes in a volume group
`lvm_vol_group.size`	bytes	The size of a volume group
`lvm_vol_group.snapshot_count`	snapshots	The number of snapshots in a volume group
`lvm_vol_group.utilization`	percent	The percentage of utilized space in a volume group

Name styles

This datasource supports two mutually exclusive naming styles for the metrics that it collects:canonical: The default style, which features namespace prefixes.linuxMonitorZenPack: The legacy style, used in the Linux Monitor ZenPack.To change the default style, set the metric-names-variant property in the datasource section to linuxMonitorZenPack.

Physical volumes

Canonical style	ZenPack style
`lvm_physical_vol.size`	`physical_vol_size`
`lvm_physical_vol.free`	`physical_vol_free`
`lvm_physical_vol.used`	`physical_vol_used`
`lvm_physical_vol.utilization`	`physical_vol_used_percent`

Logical volumes

Canonical style	ZenPack style
`lvm_logical_vol.size`	`logical_vol_size`
`lvm_logical_vol.data_utilization`	`logical_vol_data_percent`
`lvm_logical_vol.metadata_utilization`	`logical_vol_metadata_percent`

Volume groups

Canonical style	ZenPack style
`lvm_vol_group.size`	`group_size`
`lvm_vol_group.free`	`group_free`
`lvm_vol_group.utilization`	`group_used_percent`
`lvm_vol_group.physical_volume_count`	`group_physical_volume_count`
`lvm_vol_group.logical_volume_count`	`group_logical_volume_count`
`lvm_vol_group.snapshot_count`	`group_snapshot_count`

Entities

Entities include the following:

Physical volumes

Property	Description
`name`	The physical volume name
`uuid`	The unique identifier of a physical volume
`attributes`	The LVM attributes associated with a physical volume
`format`	The LVM format of a physical volume
`vol_group`	The parent volume group’s name

Example

```json
{
    "attributes": "a--",
    "format": "lvm2",
    "name": "/dev/sdg1",
    "uuid": "eNZVAN-x1xU-LuEF-ovHr-Kj0Z-384q-fHr1aI",
    "vol_group": "docker"
}
```

Logical volumes

Property	Description
`name`	The logical volume name
`uuid`	The unique identifier of a logical volume
`attributes`	The LVM attributes associated with a logical volume
`vol_group`	The parent volume group’s name
`major_minor`	The major and minor kernel number for the device
`mountpoint`	The filesystem location where this logical volume is mounted

Example

```json
{
  "attributes": "twi-aotz--",
  "major_minor": "2:15",
  "mountpoint": "/var/data",
  "name": "docker-pool",
  "uuid": "muYIjb-hktL-VzSe-rxTv-4Qjb-ojhs-AF4UqR",
  "vol_group": "docker"
}
```

Volume groups

Property	Description
`name`	The volume group name
`uuid`	The unique identifier of a volume group
`attributes`	The LVM attributes associated with a volume group

Example

```json
{
  "attributes": "wz--n-",
  "name": "docker",
  "uuid": "ocFfVp-jcca-Kw8W-3y1y-POYr-2Vy9-8kG8V8"
}
```

Events

For normal changes, events have a severity of INFO. Otherwise, they have a severity of WARNING.

Physical volumes

Physical Volume allocatable_Event: A change in the allocation status of a physical volume.

Physical Volume exported_Event : A change in the export status of a physical volume.

Physical Volume missing_Event

A change in the presence status of a physical volume.

{
  "name": "Physical Volume allocatable_Event",
  "component": "/dev/sdg1",
  "device": "ServerStation1",
  "source": "example_server_zdm_host",
  "eventClass": "/Status",
  "summary": "Physical Volume '/dev/sdg1' is allocatable.",
  "body": "Physical Volume '/dev/sdg1' is allocatable.",
  "severity": "SEVERITY_INFO",
  "status": "STATUS_OPEN"
}

Logical volumes

Logical Volume state_Event

A change in the state of a logical volume.

Logical Volume health_Event

A logcial volume health event.

{
  "name": "Logical Volume health_Event",
  "component": "docker-pool",
  "device": "ServerStation1",
  "source": "example_server_zdm_host",
  "eventClass": "/Status",
  "summary": "Logical Volume 'docker-pool' is healthy.",
  "body": "Logical Volume 'docker-pool' is healthy.",
  "severity": "SEVERITY_INFO",
  "status": "STATUS_OPEN"
}

Volume groups

Volume Group partial_Event

A change in the status of a volume group (for example, when a physical disk is removed from a volume group that contains multiple physical disks).

{
  "name": "Volume Group partial_Event",
  "component": "docker",
  "device": "ServerStation1",
  "source": "example_server_zdm_host",
  "eventClass": "/Status",
  "summary": "Volume group 'docker' is in 'Partial' state.",
  "body": "Volume group 'docker' is in 'Partial' state.",
  "severity": "SEVERITY_WARNING",
  "status": "STATUS_OPEN"
}

Configuration

If you specify the host-linux-lvm datasource during installation, its configuration file is placed in the following location:

/etc/zendatamon-configs/configs/host-linux-lvm.config.yaml

Otherwise, you must copy it from the templates directory:

cp /etc/zendatamon-configs/.templates/.configs/host-linux-lvm.config.yaml \
  /etc/zendatamon-configs/configs/host-linux-lvm.config.yaml

The Virtana Service Observability agent service monitors the /etc/zendatamon-configs/configs directory and loads any new or changed configuration files immediately.

Properties

interval (number): The number of seconds to wait between collection attempts. This value overrides the defaultInterval value in the Virtana Service Observability agent service configuration file.
timeout (number): The number of seconds to wait before dropping a collection attempt.
metric-names-variant (string, default = canonical): The metric name style, either canonical or linuxMonitorZenPack.
protocol (string, default = local): Collection type; only local is supported, so this key can be omitted.
use-sudo (boolean, default = false): Whether to use sudo to run the vgs, lvs, and pvs commands.

Example

apiVersion: v1
kind: datasource
name: host-linux-lvm
spec:
  type: host-linux-lvm
  datasource:
    interval: 60
    timeout: 30
    metric-names-variant: canonical
    protocol: ""
    use-sudo: true

In this section:

host-linux-lvm datasource

Metrics

Physical volumes

Logical volumes

Volume groups

Name styles

Physical volumes

Logical volumes

Volume groups

Entities

Physical volumes

Example

Logical volumes

Example

Volume groups

Example

Events

Physical volumes

Logical volumes

Volume groups

Configuration

Properties

Example

Search results