ops-inspector

Inspect CloudBase resource health and error signals from Cloud Functions, CloudRun, and CLS logs.

Updated May 14, 2026
One-click install
npx skills add https://github.com/williamwang25/ams-admin --skill ops-inspector-williamwang25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ops-inspector
Source: https://github.com/williamwang25/ams-admin/tree/main/.windsurf/skills/cloudbase/references/ops-inspector
Command: npx skills add https://github.com/williamwang25/ams-admin --skill ops-inspector-williamwang25

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

ops-inspector helps you quickly pinpoint failures and abnormal behavior across CloudBase resources by aggregating resource states and recent error logs, so you can move from “something is broken” to actionable guidance without manual cross-checking.

Core Features & Use Cases

  • Environment-first health verification: checks that the CloudBase environment is bound and accessible before diagnosing deeper issues.
  • Cross-service inspection: inspects Cloud Functions and CloudRun services to identify downtime, crashes, and common runtime problems.
  • CLS log service diagnostics: verifies whether Cloud Log Service (CLS) is enabled and uses it to search for error patterns within a scoped time range.
  • AIOps-style reporting: produces a severity-based summary (Healthy / Info / Warning / Critical) and prioritized recommendations with relevant console links.
  • Use case: after a production alert, request a “full inspection for the last 24 hours” to determine whether errors are isolated or correlated across multiple services.

Quick Start

Run a full inspection of your CloudBase environment by telling the agent: “Perform a CloudBase ops-inspector health check for the last 24 hours and summarize any critical errors with recommended next steps.”

Frequently Asked Questions about ops-inspector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform a health check on my CloudBase environment?

To perform a CloudBase health check, the ops-inspector verifies your bound environment, inspects Cloud Functions and CloudRun services for crashes, checks CLS log status, and generates a severity-based report with actionable recommendations.

What is AIOps-style log inspection for cloud functions?

AIOps-style log inspection aggregates resource states and recent error logs from Cloud Functions and CloudRun to pinpoint abnormal behavior, moving you from a general failure alert to actionable guidance without manual cross-checking.

Can I search CLS logs within a specific time window during incident triage?

Yes, during incident triage you can perform scoped log searches within a specific time window. The inspection verifies if Cloud Log Service is enabled and searches for error patterns to correlate failures across services.

Does CloudBase troubleshooting require CLS to be enabled for error detection?

CLS is optional but recommended for CloudBase troubleshooting. The inspection verifies CLS status and uses it to search for error patterns, but it can still inspect Cloud Functions and CloudRun resource health without it.

How do I identify if production errors are isolated or correlated across CloudRun services?

Request a full inspection for the last 24 hours to identify correlated errors. The tool cross-checks CloudRun and Cloud Functions, classifies severity levels, and produces a consolidated report indicating isolated or correlated issues.