Promitor

Promitor Resource Discovery allows you to declare the Azure landscape to explore and define resource discovery groups in YAML.

Resource discovery groups represent a group of Azure resources of a given type that can be scraped by Promitor Scraper and supports an extensive list of supported services.

As part of the resource discovery group declaration, you can choose to filter resources by adding inclusion criteria that resources must comply with based on:

• Subscription - Defines a subset of subscriptions defined in the Azure landscape
• Resource Group - Defines a list of resource groups which contains the resources.
• Tags - Defines a list of Azure tags with which the resources have to be annotated.
• Regions - Defines a list of Azure regions in which the regions the resources are located.

Here is an example of a full declaration:

version: v1
azureLandscape:
  tenantId: e0372f7f-a362-47fb-9631-74a5c4ba8bbf
  subscriptions:
  - SUBSCRIPTON-ID-ABC
  - SUBSCRIPTON-ID-DEF
  - SUBSCRIPTON-ID-GHI
  cloud: China
resourceDiscoveryGroups:
- name: container-registry-landscape
  type: ContainerRegistry
- name: filtered-logic-apps-landscape
  type: LogicApp
  criteria:
    include:
      subscriptions:
      - SUBSCRIPTON-ID-ABC
      - SUBSCRIPTON-ID-GHI
      resourceGroups:
      - promitor-resource-group-1
      - promitor-resource-group-2
      tags:
        app: promitor-1|promitor-2
        region: europe
      regions:
      - northeurope
      - westeurope

Specification

As Promitor evolves we need to change the structure of our resource discovery declaration.

version: {version} - Version of declaration that is used. Allowed values are v1. (Required)

Azure Landscape

• azureLandscape.tenantId - The id of the Azure tenant that will be queried. (Required)
• azureLandscape.subscriptions - List of Azure subscriptions in the Azure tenant to discover resources in. (Required)
• azureLandscape.cloud - The name of the Azure cloud to use. Options are Global (default), China, UsGov & Germany.

Resource Discovery Groups

Every resource discovery group that is being declared needs to define the following fields:

• name - Name of the resource discovery group which will be used in metrics declaration of Promitor Scraper. (Required)
• type - Type of Azure resources that must be discovered, see “Supported Azure Services for a full list of supported types. (Required)
• criteria - Criteria to fine-tune discovered resource.

Criteria

As of now, we only allow to define criteria that resources have to meet before they are included in the resource discovery group:

• subscriptions - A list of subscription(s) in which the resource is allowed to be located.
• resourceGroups - A list of resource group(s) in which the resource is allowed to be located.
• tags - A list of Azure tags and the expected values (exact or regular expression) with which the resources have to be annotated. (Uses or)
• regions - A list of Azure region(s) in which the resource is allowed to be located.

Supported Azure Services

Dynamic resource discovery is supported for the following scrapers:

• Azure API Management
• Azure Application Gateway
• Azure Application Insights
• Azure App Plan
• Azure Automation
• Azure Cache for Redis
• Azure Cache for Redis Enterprise
• Azure Content Delivery Network (CDN)
• Azure Container Instances
• Azure Container Registry
• Azure Cosmos DB
• Azure Data Factory
• Azure Data Share
• Azure Database for PostgreSQL
• Azure Database for MariaDB
• Azure Event Hubs
• Azure Express Route Circuit
• Azure Front Door
• Azure Function App
• Azure IoT Hub
• Azure IoT Hub Device Provisioning Service (DPS)
• Azure Key Vault
• Azure Kubernetes Service
• Azure Load Balancer
• Azure Logic Apps
• Azure Monitor Autoscale
• Azure Network Gateway
• Azure Network Interface
• Azure Service Bus Namespace
• Azure SQL Database
• Azure SQL Elastic Pool
• Azure SQL Managed Instance
• Azure Storage (Account)
• Azure Synapse (Apache Spark pool)
• Azure Synapse (SQL pool)
• Azure Synapse (Workspace)
• Azure Virtual Machine
• Azure Virtual Machine Scale Set (VMSS)
• Azure Virtual Network
• Azure Web App

← back