QwenClaw v2.0 - Complete Rebuild with ALL 81+ Skills
This commit is contained in:
@@ -0,0 +1,11 @@
|
||||
{
|
||||
"name": "gcloud-tools",
|
||||
"version": "2.0.2",
|
||||
"description": "Google Cloud Observability MCP for logs, metrics, and traces with best practices skill.",
|
||||
"author": {
|
||||
"name": "Fatih Akyon"
|
||||
},
|
||||
"homepage": "https://github.com/fcakyon/claude-codex-settings#plugins",
|
||||
"repository": "https://github.com/fcakyon/claude-codex-settings",
|
||||
"license": "Apache-2.0"
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"gcloud-observability": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "@google-cloud/observability-mcp"]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,104 @@
|
||||
---
|
||||
description: Configure GCloud CLI authentication
|
||||
---
|
||||
|
||||
# GCloud Tools Setup
|
||||
|
||||
**Source:** [googleapis/gcloud-mcp](https://github.com/googleapis/gcloud-mcp)
|
||||
|
||||
Check GCloud MCP status and configure CLI authentication if needed.
|
||||
|
||||
## Step 1: Check gcloud CLI
|
||||
|
||||
Run: `gcloud --version`
|
||||
|
||||
If not installed: Continue to Step 2.
|
||||
If installed: Skip to Step 3.
|
||||
|
||||
## Step 2: Install gcloud CLI
|
||||
|
||||
Tell the user:
|
||||
|
||||
```
|
||||
Install Google Cloud SDK:
|
||||
|
||||
macOS (Homebrew):
|
||||
brew install google-cloud-sdk
|
||||
|
||||
macOS/Linux (Manual):
|
||||
curl https://sdk.cloud.google.com | bash
|
||||
exec -l $SHELL
|
||||
|
||||
Windows:
|
||||
Download from: https://cloud.google.com/sdk/docs/install
|
||||
|
||||
After install, restart your terminal.
|
||||
```
|
||||
|
||||
## Step 3: Authenticate
|
||||
|
||||
Run these commands:
|
||||
|
||||
```bash
|
||||
# Login with your Google account
|
||||
gcloud auth login
|
||||
|
||||
# Set up Application Default Credentials (required for MCP)
|
||||
gcloud auth application-default login
|
||||
```
|
||||
|
||||
Both commands will open a browser for authentication.
|
||||
|
||||
## Step 4: Set Default Project
|
||||
|
||||
```bash
|
||||
# List available projects
|
||||
gcloud projects list
|
||||
|
||||
# Set default project
|
||||
gcloud config set project YOUR_PROJECT_ID
|
||||
```
|
||||
|
||||
## Step 5: Verify Setup
|
||||
|
||||
Run: `gcloud auth list`
|
||||
|
||||
Should show your authenticated account with asterisk (\*).
|
||||
|
||||
## Step 6: Restart Claude Code
|
||||
|
||||
Tell the user:
|
||||
|
||||
```
|
||||
After authentication:
|
||||
1. Exit Claude Code
|
||||
2. Run `claude` again
|
||||
|
||||
The MCP will use your gcloud credentials.
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If GCloud MCP fails:
|
||||
|
||||
```
|
||||
Common fixes:
|
||||
1. ADC not found - Run gcloud auth application-default login
|
||||
2. Project not set - Run gcloud config set project PROJECT_ID
|
||||
3. Permission denied - Check IAM roles in Cloud Console
|
||||
4. Quota exceeded - Check quotas in Cloud Console
|
||||
5. Token expired - Run gcloud auth application-default login again
|
||||
```
|
||||
|
||||
## Alternative: Disable Plugin
|
||||
|
||||
If user doesn't need GCloud integration:
|
||||
|
||||
```
|
||||
To disable this plugin:
|
||||
1. Run /mcp command
|
||||
2. Find the gcloud-observability server
|
||||
3. Disable it
|
||||
|
||||
This prevents errors from missing authentication.
|
||||
```
|
||||
@@ -0,0 +1,148 @@
|
||||
---
|
||||
name: gcloud-usage
|
||||
description: This skill should be used when user asks about "GCloud logs", "Cloud Logging queries", "Google Cloud metrics", "GCP observability", "trace analysis", or "debugging production issues on GCP".
|
||||
---
|
||||
|
||||
# GCP Observability Best Practices
|
||||
|
||||
## Structured Logging
|
||||
|
||||
### JSON Log Format
|
||||
|
||||
Use structured JSON logging for better queryability:
|
||||
|
||||
```json
|
||||
{
|
||||
"severity": "ERROR",
|
||||
"message": "Payment failed",
|
||||
"httpRequest": { "requestMethod": "POST", "requestUrl": "/api/payment" },
|
||||
"labels": { "user_id": "123", "transaction_id": "abc" },
|
||||
"timestamp": "2025-01-15T10:30:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
### Severity Levels
|
||||
|
||||
Use appropriate severity for filtering:
|
||||
|
||||
- **DEBUG:** Detailed diagnostic info
|
||||
- **INFO:** Normal operations, milestones
|
||||
- **NOTICE:** Normal but significant events
|
||||
- **WARNING:** Potential issues, degraded performance
|
||||
- **ERROR:** Failures that don't stop the service
|
||||
- **CRITICAL:** Failures requiring immediate action
|
||||
- **ALERT:** Person must take action immediately
|
||||
- **EMERGENCY:** System is unusable
|
||||
|
||||
## Log Filtering Queries
|
||||
|
||||
### Common Filters
|
||||
|
||||
```
|
||||
# By severity
|
||||
severity >= WARNING
|
||||
|
||||
# By resource
|
||||
resource.type="cloud_run_revision"
|
||||
resource.labels.service_name="my-service"
|
||||
|
||||
# By time
|
||||
timestamp >= "2025-01-15T00:00:00Z"
|
||||
|
||||
# By text content
|
||||
textPayload =~ "error.*timeout"
|
||||
|
||||
# By JSON field
|
||||
jsonPayload.user_id = "123"
|
||||
|
||||
# Combined
|
||||
severity >= ERROR AND resource.labels.service_name="api"
|
||||
```
|
||||
|
||||
### Advanced Queries
|
||||
|
||||
```
|
||||
# Regex matching
|
||||
textPayload =~ "status=[45][0-9]{2}"
|
||||
|
||||
# Substring search
|
||||
textPayload : "connection refused"
|
||||
|
||||
# Multiple values
|
||||
severity = (ERROR OR CRITICAL)
|
||||
```
|
||||
|
||||
## Metrics vs Logs vs Traces
|
||||
|
||||
### When to Use Each
|
||||
|
||||
**Metrics:** Aggregated numeric data over time
|
||||
|
||||
- Request counts, latency percentiles
|
||||
- Resource utilization (CPU, memory)
|
||||
- Business KPIs (orders/minute)
|
||||
|
||||
**Logs:** Detailed event records
|
||||
|
||||
- Error details and stack traces
|
||||
- Audit trails
|
||||
- Debugging specific requests
|
||||
|
||||
**Traces:** Request flow across services
|
||||
|
||||
- Latency breakdown by service
|
||||
- Identifying bottlenecks
|
||||
- Distributed system debugging
|
||||
|
||||
## Alert Policy Design
|
||||
|
||||
### Alert Best Practices
|
||||
|
||||
- **Avoid alert fatigue:** Only alert on actionable issues
|
||||
- **Use multi-condition alerts:** Reduce noise from transient spikes
|
||||
- **Set appropriate windows:** 5-15 min for most metrics
|
||||
- **Include runbook links:** Help responders act quickly
|
||||
|
||||
### Common Alert Patterns
|
||||
|
||||
**Error rate:**
|
||||
|
||||
- Condition: Error rate > 1% for 5 minutes
|
||||
- Good for: Service health monitoring
|
||||
|
||||
**Latency:**
|
||||
|
||||
- Condition: P99 latency > 2s for 10 minutes
|
||||
- Good for: Performance degradation detection
|
||||
|
||||
**Resource exhaustion:**
|
||||
|
||||
- Condition: Memory > 90% for 5 minutes
|
||||
- Good for: Capacity planning triggers
|
||||
|
||||
## Cost Optimization
|
||||
|
||||
### Reducing Log Costs
|
||||
|
||||
- **Exclusion filters:** Drop verbose logs at ingestion
|
||||
- **Sampling:** Log only percentage of high-volume events
|
||||
- **Shorter retention:** Reduce default 30-day retention
|
||||
- **Downgrade logs:** Route to cheaper storage buckets
|
||||
|
||||
### Exclusion Filter Examples
|
||||
|
||||
```
|
||||
# Exclude health checks
|
||||
resource.type="cloud_run_revision" AND httpRequest.requestUrl="/health"
|
||||
|
||||
# Exclude debug logs in production
|
||||
severity = DEBUG
|
||||
```
|
||||
|
||||
## Debugging Workflow
|
||||
|
||||
1. **Start with metrics:** Identify when issues started
|
||||
2. **Correlate with logs:** Filter logs around problem time
|
||||
3. **Use traces:** Follow specific requests across services
|
||||
4. **Check resource logs:** Look for infrastructure issues
|
||||
5. **Compare baselines:** Check against known-good periods
|
||||
@@ -0,0 +1,18 @@
|
||||
---
|
||||
name: setup
|
||||
description: This skill should be used when user encounters "ADC not found", "gcloud auth error", "GCloud MCP error", "Application Default Credentials", "project not set", or needs help configuring GCloud integration.
|
||||
---
|
||||
|
||||
# GCloud Tools Setup
|
||||
|
||||
Run `/gcloud-tools:setup` to configure GCloud MCP.
|
||||
|
||||
## Quick Fixes
|
||||
|
||||
- **ADC not found** - Run `gcloud auth application-default login`
|
||||
- **Project not set** - Run `gcloud config set project PROJECT_ID`
|
||||
- **Permission denied** - Check IAM roles in Cloud Console
|
||||
|
||||
## Don't Need GCloud?
|
||||
|
||||
Disable via `/mcp` command to prevent errors.
|
||||
Reference in New Issue
Block a user