https://github.com/prometheus/compliance

A set of tests to check compliance with various Prometheus interfaces
https://github.com/prometheus/compliance

Last synced: about 2 months ago
JSON representation

A set of tests to check compliance with various Prometheus interfaces

• Host: GitHub
• URL: https://github.com/prometheus/compliance
• Owner: prometheus
• License: apache-2.0
• Created: 2021-04-07T17:56:39.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-03-23T22:31:55.000Z (over 1 year ago)
• Last Synced: 2024-07-09T01:59:35.656Z (2 months ago)
• Language: Go
• Homepage:
• Size: 306 KB
• Stars: 125
• Watchers: 8
• Forks: 41
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# Prometheus Compliance Tests

This repo contains code to test compliance with various Prometheus standards. Anyone taking part in CNCF's [Prometheus Conformance](https://github.com/cncf/prometheus-conformance) Program will need to run the tests in here against their own implementations.

If you are reading this as someone testing their own implementation or considering to do so: There is a _LOT_ of work that's planned but not executed yet. If you have time or headcount to invest in uplifting everyone's compliance, [please talk to us](https://prometheus.io/community/).

There are several [software categories](https://docs.google.com/document/d/1VGMme9RgpclqF4CF2woNmgFqq0J7nqHn-l72uNmAxhA/) something can be tested in. If something does not seem to fit existing categories, please also talk to us.

## Alert Generator

The [alert_generator](alert_generator/README.md) directory contains a shim at the moment. It will test correct generation and emitting of alerts towards Alertmanager.

## OpenMetrics

The [openmetrics](openmetrics/README.md) directory contains a reference to the [OpenMetrics](https://github.com/OpenObservability/OpenMetrics/blob/main/specification/OpenMetrics.md) test suite.

## PromQL

The [promql](promql/README.md) directory contains code to test compliance with the [native Prometheus PromQL implementation](https://github.com/prometheus/prometheus/tree/main/promql).

## Remote Write Sender

The [remote_write_sender](remote_write_sender/README.md) directory contains code to test compliance with the [Prometheus Remote Write specification](https://docs.google.com/document/d/1LPhVRSFkGNSuU1fBd81ulhsCPR4hkSZyyBj1SZ8fWOM/edit#heading=h.n0d0vphea3fe) as a sender.