Skip to content

Agent Platform Alert Setup

Sets up best-practice monitoring alerts for AI agents using OpenTelemetry metrics, output as Terraform files.

Repository
google/skills
Stars
21,782
Licence
Apache-2.0
Files
15 files

What it does

When you ask your AI assistant to set up monitoring for an AI agent you run on Google Cloud, this skill makes it follow a structured process: check that the agent is emitting telemetry, look for existing alerts to avoid duplicates, and then write alert rules for latency, errors, cost, safety, security and (for Vertex AI agents) quality as Terraform configuration files. It also asks for your explicit approval before anything that creates billable resources, and warns about extra costs from LLM evaluations and trace or log export.

Great for

  • Engineers who run AI agents on Google Cloud (Cloud Run, Vertex AI) and want alerting in place without writing every policy by hand
  • Platform teams standardising alert coverage across several agents in a Cloud Monitoring metrics scope

Skip it if

  • Generic infrastructure monitoring unrelated to AI agents, which the skill says it should not be used for
  • Agents that do not emit OpenTelemetry metrics, since the alert policies would have no data to evaluate
  • Anyone who would apply the generated Terraform to production without reviewing it, because it creates cloud resources and billing charges

Try asking

  • “Set up the standard alert policies for my Cloud Run agent in project my-prod-project”
  • “Check whether telemetry is enabled for my Vertex AI agent and tell me what is missing”
  • “Generate Terraform for only the cost and safety alert policies for my agent”
  • “Review my existing alert policies for duplicates before adding new ones”
Step-by-step guide: how to use Agent Platform Alert SetupInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the Apache-2.0 licence and an attribution note.

    agent-platform-alert-configuration.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip agent-platform-alert-configuration.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip agent-platform-alert-configuration.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Read the cost and billing warnings the agent gives before approving any provisioning step, especially LLM evaluation and Cloud Trace or Logging export charges
  • Name the exact Google Cloud project you want configured; the skill is designed to ignore other projects in your environment
  • Review the generated Terraform yourself and run it first in a non-production project

What's inside

  • references/attribution.md
  • references/cost_alert_policies.md
  • references/has_historical_traffic_data.md
  • references/no_historical_traffic_data.md
  • references/quality_alert_policies.md
  • references/reliability_alert_policies.md
  • references/safety_alert_policies.md
  • references/security_alert_policies.md
  • references/telemetry_enablement.md
  • scripts/analyze_traffic_test.py
  • scripts/analyze_traffic.py
  • scripts/check_telemetry_test.py
  • scripts/check_telemetry.py
  • scripts/config_utils.py
  • SKILL.md

Redistributed unmodified from google/skills under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.