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

Service Principle identity is moved to runtime configuration

Deprecated as of April 5th, 2021 and will be removed in new major version

Promitor has been using service principle authentication from its inception where the identity inforation was configured through the following environment variables:

  • PROMITOR_AUTH_APPKEY
  • PROMITOR_AUTH_APPID

However, as of Promitor Scraper v2.2.0 & Resource Discovery v0.3.0, users can choose how agents authenticate to Microsoft Azure by declaring the authentication mode in the server configuration:

authentication:
  # Options are ServicePrincipal, SystemAssigedManagedIdentity, UserAssigedManagedIdentity.
  mode: ServicePrincipal
  identityId: xxxx-xxxx-xxxx

With this new approach, users can use Managed Identity authentication leveraging no-secret authentication or keep on using Service Principle authentication.

Announcement: GitHub Issue

Impact: Migration is required - Use the authentication configuration to specify Service Principle authentication and configure the identity id in the server configuration.

Alternative: None

Discussion: GitHub Discussions

Scraper

None.

Resource Discovery

None.

Resource Discovery - v0.4.0

released on 2021-05-07
  • added Provide scraper for Azure Monitor Autoscale (docs | #1593)

Full release notes can be found here.

Scraper - v2.3.0

released on 2021-05-07
  • added Provide scraper for Azure Monitor Autoscale (docs | #1593)
  • added Provide capability to transform metric labels in Prometheus (docs)
  • added Provide capability to limit the amount of resources to query when using filters/dimensions (docs | #1596)
  • added Provide capability to define default custom labels (docs | #1608)

Full release notes can be found here.

Resource Discovery - v0.3.0

released on 2021-04-05

Full release notes can be found here.

Scraper - v2.2.0

released on 2021-04-05

Full release notes can be found here.

Scraper - v2.1.1

released on 2021-03-03
  • fixed Issue when metric (values) where not found causing exceptions to be thrown (#1545)

Full release notes can be found here.

Scraper - v2.1.0

released on 2021-02-18
  • added Support for scraping Azure Automation account (docs | #352)
  • added Support for scraping Azure Front Door account (docs | #343)
  • added Support for scraping Azure SQL Elastic Pool (docs | #319)
  • added Support for scraping Azure Synapse (Apache Spark pool) (docs | #1477)
  • added Support for scraping Azure Synapse (SQL pool) (docs | #1477)
  • added Support for scraping Azure Synapse (Workspace) (docs | #1477)
  • added Support Prometheus Operator in Helm chart (PR #31 | Contributed by @DaveOHenry 🎉)
  • added Support for affinity in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for priority class name in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for additional pod labels in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for security context in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for node selector in Helm chart (PR #26 | Contributed by @blafry 🎉)
  • added Support for tolerances in Helm chart (PR #26 | Contributed by @blafry 🎉)
  • added Support Prometheus Operator in Helm chart (PR #31 | Contributed by @DaveOHenry 🎉)
  • changed Provide better usability in terms of startup and configuration insights (#1474)
  • changed Provide more control over probes in Helm chart (PR #30 | Contributed by @t3mi 🎉)

Full release notes can be found here.

Resource Discovery - v0.2.0

released on 2021-02-18
  • added Support for discovering Azure Automation resources (docs | #352)
  • added Support for discovering Azure Front Door resources (docs | #343)
  • added Support for scraping Azure SQL Elastic Pool (docs | #319)
  • added Support for scraping Azure Synapse (Apache Spark pool) (docs | #1477)
  • added Support for scraping Azure Synapse (SQL pool) (docs | #1477)
  • added Support for scraping Azure Synapse (Workspace) (docs | #1477)
  • added Support for affinity in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for priority class name in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for additional pod labels in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for security context in Helm chart (PR #30 | Contributed by @t3mi 🎉)
  • added Support for node selector in Helm chart (PR #26 | Contributed by @blafry 🎉)
  • added Support for tolerances in Helm chart (PR #26 | Contributed by @blafry 🎉)
  • changed Provide better usability in terms of startup and configuration insights (#1474)
  • changed Provide more control over probes in Helm chart (PR #3°)
  • changed Rename azureLandscape.subscriptionIds to azureLandscape.subscriptionIds in Helm chart to avoid confusion (PR #29)
  • fixed Provide case-invarient lookups for resource group filtering (#1492)

Full release notes can be found here.

Scraper - 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 - 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 - v1.6.0

released on 2020-05-15

Full release notes can be found here.