Skip to content

v2.0.0-preview-3

Pre-release
Pre-release
Compare
Choose a tag to compare
@tomkerkhove tomkerkhove released this 11 Sep 14:00

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:
Overview

Learn more on how:

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-preview-3

Running Promitor Resource Discovery is super easy:

docker run -d -p 9999:80 --name promitor-agent-resource-discovery   \
                         --env PROMITOR_DISCOVERY_APPID='<azure-ad-app-id>'   \
                         --env-file C:/Promitor/promitor-discovery-auth.creds   \
                         --volume C:/Promitor/resource-discovery-declaration.yaml:/config/resource-discovery-declaration.yaml   \
                         --volume C:/Promitor/resource-discovery-runtime.yaml:/config/runtime.yaml   \
                         tomkerkhove/promitor-agent-discovery:0.1.0-preview-3

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 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 🎉).
  • 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:

Learn how to migrate to 2.0 with our migration guide.

Docker Image information

New Docker image tags are available:

  • 2.0.0-preview-3, 2.0.0-preview-3-linux, 2.0.0-preview-3-windows
  • 2.0, 2.0-linux, 2.0-windows

Docker image is available on Docker Hub.

For more information about our tagging strategy, feel free to read our documentation.

Others:

  • #1273: Filtering by dimensions which include / in name does not work in generic scraper
  • #1275: Show Promitor version during startup
  • #1274: Update dependency Serilog to v2.10.0
  • #1272: Update .NET Core Docker containers Docker tags
  • #1270: Update aspnet Extensions monorepo to v3.1.8
  • #1271: Thank you everybody for your contributions!
  • #1260: Improve Helm chart - Use metric sink approach for Prometheus & general refresh
