Skip to content

topolvm/pie

Repository files navigation

GitHub release (latest by date) Main Go Reference Go Report Card

pie

An application that monitors the availability of Kubernetes storage in end-to-end manner.

Description

pie verifies that PVs are successfully provisioned on the specified nodes for the specified storage classes and that the PVs can be successfully accessed. It outputs the results as metrics.

Supported environments

  • Kubernetes: 1.30, 1.29, 1.28

Getting Started

Running on the cluster

  1. Install pie using Helm:
    helm repo add pie https://topolvm.github.io/pie
    helm install pie
  2. Create a PieProbe resource:
    cat <<EOS | kubectl apply -f -
    apiVersion: pie.topolvm.io/v1alpha1
    kind: PieProbe
    metadata:
      name: pieprobe
    spec:
      monitoringStorageClass: YOUR-STORAGE-CLASS-NAME # This field is mandatory.
      # All other fields are optional.
      nodeSelector:
        nodeSelectorTerms:
        - matchExpressions:
        - key: foo
          operator: DoesNotExist
      probePeriod: 1
      probeThreshold: 10s
    EOS

Prometheus metrics

pie_io_write_latency_on_mount_probe_seconds

IO latency of write, benchmarked on mount-probe Pods.

TYPE: gauge

pie_io_read_latency_on_mount_probe_seconds

IO latency of read, benchmarked on mount-probe Pods.

TYPE: gauge

pie_mount_probe_total

The number of attempts of the creation of the mount-probe Pod object and the creation of the container.

TYPE: counter

pie_performance_on_mount_probe_total

The number of attempts of performing the IO benchmarks on mount-probe Pods.

TYPE: counter

pie_provision_probe_total

The number of attempts of the creation of the provision-probe Pod object and the creation of the container.

TYPE: counter

Contributing

Test It Out

  1. Run unit tests.

    make test
  2. Run e2e test on the local cluster.

    make -C test/e2e create-cluster
    make -C test/e2e test