adaptationio/observability-control
.claude/skills/observability-control/SKILL.md
Manage observability stack lifecycle (start, stop, backup, restore, upgrade). Use when controlling the LGTM stack for Claude Code monitoring.
$ install --global
skillsauthnpx skillsauth add adaptationio/skrillz observability-controlInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 31, 2026, 12:58 AM56.8s6 files scanned
SKILL.md
- name:
- observability-control
- description:
- Manage observability stack lifecycle (start, stop, backup, restore, upgrade). Use when controlling the LGTM stack for Claude Code monitoring.
Observability Control
Manage the lifecycle of the observability stack for Claude Code telemetry.
Stack Locations
| Environment | Docker Compose Path |
|-------------|---------------------|
| Primary Stack | /mnt/c/data/github/botaniqal-medtech/botaniqal-medtech/observability/docker-compose.yml |
| Skill-based Stack | /mnt/c/data/github/.observability/docker-compose.yml |
Components
| Service | Port | Purpose | |---------|------|---------| | Grafana | 3000 | Dashboards and visualization | | Prometheus | 9090 | Metrics storage | | Loki | 3100 | Log aggregation | | Tempo | 3200 | Distributed tracing | | OTEL Collector | 4317/4318 | Telemetry receiver | | Promtail | - | Log shipping |
Operations
start
Start observability stack.
docker compose -f /mnt/c/data/github/botaniqal-medtech/botaniqal-medtech/observability/docker-compose.yml up -d
stop
Stop stack gracefully (preserves data).
docker compose -f /mnt/c/data/github/botaniqal-medtech/botaniqal-medtech/observability/docker-compose.yml down
restart [service]
Restart specific service or all services.
# Restart all
docker compose -f /path/docker-compose.yml restart
# Restart specific
docker restart loki
status
Health check all components.
docker ps --format "table {{.Names}}\t{{.Status}}" | grep -E "(otel|loki|grafana|prometheus|tempo)"
Output: Running services, health status.
health
Verify service endpoints.
curl -s http://localhost:3000/api/health # Grafana
curl -s http://localhost:9090/-/healthy # Prometheus
curl -s http://localhost:3100/ready # Loki
curl -s http://localhost:3200/ready # Tempo
backup
Export dashboards and configurations.
# Backup dashboards
curl -s http://localhost:3000/api/search -u admin:admin | \
jq -r '.[].uid' | \
xargs -I {} curl -s http://localhost:3000/api/dashboards/uid/{} -u admin:admin > backup/dashboards.json
Output: .observability/backups/YYYYMMDD_HHMMSS/
restore <backup-path>
Restore from backup.
curl -X POST http://localhost:3000/api/dashboards/db \
-H "Content-Type: application/json" \
-u admin:admin \
-d @backup/dashboards.json
logs [service]
View logs from stack components.
docker logs loki --tail 100
docker logs otel-collector --tail 100
docker logs grafana --tail 100
fix-permissions
Fix volume permission issues (common with Tempo).
docker volume rm observability_tempo-data
docker volume create observability_tempo-data
docker run --rm -v observability_tempo-data:/tempo alpine chown -R 10001:10001 /tempo
docker restart tempo
Quick Commands
# Check all services status
docker ps | grep -E "(otel|loki|grafana|prometheus|tempo|promtail)"
# View recent logs for issues
docker logs otel-collector --tail 50 2>&1 | grep -i error
# Test OTLP endpoint
curl -v http://localhost:4317
# Query Loki for recent data
curl -s "http://localhost:3100/loki/api/v1/labels"
# List Grafana dashboards
curl -s http://localhost:3000/api/search -u admin:admin | python3 -c "import sys,json; [print(d['title']) for d in json.load(sys.stdin)]"
Troubleshooting
OTEL Collector Unhealthy
docker logs otel-collector --tail 30
# Common fix: Ensure Prometheus has --web.enable-remote-write-receiver
Loki Unhealthy
docker logs loki --tail 30
# Common fix: Disable frontend_worker for single-node mode
Tempo Permission Denied
# Fix volume permissions
docker volume rm observability_tempo-data
docker volume create observability_tempo-data
docker run --rm -v observability_tempo-data:/tempo alpine chown -R 10001:10001 /tempo
docker restart tempo
No Data in Grafana
- Check telemetry env vars:
env | grep OTEL - Check hooks configured:
cat .claude/settings.json - Verify Loki receiving:
curl "http://localhost:3100/loki/api/v1/labels"
Access Points
| Service | URL | Credentials | |---------|-----|-------------| | Grafana | http://localhost:3000 | admin/admin | | Prometheus | http://localhost:9090 | - | | Loki | http://localhost:3100 | - | | OTLP gRPC | localhost:4317 | - | | OTLP HTTP | localhost:4318 | - |
Scripts
scripts/start-stack.sh- Start observability stackscripts/stop-stack.sh- Stop stack gracefullyscripts/health-check.sh- Check all service healthscripts/backup-dashboards.sh- Export Grafana dashboardsscripts/restore-dashboards.sh- Import dashboards from backup
Related Skills
adaptationio/ttyd-remote-terminal-wsl2
development
VerifiedTrustedCommunity
Setup secure web-based terminal access to WSL2 from mobile/tablet via ttyd + ngrok/Cloudflare/Tailscale. One-command install, start, stop, status. Use when you need remote terminal access, web terminal, browser-based shell, or mobile access to WSL2 environment.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/tri-ai-collaboration
development
VerifiedTrustedCommunity
Complete development workflows where Claude writes the code while Gemini and Codex provide research, planning, reviews, and different perspectives. Claude remains the main developer. Use for complex projects requiring expert planning and multi-perspective reviews.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/todo-management
development
VerifiedTrustedCommunity
Systematic progress tracking for skill development. Manages task states (pending/in_progress/completed), updates in real-time, reports progress, identifies blockers, and maintains momentum. Use when tracking skill development, coordinating work, or reporting progress.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/testing-workflow
testing
VerifiedTrustedCommunity
Comprehensive testing workflow orchestrating functional testing, example validation, integration testing, and usability assessment. Sequential workflow for complete skill testing from examples through scenarios to integration validation. Use when conducting thorough testing, pre-deployment validation, ensuring skill functionality, or comprehensive quality checks.
6SKILL.mdUpdated Mar 28, 2026