Document IBM Cloud Monitoring and Observability integration

[pfeifferj]

Summary

Create documentation showing how to integrate Karpenter metrics and logs with IBM Cloud observability services.

Proposed Documentation

1. IBM Cloud Monitoring (Sysdig) Integration

• How to configure Prometheus remote write to IBM Cloud Monitoring
• Example Sysdig dashboard for Karpenter metrics
• Alert configurations for common scenarios:
  • High provisioning failure rate
  • Circuit breaker activations
  • Drift detection spikes

2. IBM Log Analysis (LogDNA) Integration

• How to ship Karpenter logs to IBM Log Analysis
• Log parsing rules for structured logging
• Example alert configurations for error patterns

3. IBM Secrets Manager Integration

• How to store IBM Cloud API keys in Secrets Manager
• Automatic API key rotation patterns
• Kubernetes External Secrets Operator integration

4. Example Configurations

# Example: Prometheus remote write to IBM Cloud Monitoring
remoteWrite:
  - url: "https://ingest.prws.us-south.monitoring.cloud.ibm.com/prometheus/remote/write"
    bearerToken: "<IBM_CLOUD_API_KEY>"

Deliverables

• docs/observability/ibm-cloud-monitoring.md - Sysdig integration guide
• docs/observability/ibm-log-analysis.md - LogDNA integration guide
• docs/observability/ibm-secrets-manager.md - Secrets Manager guide
• examples/monitoring/sysdig-dashboard.json - Example dashboard
• examples/monitoring/logdna-alerts.yaml - Example alert configs

Acceptance Criteria

• Documentation covers all three IBM Cloud services
• Working example configurations provided
• Screenshots or diagrams where helpful
• Tested against actual IBM Cloud services