Microsoft Azure Azure Metrics
Browse all Azure APIs★ Only Publicly Available OpenAPI DocumentDeveloper ToolsMonitoring Observabilitynone1 EndpointsREST
For Agents
Publish custom metric data points for an Azure resource into the Azure Monitor metrics store. Useful when an agent needs to emit numeric telemetry tied to a subscription, resource group, and resource name.
Use for: I need to publish a custom metric for an Azure VM, Send a numeric data point to Azure Monitor for a specific resource, Record a request count metric against an Azure resource, Emit a latency value into the Azure metrics store
Not supported: Does not handle log ingestion, trace ingestion, or metric querying — use for publishing custom numeric metrics to Azure Monitor only.
Jentic publishes the only available OpenAPI specification for Azure Metrics, keeping it validated and agent-ready. The Azure Metrics API lets clients submit custom metric data points to the Azure Monitor metrics store via a single regional ingestion endpoint at monitoring.azure.com. It is the publishing side of the Azure Monitor metrics pipeline, used by applications and infrastructure to record numeric time-series data tied to a specific Azure resource. Once ingested, these metrics can be queried, charted, and alerted on through Azure Monitor.
Install Jentic One Beta
Connect the Azure Metrics to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Azure Metrics, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Azure Metrics API.
Publish a batch of custom metric values for an Azure resource at a specific timestamp
Tag emitted metrics with namespace, name, and dimension values for later filtering in Azure Monitor
Scope metric submissions to a subscription, resource group, resource provider, and resource type
Send numeric time-series data into the Azure Monitor metrics pipeline for charts and alerts
Record application-level counters that complement the platform metrics Azure already collects
Use Cases
Patterns agents use Azure Metrics API for, with concrete tasks.
★ Custom Application Metrics
Publish application-level numeric metrics (request rate, queue depth, error count) against the Azure resource that hosts the workload. The Azure Metrics ingestion endpoint accepts a batch of values with namespace, name, and dimensions, and stores them in Azure Monitor for charting and alerting alongside platform metrics. A single POST per emit cycle is enough to instrument a service.
POST a custom metric named 'request_count' with value 42 and dimension 'endpoint=/checkout' against a specific App Service resource using the Metrics_Create operation.
Telemetry From Background Jobs
Background workers and scheduled jobs running outside Application Insights can still emit health and throughput numbers by sending them to the Azure Metrics endpoint. Each call records a metric value tied to the Azure resource that owns the job, so dashboards and alert rules in Azure Monitor see the same shape of data as platform metrics.
Emit a 'job_duration_seconds' metric with value 12.5 for the resource hosting the worker after each job run using a POST to the metrics path.
Threshold Alerting On Custom Signals
Azure Monitor alert rules trigger on metric values regardless of whether the metric was emitted by the platform or a custom source. By publishing custom values through the Azure Metrics API, teams gain the ability to alert on signals Azure does not collect natively, such as business KPIs or third-party integration health, without standing up a separate monitoring stack.
POST a custom 'failed_payments_per_minute' metric so an existing Azure Monitor alert rule can fire when the value exceeds a configured threshold.
AI Agent Telemetry Ingestion
An agent acting on Azure resources can publish operational telemetry about its own actions (operations attempted, latency, retry count) to Azure Monitor via the Metrics ingestion endpoint. Through Jentic, the agent searches for the Azure Metrics operation by intent, loads the input schema, and POSTs values without manually constructing the long subscription/resource-provider/resource path.
Use Jentic to call the Azure Metrics POST operation and emit an 'agent_action_count' metric tagged with agent_id and outcome dimensions after each tool invocation.
Key Endpoints
1 endpoints — jentic publishes the only available openapi specification for azure metrics, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{resourceProvider}/{resourceTypeName}/{resourceName}/metrics
Publish a batch of custom metric values for an Azure resource
POST
/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{resourceProvider}/{resourceTypeName}/{resourceName}/metrics
Publish a batch of custom metric values for an Azure resource
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Azure AD bearer tokens for monitoring.azure.com are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access — the underlying tenant credentials never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'publish a custom metric to Azure') and Jentic returns the Metrics_Create operation with its full input schema, so the agent does not have to construct the long /subscriptions/.../metrics path manually.
Time to first call
Direct Azure Metrics integration: 1-2 days for AAD token acquisition, payload shaping, and 429 handling. Through Jentic: under 30 minutes — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Azure Metrics API through Jentic.
Why is there no official OpenAPI spec for Azure Metrics?
Microsoft Azure does not publish an OpenAPI specification for the Azure Metrics ingestion endpoint. Jentic generates and maintains this spec so that AI agents and developers can call Azure Metrics via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Azure Metrics API use?
The published spec does not declare a security scheme, but in practice the monitoring.azure.com ingestion endpoint requires an Azure AD bearer token with the `https://monitoring.azure.com/.default` scope. Through Jentic, those tokens are stored in the Jentic vault and never enter the agent's context.
Can I publish multiple metric values in one call to Azure Metrics?
Yes. The Metrics_Create POST operation accepts a payload with a time, base data, and dimensions, so one call can carry several metric series for the same resource at the same timestamp.
What are the rate limits for the Azure Metrics API?
Azure Monitor enforces ingestion limits per region and per resource (documented as throttling on the monitoring.azure.com endpoint). The OpenAPI spec does not encode the exact numbers, so production agents should treat 429 responses as a signal to back off and batch more values per request.
How do I send a custom metric with the Azure Metrics API through Jentic?
Run pip install jentic, then call client.search('publish a custom metric to Azure Monitor'). Jentic returns the Metrics_Create operation, you load its schema, and execute with subscriptionId, resourceGroupName, the resource path, and the metric payload.
Does Azure Metrics replace Application Insights?
No. The Azure Metrics ingestion endpoint only handles numeric metric data points. Logs, traces, exceptions, and request telemetry still belong in Application Insights or Log Analytics.
GET STARTED