Promitor

Promitor is an Azure Monitor scraper which makes the metrics available for metric systems such as Atlassian Statuspage, Prometheus and StatsD.

Running Promitor Scraper

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 \
                         --volume C:/Promitor/runtime.yaml:/config/runtime.yaml \
                         ghcr.io/tomkerkhove/promitor-agent-scraper:2.5.0

Docker image is available on GitHub Container Registry.

Features

• Automatically scrapes Azure Monitor metrics (single and multi-dimensional) across various subscription & resource groups
• Automatically pushes metrics to systems such as Atlassian Statuspage, Prometheus and StatsD
• Easy to declare metrics to scrape via metrics-as-code or automatically discover resources
• Built-in support for a variety of Azure services (overview)
• Easily deployable via Docker & Kubernetes
• Sends telemetry to container logs & Azure Application Insights
• Available for Linux & Windows runtimes
• Support for all Azure clouds

And there is more on the way - Check our backlog and vote for features!

Documentation

• How It Works
  • Resource Discovery
• Metrics
  • General Declaration
  • Supported Providers
  • What labels do we provide?
• Deployment
  • Overview
  • Scraper
    • Docker
    • Kubernetes
  • Resource Discovery
    • Docker
    • Kubernetes
  • Image Tagging Strategy
  • Migrate to our new Helm chart registry
• Configuration
  • Scraper
    • Overview of metric sinks
      • Atlassian Statuspage
      • Prometheus Scraping Endpoint
      • StatsD
    • Using resource discovery
    • Authentication with Azure Monitor
    • Logging & External Providers
    • Runtime
  • Resource Discovery
    • Configuring Runtime
    • Authentication with Azure Resource Graph
    • Declaring resource discovery groups
• Security
  • Authentication with Microsoft Azure
    • Overview of Azure integrations
    • Supported Authentication Mechanisms
    • Required permissions for Azure Monitor
    • Required permissions for Azure Resource Graph
• Operations
  • Health
  • Discovery
  • Performance
  • System
  • Integrations
    • Azure Resource Manager API - Consumption & Throttling
    • Azure Monitor
  • Configuration REST APIs
• Walkthroughs
  • Deploying Promitor, Prometheus, and Grafana on an AKS Cluster
  • Using Managed Identity with Promitor on an AKS Cluster
  • Migrate from Promitor Scraper 1.x to 2.x
• Frequently asked questions (FAQs)

Support

Promitor is actively maintained and developed with best-effort support.

We do welcome PRs that implement features from our backlog and are always happy to help you incorporate Promitor in your infrastructure, but do not provide 24/7 support. Are you having issues or feature requests?

Feel free to let us know!

End-users

We are proud to have the following end-users(s) running Promitor in production:

Are you a Promitor user? Let us know and get listed!

Learn more about how they are using Promitor:

• “Monitor Azure Resources using Promitor” by ResDiary

Thank you

We’d like to thank the following service(s) for supporting our open-source initiative!

• Netlify allows us to provide previews of our documentation changes in our pull requests that make it easier to review them.

But they are not the only one we’d like to thank!

For a full list of services, tooling & NuGet packages that support us - Have a look at our Thank you page!

License Information

This is licensed under The MIT License (MIT). Which means that you can use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the web application. But you always need to state that Tom Kerkhove is the original author of this web application.