Here is an overview of how you can deploy Promitor Resource Discovery on your infrastructure, we support both Linux and Windows.

You can learn more about our Helm chart on


❯ docker run -d -p 9999:80 --name promitor-agent-resource-discovery   \
                         --env PROMITOR_AUTH_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   \


We provide a Helm Chart which deploys all the required infrastructure on your Kubernetes cluster.

Getting the Helm Chart

Install the Promitor Chart repository:

❯ helm repo add promitor

Refresh your local Chart repositories:

❯ helm repo update

If all goes well you should be able to list all Promitor charts:

❯ helm search hub promitor
URL                                                     CHART VERSION           APP VERSION     DESCRIPTION      2.0.0-preview-3         2.0.0-preview-3 Promitor, bringing Azure Monitor metrics where ...      0.0.0-pr997             0.0.0-pr997     A Helm chart to deploy Promitor, an Azure Monit...      0.0.0-0.0.0-pr1326      0.0.0-pr1326    Promitor, bringing Azure Monitor metrics where ...

Using our Helm Chart

You can easily install our Resource Discovery Agent as following:

❯ helm install promitor-agent-resource-discovery promitor/promitor-agent-resource-discovery \
               --set azureAuthentication.appId='<azure-ad-app-id>' \
               --set azureAuthentication.appKey='<azure-ad-app-key>' \
               --values /path/to/helm-configuration.yaml

Next to Azure authentication, a resource discovery declaration must be provided through --values.

Here is an example of resource discovery declaration which you can pass:

  cloud: Global
  tenantId: c8819874-9e56-4e3f-b1a8-1c0325138f27
  - 0329dd2a-59dc-4493-aa54-cb01cb027dc2
- name: api-gateways
  type: ApiManagement

Our Helm chart provides a variety of configuration options which you can explore in our full values file. to see all configurable values.

Sample configuration

Want to get started easily? Here’s a sample configuration to spin up the Resource Discovery agent which will be publicly exposed outside of the cluster on

  appId: 67882a00-21d3-4ee7-b32a-430ea0768cd3
  appKey: <hidden>
  cloud: Global
  tenantId: c8819874-9e56-4e3f-b1a8-1c0325138f27
  - 0329dd2a-59dc-4493-aa54-cb01cb027dc2
  - 0f9d7fea-99e8-4768-8672-06a28514f77e
- name: service-bus-landscape
  type: ServiceBusQueue
- name: api-gateways
  type: ApiManagement
- name: app-plan-landscape
  type: AppPlan
- name: container-instances
  type: ContainerInstance
- name: container-registry-landscape
  type: ContainerRegistry
- name: cosmos-accounts
  type: CosmosDb
- name: dps
  type: DeviceProvisioningService
- name: event-hubs-landscape
  type: EventHubs
    dnsPrefix: promitor-resource-discovery-sample
    enabled: true
  defaultLogLevel: information

You can easily deploy it by passing the file through --values during installation.

← back