Promitor Changelog

2020-05-15

Prometheus Legacy Configuration

Deprecated as of v1.6 and will be removed in v2.0

Promitor has added support for different metric sinks in v1.6 along with a Prometheus Scraping endpoint sink.

This scraping endpoint works the same way as before but has a different way of configuration which is more in line with other sinks.

Because of that we are removing support for the “legacy” Prometheus configuration and use a unified metric sink approach.

We’ve added support for Prometheus metric sink while maintaining the legacy approach until it’s being removed.

Impact: Migration is required - Prometheus legacy configuration will no longer be available.

Alternative: Use our new metric sink concept.

Discussion: GitHub Issue #1032

2020-01-07

Swagger 2.0

Deprecated as of v1.1 and will be removed in v2.0

OpenAPI v3.0 has been released in 2017 which is the new industry standard. With Promitor, we want to support that standard and have decided to go forward with 3.0 instead of 2.0.

We’ve added support for OpenAPI 3.0 in Promitor v1.1 next to Swagger 2.0 so you can migrate to it before we remove 2.0 in Promitor v2.0.

Impact: Migration is required - API documentation will no longer be available.

Alternative: Use API documentation provided in OpenAPI v3.0 format.

Discussion: GitHub Issue #782

2020-01-07

Swagger UI 2.0

Deprecated as of v1.1 and will be removed in v2.0

OpenAPI v3.0 has been released in 2017 which is the new industry standard. With Promitor, we want to support that standard and have decided to go forward with 3.0 instead of 2.0.

We’ve added support for OpenAPI 3.0 in Promitor v1.1 next to Swagger 2.0 along with OpenAPI UI 3.0.

Impact: Migration is required - Swagger UI 2.0 will no longer be available.

Alternative: Use OpenAPI UI 3.0.