See More
  • #1268: Update dependency husky to v4.3.0
  • #1267: Update dependency Microsoft.VisualStudio.Azure.Containers.Tools.Targets to v1.10.9
  • #1261: Provide support for scraping Azure Application Gateway
  • #1262: Update dependency lint-staged to v10.3.0
  • #1254: Provide support for scraping metrics for Azure ExpressRoute circuits
  • #1259: Dimensions with / in name are now supported by replacing it with _ for Prometheus metric sink
  • #1258: Provide changelog for 2.0.0-preview-1 & 2.0.0-preview-2
  • #1199: Helm chart should always use the correct image tag
  • #1253: Sanitize label names to comply with Prometheus requirements
  • #1252: Introduce custom asserts for validation outcome
  • #1249: Provide validation rules for resource discovery agent
  • #1246: [ImgBot] Optimize images
  • #1245: Welcom Vsoft, a Promitor user!
  • #1242: Update dependency lint-staged to v10.2.13
  • #1240: Update dependency lint-staged to v10.2.12
  • #1235: Improve resource discovery & Prometheus setup
  • #1232: Update dependency Microsoft.NET.Test.Sdk to v16.7.1
  • #1233: Provide better docs on contributing
  • #1224: Update dependency Prometheus.Client to v4
  • #1231: Update dependency Microsoft.Azure.Storage.Queue to v11.2.2
  • #1228: Use build/install-sdk.yml for all templates
  • #1222: Update .NET Core Docker containers Docker tags
  • #1227: Migrate to "Use .NET Core 2.*" task and introduce parameters with validation
  • #1226: Update dependency Microsoft.Azure.Storage.Queue to v11.2.1
  • #1225: Update dependency Prometheus.Client.AspNetCore to v4
  • #1223: Restructure templates for pipelines
  • #1219: Assign version when building Docker image and introduce system endpoint
  • #1221: Stamp version for release
  • #1220: Update dependency Bogus to v30.0.4
  • #1218: Ensure Prometheus metric sink does write timestamps (#1217)
  • #1216: Update dependency Bogus to v30.0.3
  • #1215: Fix typo
  • #1211: Update .NET Core Docker containers Docker tags
  • #1210: Update aspnet Extensions monorepo to v3.1.7
  • #1212: Fix integration tests due to new Azure resources
  • #1207: Preview releases should not push {major}.{minor} tag
  • #1206: Upgrade doc depenencies and patch CVE-2020-14001
  • #1205: Provide capability to scrape all queues in Azure Service Bus
  • #1204: Add Azure Event Hubs metric to local config
  • #1203: Provide Azure Event hubs scraper
  • #1202: Resource discovery is not configured, but still blocked by scraper validation
  • #1201: Update dependency Microsoft.NET.Test.Sdk to v16.7.0
  • #1198: Update dependency Bogus to v30
  • #1193: Update dependency xunit.runner.visualstudio to v2.4.3
  • #1191: [ImgBot] Optimize images
  • #1192: Provide documentation on how to configure integration with Promitor Resource Discovery agent
  • #1190: Provide an overview of how Promitor works
  • #1189: [ImgBot] Optimize images
  • #1188: Provide schematics on how Promitor works
  • #1187: Update dependency Microsoft.Azure.Storage.Queue to v11.2.0
  • #1175: Provide documentation about resource discovery
  • #1184: Provide support for resource discovery in all Azure Clouds
  • #1179: Update dependency Serilog.AspNetCore to v3.4.0
  • #1174: Provide documentation about resource discovery health check in scraper health endpoint
  • #1173: Provide versioning in resource discovery group configuration & explicitly mention inclusion criteria
  • #1172: Provide discovery for network interface, SQL DB/Managed instance storage account and PostgreSQL
  • #1169: Request OSS org for Netlify
  • #1168: [Docs] Security upgrade github-pages from 204 to 206
  • #1165: Provide resource discovery support for more scrapers
  • #1164: Simplify resource discovery query building to reduce duplication, but still be open
  • #1163: Update dependency AutoMapper.Extensions.Microsoft.DependencyInjection to v8.0.1
  • #1162: Provide resource discovery support for VMs & Virtual Machine Scale Set (VMSS)
  • #1161: Update dependency Microsoft.Extensions.Http to v3.1.6
  • #1098: Improve time series handling to ensure finalized time series are reported
  • #1154: Provide support for Atlassian Statuspage as sink
  • #1160: Container Scanning
  • #1159: Configure code scanning
  • #1158: Update .NET Core Docker containers Docker tags
  • #1157: Update aspnet Extensions monorepo to v3.1.6
  • #1156: Provide scraper for Azure Logic Apps
  • #1155: Update dependency AutoMapper.Extensions.Microsoft.DependencyInjection to v8
  • #1153: Update arcus observability monorepo to v0.3.0
  • #1151: Document possibility to use code tour for adding new scrapers
  • #1150: Add a few code tours
  • #1148: Simplify how we use validation
  • #1144: Update discovery agent startup to match scraper
  • #1142: Provide validation rule to verify if resource discovery is configured when metric discovery is used
  • #1141: Rename resource collections to resource discovery groups
  • #1140: Remove deprecated Prometheus configuration
  • #1139: Document how to add support for resource discovery
  • #1136: Update dependency Moq to v4.14.5
  • #1137: Update dependency AutoMapper to v10
  • #1138: Align integration tests with new Azure landscape
  • #1081: Provide integration between scraper & resource discovery agents
  • #1117: Update dependency markdownlint-cli to v0.23.2
  • #1114: Exit gracefully if a validation error occurs
  • #1112: Update Swashbuckle monorepo to v5.5.1
  • #1109: Update dependency Swashbuckle.AspNetCore.Filters to v5.1.2
  • #1108: Update dependency Moq to v4.14.4
  • #1104: Ensure that schedule is a valid Cron expression
  • #1107: Report validation error if resources not specified
  • #806: Provide validation to ensure resources are defined
  • #1106: Provide possible suggestions for unknown fields
  • #1105: Provide suggestions for unknown fields
  • #1101: Update Swashbuckle monorepo to v5.5.0
  • #1100: Update dependency Moq to v4.14.3
  • #1096: Update all the resource type deserializers
  • #1091: Use new fluent mapping for all deserializers
  • #1095: Update dependency lint-staged to v10.2.11
  • #1093: Update all the core deserializers
  • #1094: Update dependency Moq to v4.14.2
  • #1092: Update tests to use new mapping syntax
  • #1089: Improve fluent mapping
  • #1088: Update dependency lint-staged to v10.2.10
  • #1087: Update azure azure-libraries-for-net monorepo to v1.34.0
  • #1085: Update .NET Core Docker containers Docker tags
  • #1083: Update aspnet Extensions monorepo to v3.1.5
  • #1082: Remove Swagger (UI) 2.0 support
  • #1080: Fix bad collection name
  • #1078: Schedule job per resource collection and discover resources for the collection name
  • #1075: Update dependency lint-staged to v10.2.9
  • #1072: Improve deprecation dates on changelog.promitor.io
  • #1071: Provide configuration & validation for using resource collection
  • #1070: Update dependency lint-staged to v10.2.8
  • #1068: Update dependency Microsoft.Azure.Storage.Queue to v11.1.7
  • #1067: Preview releases should not push latest tag
  • #1066: Update dependency xunit.runner.visualstudio to v2.4.2
  • #1064: Provide capability to configure resource discovery with Helm chart
  • #1062: Dependency tracking graph
  • #1061: Provide changelog for v1.6.1

This list of changes was auto generated.