Promitor Scraper v2.0.0-rc-2
Pre-releaseHighlights
Support for Atlassian Statupage
We've introduced a new metric sink that allows you to push metrics to Atlassian Statuspage
(docs)!
Learn more how to Promitor in our documentation
Introducing Resource Discovery
With Promitor 2.0 we are introducing resource discovery by introducing a new agent, Promitor Resource Discovery!
You can now reference resource discovery groups in your metrics declaration which will be used to discover resources by using Azure Resource Graph:
Learn more on how:
- To configure Promitor Scraper to use resource discovery
- To declare resource discovery groups and what the supported resources are
- To deploy Promitor Resource Discovery agent
- Promitor works in our documentation.
Getting started
Running Promitor Scraper is super easy:
docker run -d -p 8999:80 --name promitor-agent-scraper
--env PROMITOR_AUTH_APPID='<azure-ad-app-id>' \
--env-file C:/Promitor/az-mon-auth.creds \
--volume C:/Promitor/metrics-declaration.yaml:/config/metrics-declaration.yaml \
tomkerkhove/promitor-agent-scraper:2.0.0-rc-2
Docker Image information
New Docker image tags are available:
2.0.0-rc-2
,2.0.0-rc-2-linux
,2.0.0-rc-2-windows
Docker image is available on Docker Hub.
For more information about our tagging strategy, feel free to read our documentation.
What's new?
Here are some important things you should know, for a full list see changelog.promitor.io.
New
Here are a list of new features:
- Support for resource discovery (docs | configuration | deployment)
- Support for scraping Azure Event Hubs (docs | #372)
- Support for scraping Azure Service Bus Namespace (docs | #1392)
- Support for scraping Azure Logic Apps (docs | #314).
- Support for scraping Azure Express Route circuits (docs | #1251 | Contributed by @bluepixbe 🎉).
- Support for scraping Azure Application Gateway (docs | #1251 | Contributed by @bluepixbe 🎉).
- Support for scraping Azure Network Gateway (docs | #1264 | Contributed by @bluepixbe 🎉).
- Support for scraping Azure Kubernetes Service (docs | #333 | Contributed by @jkataja 🎉).
- Support for using dimensions with Azure Service Bus (#808)
- New System API endpoint giving runtime information (docs
| #1208) - Provide
X-Version
response header for API endpoints (#1209) - Provide capability to tweak liveness/readines probes in Helm charts (#1350)
- Provide capability to expose endpoints through an internal load balancer (AKS) in Helm charts (#1402)
- New validation rule to ensure at least one resource or resource collection is configured to scrape
- Provide suggestions when unknown fields are found in the metrics config. (#1105 | Contributed by @adamconnelly 🎉).
- Add validation to ensure the scraping schedule is a valid Cron expression. (#1103 | Contributed by @adamconnelly 🎉).
- Provide support for pushing metrics to Atlassian Statuspage
(docs | #1152) - Provide suggestions when unknown fields are found in the metrics config. (#1105 | Contributed by @adamconnelly 🎉).
- New validation rule to ensure the scraping schedule is a valid Cron expression. (#1103).
- New validation rule to ensure declarative or dynamic discovery for metrics to scrape are configured
- New System API endpoint giving runtime information (docs
| #1208)
Fixes
Here are a list of fixes:
- Resource discovery is not configured, but still blocked by scraper validation #1202
- Ensure Prometheus metric sink does write timestamps #1217
- Dimensions with
/
in name are now supported by replacing it with_
for Prometheus metric sink #1248 - Filtering by dimensions which include / in name does not work in generic scraper #1266
Changed
Here are a list of changes:
- Provide capability to scrape all queues in Azure Service Bus, instead of having to declare the queue name. #529.
- Handle validation failures on startup more gracefully. #1113.
- Improve time series handling to ensure finalized time series are reported
- Show Promitor version during startup
Deprecations
None.
Breaking Changes
Here are a list of breaking changes and how to mitigate them:
- Support for scraping Azure Service Bus Queue, use Azure Service Bus Namespace scraper instead
- Support for Prometheus legacy configuration is removed (deprecation notice | migration guide)
- Support for Swagger UI 2.0 is removed (deprecation notice | migration guide)
- Support for Swagger 2.0 is removed (deprecation notice | migration guide)
Learn how to migrate to 2.0 with our migration guide.