prometheus-http-query

Added

• InstantQueryBuilder::query
• RangeQueryBuilder::query

All changes by courtesy of @alesharik via pull request.

Added

• InstantQueryBuilder::get_raw
• InstantQueryBuilder::post_raw
• RangeQueryBuilder::get_raw
• RangeQueryBuilder::post_raw
• LabelNamesQueryBuilder::get_raw
• LabelValuesQueryBuilder::get_raw
• MetricMetadataQueryBuilder::get_raw
• RulesQueryBuilder::get_raw
• SeriesQueryBuilder::get_raw
• TargetMetadataQueryBuilder::get_raw

All changes by courtesy of @VoltaireNoir via pull request.

Added

• Derive Copy on Sample
• Data::as_vector_mut
• Data::as_matrix_mut
• Data::as_scalar_mut
• Data::into_vector
• Data::into_matrix
• Data::into_sample
• PromqlResult::into_inner

Changed

• Data::as_vector returns Option<&Vec<InstantVector>> now
• Data::as_matrix returns Option<&Vec<RangeVector>> now

Note that this is technically a breaking release due to the altered function signatures of the two functions above. These functions formerly returned Option<&[InstantVector]>. However thanks to Rust's type coercions rules the changes are actually not expected to break any code, since the returned vector is yet again coerced to a slice when accessed immutably.

All changes by courtesy of @VoltaireNoir via pull request.

Added

• ClientError::inner()
• ParseUrlError::inner()

Added

• RuleGroup::limit()
• RuleGroup::last_evaluation()
• RuleGroup::evaluation_time()
• AlertingRule::last_evaluation()
• AlertingRule::evaluation_time()
• RecordingRule::last_evaluation()
• RecordingRule::evaluation_time()
• Rule::as_recording()
• Rule::as_alerting()
• impl Eq for RuleHealth
• RuleHealth::is_good()
• RuleHealth::is_bad()
• RuleHealth::is_unknown()
• impl Eq for AlertState
• AlertState::is_inactive()
• AlertState::is_pending()
• AlertState::is_firing()
• impl Eq for TargetHealth
• TargetHealth::is_up()
• TargetHealth::is_down()
• TargetHealth::is_unknown()
• impl Eq for MetricType
• MetricType::is_counter()
• MetricType::is_gauge()
• MetricType::is_histogram()
• MetricType::is_gauge_histogram()
• MetricType::is_summary()
• MetricType::is_info()
• MetricType::is_stateset()
• MetricType::is_unknown()
• AlertingRule::keep_firing_for()
• impl Eq for WalReplayState
• WalReplayState::is_waiting()
• WalReplayState::is_in_progress()
• WalReplayState::is_done()

Changed

Among other changes some Client methods have been refactored and return "builders" (like Client::query and Client::query_range already did) to gradually build a query to the respective endpoint instead of having to pass a lot of arguments to a single function and also having to pass None a lot to use the "default" functionality of the given Prometheus API endpoint. The following Client methods were refactored in that fashion:

• Client::rules()
• Client::target_metadata()
• Client::metric_metadata()
• Client::series()
• Client::label_names()
• Client::label_values()

Other changes include:

• Renamed RuleType to RuleKind and its variants from Alert and Record to Alerting and Recording.
• Alert::value() now returns f64.
• Client::query, Client::query_range direct::query and direct::query_range now require the PromQl query string to implement std::fmt::Display instead of std::string::ToString.
• Refactored deserialization of Prometheus server responses so the explicit dependency on serde_json could be removed.
• Refactored the error module and some custom errors related to deserialization using serde::de::Error. The Error enum inside the error module now contains one variant less and existing error variants were improved by properly implementing std::error::Error::source(). Libraries like anyhow are now able to display more detailed error messages. This change is not breaking if you did not match on specific error enum variants before.
• Client methods now return a more concise error if the server response (from Prometheus or an intermediate proxy) does not contain a Content-Type header identifying the payload as JSON, that is the media type from the response is not as expected.

Fixed

• Fixes an issue where a Prometheus server sends an HTTP response with Content-Type: application/json; charset=utf-8 (see issue)

Added

• InstantQueryBuilder::header and RangeQueryBuilder::header (see also PR #6, thank you @lasantosr)

Added

• Added several feature flags pertaining to the client TLS configuration that match the feature flags of reqwest by the same name.