Discussion: GitHub Issue #781

  • added Support for resource discovery (docs | configuration | deployment)
  • added Support for scraping Azure Event Hubs (docs | #372)
  • added Support for scraping Azure Logic Apps (docs | #314).
  • added Support for scraping Azure Express Route circuits (docs | #1251 | Contributed by @bluepixbe 🎉).
  • added Support for scraping Azure Application Gateway (docs | #1251 | Contributed by @bluepixbe 🎉).
  • added Support for scraping Azure Network Gateway (docs | #1264 | Contributed by @bluepixbe 🎉).
  • added New validation rule to ensure at least one resource or resource collection is configured to scrape
  • added Provide suggestions when unknown fields are found in the metrics config. (#1105 | Contributed by @adamconnelly 🎉).
  • added Add validation to ensure the scraping schedule is a valid Cron expression. (#1103 | Contributed by @adamconnelly 🎉).
  • added Provide support for pushing metrics to Atlassian Statuspage (docs | #1152)
  • added Provide suggestions when unknown fields are found in the metrics config. (#1105 | Contributed by @adamconnelly 🎉).
  • added New validation rule to ensure the scraping schedule is a valid Cron expression. (#1103).
  • added New validation rule to ensure declarative or dynamic discovery for metrics to scrape are configured
  • added New System API endpoint giving runtime information (docs | #1208)
  • changed Show Promitor version during startup
  • changed Provide capability to scrape all queues in Azure Service Bus, instead of having to declare the queue name. (#529).
  • changed Handle validation failures on startup more gracefully. (#1113 | Contributed by @adamconnelly 🎉).
  • changed Improve time series handling to ensure finalized time series are reported
  • fixed Ensure Prometheus metric sink does write timestamps (#1217).
  • fixed Dimensions with / in name are now supported by replacing it with _ for Prometheus metric sink (#1248).
  • removed Support for Prometheus legacy configuration (deprecation notice | migration guide)
  • removed Support for Swagger UI 2.0 (deprecation notice | migration guide)
  • removed Support for Swagger 2.0 (deprecation notice | migration guide)

Learn how to migrate to 2.0 with our migration guide.

Scraper (Agent) - v2.0.0-preview-3

released on 2020-09-11

This preview is a cummulative update to v2.0.0-preview-2 with various fixes and following new features:

  • added Support for scraping Azure Express Route circuits (docs | #1251 | Contributed by @bluepixbe 🎉).
  • added Support for scraping Azure Application Gateway (docs | #1251 | Contributed by @bluepixbe 🎉).
  • changed Show Promitor version during startup
  • fixed Ensure Prometheus metric sink does write timestamps (#1217).
  • fixed Dimensions with / in name are now supported by replacing it with _ for Prometheus metric sink (#1248).

Learn how to migrate to 2.0 with our migration guide.

Scraper (Agent) - v2.0.0-preview-2

released on 2020-08-10

This preview is a cummulative update to v2.0.0-preview-1 with various fixes and following new features:

  • added Support for scraping Azure Event Hubs (docs | #372)
  • changed Provide capability to scrape all queues in Azure Service Bus, instead of having to declare the queue name. #529.

Learn how to migrate to 2.0 with our migration guide.

Scraper (Agent) - v2.0.0-preview-1

released on 2020-07-29
  • added Support for resource discovery (docs | configuration | deployment)
  • added Support for scraping Azure Logic Apps (docs | #314)
  • added New validation rule to ensure at least one resource or resource collection is configured to scrape
  • added Provide suggestions when unknown fields are found in the metrics config. (#1105 | Contributed by @adamconnelly 🎉).
  • added Add validation to ensure the scraping schedule is a valid Cron expression. (#1103 | Contributed by @adamconnelly 🎉).
  • added Provide support for pushing metrics to Atlassian Statuspage (docs | #1152)
  • added Provide suggestions when unknown fields are found in the metrics config. (#1105 | Contributed by @adamconnelly 🎉).
  • added New validation rule to ensure the scraping schedule is a valid Cron expression. #1103.
  • added New validation rule to ensure declarative or dynamic discovery for metrics to scrape are configured
  • changed Handle validation failures on startup more gracefully. (#1113 | Contributed by @adamconnelly 🎉).
  • changed Improve time series handling to ensure finalized time series are reported
  • removed Support for Prometheus legacy configuration (deprecation notice | migration guide)
  • removed Support for Swagger UI 2.0 (deprecation notice | migration guide)
  • removed Support for Swagger 2.0 (deprecation notice | migration guide)

Learn how to migrate to 2.0 with our migration guide.

Scraper (Agent) - v1.6.1

released on 2020-06-01
  • fixed Ensure scraping jobs have unique names to ensure all resources are scraped
  • fixed Service Bus queue metrics are not reported correctly for entities in same namespace (#1050)
  • fixed ratelimit_arm reported instead of promitor_ratelimit_arm for Prometheus sink (#1056)
  • fixed Runtime config for metrics sinks is not working correctly (#1052)
  • removed Default Prometheus configuration since we have multiple metric sinks nowadays. We are removing this since you cannot have duplicate Prometheus scraping endpoints. If you omit legacy configuration it will use /metrics as a default value which forces you to use different endpoint in the Prometheus metric sink.

Full release notes can be found here.

Scraper (Agent) - v1.6.0

released on 2020-05-15

Full release notes can be found here.

Scraper (Agent) - v1.5.0

released on 2020-04-06
  • added Support for scraping multiple subscriptions (docs | #761)

Full release notes can be found here.

Scraper (Agent) - v1.4.0

released on 2020-03-20
  • added Support for Helm 3 (Helm Hub)
  • added Support for Windows containers (docs | image tagging strategy | #67)
  • added Support Prometheus service discovery in Helm chart (#861)
  • added Capability to gain insights on Azure Monitor integration (docs | #848)
  • changed Improve metrics configuration validation (#592 | Contributed by @adamconnelly 🎉)

Full release notes can be found here.

Scraper (Agent) - v1.3.0

released on 2020-01-30

Full release notes can be found here.

Scraper (Agent) - v1.2.1

released on 2020-01-15
  • security Patch for CVE-2020-0602 ASP.NET Core Denial of Service Vulnerability (notice)
  • security Patch for CVE-2020-0603 ASP.NET Core Remote Code Execution Vulnerability (notice)
  • fixed Correctly expose OpenAPI 3.0 documentation & UI (issue)

Full release notes can be found here.

Scraper (Agent) - v1.2.0

released on 2020-01-10
  • added Azure Virtual Machine Scale Set Scraper (docs | #310)
  • added Azure App Plan Scraper (docs | #315)
  • added Azure Web App Scraper (docs | #762)
  • added Azure Function App Scraper (docs | #366)
  • changed Metric labels for dimensions are now always lower-cased

Full release notes can be found here.