Metrics for PowerScale is part of Dell Container Storage Modules (CSM) for Observability, which provides Kubernetes administrators standardized approaches for storage observability in Kuberenetes environments.
Metrics for PowerScale is an open source distributed solution that provides insight into storage usage and performance as it relates to the CSI (Container Storage Interface) Driver for Dell PowerScale.
Metrics for PowerScale captures telemetry data of storage usage and performance obtained through the CSI Driver for Dell PowerScale. The Metrics service pushes it to the OpenTelemetry Collector, so it can be processed, and exported in a format consumable by Prometheus. Prometheus can then be configured to scrape the OpenTelemetry Collector exporter endpoint to provide metrics so they can be visualized in Grafana.
For documentation, please visit Container Storage Modules documentation.
- Code of Conduct
- Maintainer Guide
- Committer Guide
- Contributing Guide
- List of Adopters
- Support
- Security
- About
If you wish to clone and build the Metrics for PowerScale service, a Linux host is required with the following installed:
Component | Version | Additional Information |
---|---|---|
Docker | v19+ | Docker installation |
Docker Registry | Access to a local/corporate Docker registry | |
Golang | v1.18+ | Golang installation |
gosec | gosec | |
gomock | v.1.6.0 | Go Mock |
git | latest | Git installation |
gcc | Run sudo apt install build-essential |
|
kubectl | 1.23.5 | Ensure you copy the kubeconfig file from the Kubernetes cluster to the linux host. kubectl installation |
Helm | v.3.8.1 | Helm installation |
Once all prerequisites are on the Linux host, follow the steps below to clone and build the metrics service:
- Clone the repository using the following command:
git clone https://github.com/dell/csm-metrics-powerscale.git
- Set the DOCKER_REPO environment variable to point to the local Docker repository, for example:
export DOCKER_REPO=<ip-address>:<port>
- In the csm-metrics-powerscale directory, run the following command to build the Docker image called csm-metrics-powerscale:
make docker
- Tag (with the "latest" tag) and push the image to the local Docker repository by running the following command:
make tag push
Note: Linux support only. If you are using a local insecure docker registry, ensure you configure the insecure registries on each of the Kubernetes worker nodes to allow access to the local docker repository.
From the root directory where the repo was cloned, the unit tests can be executed using the following command:
make test
This will also provide code coverage statistics for the various Go packages.
This project is adhering to Semantic Versioning.
Dell Container Storage Modules (CSM) is 100% open source and community-driven. All components are available under Apache 2 License on GitHub.