For Agents
Read and write Google Cloud time series data, manage alert policies and notification channels, and configure uptime checks for any HTTP target.
Get started with Cloud Monitoring API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create an alert policy on google cloud monitoring"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Cloud Monitoring API API.
Write custom time series points to Cloud Monitoring via collectdTimeSeries
Manage alert policies that fire on threshold or absence conditions over time series
Manage notification channels including email, SMS, PagerDuty, and webhook targets
Configure uptime checks for HTTP, HTTPS, and TCP endpoints with regional checkers
GET STARTED
Use for: List metric descriptors available in my project, Create an alert policy that fires when error rate exceeds 5 percent, Add a notification channel for our PagerDuty service, List the alert policies currently configured under my project
Not supported: Does not handle log entry storage, distributed traces, or grouped error events — use for metrics, alert policies, notification channels, and uptime checks only.
Cloud Monitoring is Google Cloud's observability service for collecting, querying, and alerting on metrics, with support for uptime checks and notification channels. The v3 API exposes time series, metric and monitored resource descriptors, alert policies, notification channels, groups, and uptime check IPs and configs. It pairs with Cloud Logging for full observability and supports Prometheus-compatible queries through monitored projects scoped to a Workspace.
List metric and monitored resource descriptors available for query
Group monitored resources by filter for fleet-wide policy and reporting
Read uptime check IP ranges to allowlist Google's checkers in firewalls
Patterns agents use Cloud Monitoring API API for, with concrete tasks.
★ Production alerting on SLOs
Define alert policies that fire when latency, error rate, or availability metrics breach SLO thresholds, route them through notification channels for email, SMS, PagerDuty, or webhooks, and group related resources so a single policy covers an entire service. Setup typically takes a few hours for a new service.
Create an alertPolicy named api-error-rate that fires when metric.type=run.googleapis.com/request_count with response_code_class=5xx exceeds 5% over 10 minutes for service api-prod
Synthetic uptime monitoring
Configure uptime checks against public HTTP, HTTPS, or TCP endpoints to detect outages from multiple regions, and pair them with alert policies that page on-call when a check fails. The uptimeCheckIps endpoint lists Google's checker addresses so firewalls and WAFs can allowlist them.
Create an uptimeCheckConfig for https://api.example.com/healthz with 60-second period and an alertPolicy that pages PagerDuty when the check fails for 5 minutes
Custom metric ingestion
Write custom metrics to Cloud Monitoring so business KPIs and application internals appear in the same dashboards as infrastructure signals. The collectdTimeSeries endpoint accepts collectd-formatted points and the metric and monitored resource descriptor catalog lets you keep a clean type model for each KPI.
Write a collectdTimeSeries point for metric.type custom.googleapis.com/checkout/orders_per_minute with value 142 against the gce_instance resource with our prod VM ID
Agent integration via Jentic
AI agents acting as on-call assistants can use Cloud Monitoring through Jentic to enumerate alert policies, page on incidents, and adjust uptime checks during incidents without holding the underlying OAuth refresh token in their prompt.
List alertPolicies in projects/acme and disable any whose displayName matches a pattern provided by the on-call runbook for the maintenance window
32 endpoints — cloud monitoring is google cloud's observability service for collecting, querying, and alerting on metrics, with support for uptime checks and notification channels.
METHOD
PATH
DESCRIPTION
/v3/uptimeCheckIps
List Google's uptime checker IP ranges
/v3/{+name}
Delete a Cloud Monitoring resource
/v3/{+name}/alertPolicies
List alert policies in a project
/v3/{+name}/collectdTimeSeries
Write collectd-formatted time series
/v3/{+name}/groups
List monitored resource groups
/v3/{+name}/metricDescriptors
List metric descriptors
/v3/{+name}/monitoredResourceDescriptors
List monitored resource descriptors
/v3/{+name}/notificationChannelDescriptors
List notification channel descriptors
/v3/uptimeCheckIps
List Google's uptime checker IP ranges
/v3/{+name}
Delete a Cloud Monitoring resource
/v3/{+name}/alertPolicies
List alert policies in a project
/v3/{+name}/collectdTimeSeries
Write collectd-formatted time series
/v3/{+name}/groups
List monitored resource groups
Three things that make agents converge on Jentic-routed access.
Credential isolation
Google Cloud OAuth 2.0 client credentials and refresh tokens are stored encrypted in the Jentic vault. Agents receive short-lived bearer tokens scoped to monitoring; the refresh token and client secret never enter the agent's context.
Intent-based discovery
Agents search Jentic by intent such as create alert policy or list uptime checks and Jentic returns the matching Cloud Monitoring operations with input schemas, so the agent does not have to navigate Google Cloud's discovery documents.
Time to first call
Direct integration with Cloud Monitoring takes 1-2 days for OAuth setup, alert policy modelling, and notification channel wiring. Through Jentic the same flows are under an hour: search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Cloud Logging API
Log entries paired with monitoring metrics for full observability
Use Cloud Logging when working with raw log entries; use Cloud Monitoring for metrics, alerts, and uptime checks
Error Reporting API
Aggregated error events that often trigger Cloud Monitoring alert policies
Use Error Reporting for grouped error events; use Cloud Monitoring for the alerting and notification surface around them
Cloud Trace API
Distributed traces that complement metrics for latency analysis
Choose Cloud Trace for span-level analysis; use Cloud Monitoring for metric thresholds and alerts
Specific to using Cloud Monitoring API API through Jentic.
What authentication does the Cloud Monitoring API use?
The API uses Google OAuth 2.0 with monitoring scopes such as https://www.googleapis.com/auth/monitoring and https://www.googleapis.com/auth/monitoring.write. Through Jentic the OAuth credentials are held in the encrypted vault and the agent only sees a scoped, short-lived bearer token.
Can I create an alert policy from scratch through this API?
Yes. Post a new alertPolicy with a displayName, one or more conditions referencing metric filters, combiner logic, and the notificationChannels to call when the policy fires. The same shape is used to update an existing policy.
What are the rate limits for the Cloud Monitoring API?
Read endpoints (alertPolicies, metricDescriptors, monitoredResourceDescriptors) and write endpoints have separate per-project quotas listed under the Cloud Monitoring service in the Cloud Console. Custom metric write quotas are higher than alert manipulation quotas; respect 429 backoff for ingestion-heavy workloads.
How do I create an uptime check through Jentic?
Search Jentic for create uptime check google cloud, load the uptimeCheckConfigs create operation, and execute with the host, path, and period. Jentic injects the OAuth bearer token so the agent only constructs the check definition.
Is the Cloud Monitoring API free?
Cloud Monitoring includes a free tier for Google Cloud metrics and a generous allowance for custom metrics; usage above that is billed per metric ingested and uptime check executions. See the Operations Suite pricing page for current rates.
Why are there two monitoring versions in the catalog?
v1 is the dashboards-only surface for Cloud Monitoring dashboards. v3 is the main metrics, alerting, and uptime checks API. Use v3 for time series and alert policy work; v1 only when programmatically managing dashboards.
/v3/{+name}/metricDescriptors
List metric descriptors
/v3/{+name}/monitoredResourceDescriptors
List monitored resource descriptors
/v3/{+name}/notificationChannelDescriptors
List notification channel descriptors