Gcp Logs

The gcp-logs skill enables AI agents to query, filter, and analyze logs directly from Google Cloud Platform (GCP) infrastructure. It provides real-time visibility into system events, application errors, and operational metrics stored in Cloud Logging.

When to use it

• Troubleshoot production outages by retrieving specific error traces for a given time window.
• Monitor application health by setting up automated alerts based on log severity levels.
• Audit security events by searching for unauthorized access attempts or suspicious API calls.
• Debug distributed system failures by correlating logs across multiple GCP services like Compute Engine and Kubernetes Engine.

Key capabilities

• Query logs using standard SQL-like syntax (BigQuery format) within Cloud Logging.
• Filter results by resource labels, severity levels, and specific text patterns.
• Export log data for further analysis or archival purposes.
• Access logs from various GCP resources including Compute Engine, App Engine, and Cloud Run.

Example prompts

• "Show me all ERROR level logs from the 'payment-service' resource in the last hour."
• "Search for any failed authentication attempts on our GKE cluster nodes today."
• "Retrieve the full log stream for a specific Compute Engine instance with the label 'environment=production'."

Tips & gotchas

Ensure your AI agent has the necessary IAM permissions (such as logging.viewer) to access the target projects. Complex queries may require precise formatting of resource names and label keys to return accurate results.