The Cloud Agent Validator is a simple CLI utility that performs various validation checks and send the results as telemetry to the CloudZero API.
The Cloud Agent Validator is a CLI utility designed to perform various validation checks and send the results as telemetry to the CloudZero API. It is intended to be used as part of the pod lifecycle hooks in the cloudzero-agent helm chart. During deployment, the validator runs checks and reports the lifecycle stage and test results to the API.
This utility provides valuable information such as the lifecycle stage, enabling CloudZero to proactively engage with customers if an agent is experiencing issues reporting metrics. It also captures the versions of the chart and Prometheus agent, facilitating issue reproduction. Additionally, it reports check status results and error messages for failing checks, allowing Customer Success teams to quickly identify the root cause of any problems.
The easiest way to get started it by using the cloudzero-agent helm chart. However if you'd like run the validator locally - this is also possible!
If you are using docker, the easiest way to get started by running the following command:
docker run -it --rm ghcr.io/cloudzero/cloudzero-agent-validator/cloudzero-agent-validator:latest cloudzero-agent-validator config generatemkdir config
docker run -it --rm -v ./config:/config ghcr.io/cloudzero/cloudzero-agent-validator/cloudzero-agent-validator:latest cloudzero-agent-validator config generate -f /config/myconfig.yml --account 123456789 --cluster my-cluster-name --region us-east-1You can now open
./config/myconfig.ymland edit values as necessary for your cluster.
In this example we are setting the conifguration value credentials_file to include our production CloudZero API Key. Run the following to create the file:
echo $CZ_API_KEY > config/credentials_fileReplace the value credentials_file: /etc/config/prometheus/secrets/value with credentials_file: /config/credentials_file in config/myconfig.yml
Now validate the configuration file:
docker run -it --rm -v ./config:/config ghcr.io/cloudzero/cloudzero-agent-validator/cloudzero-agent-validator:latest cloudzero-agent-validator config validate -f /config/myconfig.yml
Then run a test to validate the API Token:
docker run -it --rm -v ./config:/config ghcr.io/cloudzero/cloudzero-agent-validator/cloudzero-agent-validator:latest cloudzero-agent-validator diagnose run -f /config/myconfig.yml -check api_key_validWe appreciate feedback and contribution to this repo! Before you get started, please see the following:
Contact support@cloudzero.com for usage, questions, specific cases. See the CloudZero Docs for general information on CloudZero.
Please do not report security vulnerabilities on the public GitHub issue tracker. Email security@cloudzero.com instead.
CloudZero is the only cloud cost intelligence platform that puts engineering in control by connecting technical decisions to business results.:
- Cost Allocation And Tagging Organize and allocate cloud spend in new ways, increase tagging coverage, or work on showback.
- Kubernetes Cost Visibility Understand your Kubernetes spend alongside total spend across containerized and non-containerized environments.
- FinOps And Financial Reporting Operationalize reporting on metrics such as cost per customer, COGS, gross margin. Forecast spend, reconcile invoices and easily investigate variance.
- Engineering Accountability Foster a cost-conscious culture, where engineers understand spend, proactively consider cost, and get immediate feedback with fewer interruptions and faster and more efficient innovation.
- Optimization And Reducing Waste Focus on immediately reducing spend by understanding where we have waste, inefficiencies, and discounting opportunities.
Learn more about CloudZero on our website www.cloudzero.com
This project is licenced under the Apache 2.0 LICENSE.