Promitor Changelog

Moving container images from Docker Hub to GitHub Container Registry

Deprecated as of Janurary 1st, 2021 and newer versions will be published to GitHub Container Registry only

Promitor provides Docker images to deploy agents on any container orchestrator supporting either Linux or Windows. You can find them on Docker Hub and easily pull them on your nodes.

In 2020, however, Docker Hub announced changes to their image retention & rate limiting which can impact Promitor customers which is why we are moving our images to GitHub Container Registry.

This allows us to bring our artifacts closer to the project itself and improve how we manage Promitor.

Announcement: GitHub Issue

Impact: Migration is required for newer versions - Use our new Docker images on GitHub Container Registry.

Alternative: None

Discussion: GitHub Discussions

2021-04-1

Helm Chart Registry

Deprecated as of Janurary 1st, 2021 and will be removed on April 1st, 2021

Promitor provides Helm charts to simplify deployments on a Kubernetes cluster which are hosted on Azure Container Registry.

Unfortunately, Azure Container Registry has dedicated URLs that pinpoints the Azure Container Registry instance. This is not ideal given it will break customers if we decide to move our Helm charts elsewhere. Because of this, we are introducing a new Helm chart registry which is hosted on GitHub and served on https://charts.promitor.io/.

This allows us to reduce the cost and avoid the tight-coupling for customers on Microsoft Azure. We are now future-ready in case we need to move our Helm chart registry.

Announcement: GitHub Issue

Impact: Migration is required - Use our new Helm chart registry on https://charts.promitor.io or go to Artifact Hub.

Alternative: None

Discussion: GitHub Discussions

Scraper (Agent) - v2.0.0

released on 2021-01-04
  • added Support for resource discovery (docs | configuration | deployment)
  • added Support for scraping Azure Event Hubs (docs | #69)
  • added Support for scraping Azure Service Bus Namespace (docs | #1392)
  • 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 Support for scraping Azure Kubernetes Service (docs | #333 | Contributed by @jkataja 🎉).
  • added Support for using dimensions with Azure Service Bus (#808)
  • 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 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)
  • added Provide X-Version response header for API endpoints (#1209)
  • added Provide capability to tweak liveness/readines probes in Helm charts (#1350)
  • added Provide capability to expose DNS name for load balancer (AKS) in Helm charts
  • added Provide capability to expose endpoints through an internal load balancer (AKS) in Helm charts (#1402)
  • 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 Health endpoints provide opt-in for including dependency information, instead of always include all dependencies
  • changed Improve time series handling to ensure finalized time series are reported
  • changed service.exposeExternally is renamed to service.loadBalancer.enabled in Promitor Agent Helm chart
  • changed Default name for rbac.serviceAccount.name is now promitor-scraper in Promitor Agent Helm chart
  • 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).
  • fixed (Multi-Dimensional) Metrics that do not have a value/time series are not reported correctly in Prometheus metric sink with metricSinks.prometheusScrapingEndpoint.metricUnavailableValue (#1197 | FAQ).
  • removed Support for scraping Azure Service Bus Queue, use Azure Service Bus Namespace scraper instead
  • removed Support for Prometheus legacy configuration (deprecation notice | migration guide)
  • removed Support for Helm 2.0 (deprecation notice | Helm migration guide)
  • removed Support for Swagger UI 2.0 (deprecation notice | migration guide)
  • removed Support for Swagger 2.0 (deprecation notice | migration guide)
  • removed service.labelType & service.selectorType are no longer available in Promitor Scraper Helm chart

Learn how to migrate to 2.0 with our migration guide.

Full release notes can be found here.

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.

Scraper (Agent) - v1.1.0

released on 2020-01-07
  • added Support for all Azure clouds (docs | FAQ | #114)
  • added Multi-dimensional metric support (docs | FAQ | #81)
  • added Azure SQL Database Scraper (docs | #317 | Contributed by @adamconnelly 🎉)
  • added Azure SQL Managed Instance Scraper (docs | #381)
  • added OpenAPI v3.0 support (/api/v1/docs.json | docs | #734)
  • added OpenAPI UI based on OpenAPI v3.0 (/api/docs/ | docs | #734)
  • added Provide traces in Azure Application Insights (docs | #29)
  • added Introduce Frequently asked questions (FAQs) in documentation (FAQs)
  • changed Helm Chart creates apps/v1 Deployment instead of v1beta1 (#669 | Contributed by @ekeih 🎉)
  • changed Provide exceptions in Azure Application Insights for all exceptions, not just scraping (docs | #29)

Full release notes can be found here.

Scraper (Agent) - v1.0.0

released on 2019-09-18
  • added Azure Cache for Redis Scraper (docs | #335 | Contributed by @jcorioland 🎉)
  • added Azure Container Instances Scraper (docs | #326)
  • added Azure Container Registry Scraper (docs | #325)
  • added Azure Cosmos DB Scraper (docs | #329 | Contributed by @cesar-younes 🎉)
  • added Azure Database for PostgreSQL Scraper (docs | #322 | Contributed by @jcorioland 🎉)
  • added Azure Storage Queue Scraper (docs | #64 | Contributed by @michaelkruglos 🎉)
  • added Azure VM Scraper (docs | #309 | Contributed by @melmaliacone 🎉)
  • added Azure Virtual Network Scraper (docs | #330 | Contributed by @rguthriemsft 🎉)
  • added Provide labels for resource information per metric (docs | #598)
  • added Provide capability to specify custom labels per metric (docs | #603)
  • added Support runtime configuration YAML (docs | #431)
  • added Provide Get Runtime Configuration API endpoint (docs | #638)
  • added Provide capability to configure the metric aggregation interval per metric (docs | #256)
  • added Provide capability to configure a default metric aggregation interval (docs | #257)
  • added Provide capability to configure the scraping interval per metric (docs | #258 | Contributed by @brandonh-msft 🎉)
  • added Provide Kubernetes Helm Chart (docs | #17 | Contributed by @lee0c, @cnadolny, @immuzz 🎉)
  • added Provide capability to influence unreported metric value (docs | #546)
  • added Provide promitor_ratelimit_arm metric to report ARM throttling limit (docs | #199)
  • added Provide support for scraping multiple resource groups (docs | #294 | Contributed by @brusMX 🎉)
  • added Provide capability to scrape multiple resources under on metrics, aggregated with labels per resource (docs | #513 | Contributed by @adamconnelly 🎉)
  • added End-to-end walkthrough how to deploy Promitor, Prometheus, and Grafana on an AKS Cluster (walkthrough)
  • added Ability to reduce logging output (docs | #551)
  • added Provide timestamps in logging (#571)
  • security Mitigation for vulnerability CVE-2019-1302 (announcement | #706)
  • security Mitigation for vulnerability CVE-2018-8269 (announcement | #707)
  • changed Rename Docker image to promitor-agent-scraper (docs | #393)
  • changed Provide versioning for metrics declaration declaration (docs | #646)
  • changed Use Alphine as base Docker image instead of Debian (#610)
  • changed Default Prometheus endpoint is now /metrics (docs | #461)
  • changed Move default scraping interval to metrics configuration (docs | #259 | Contributed by @brandonh-msft 🎉)
  • changed Provide information in health endpoint (docs | #634)

Full release notes can be found here.