Agent skill · software engineering · jeremylongshore
oraclecloud-debug-bundle
Collect OCI instance diagnostics \u2014 serial console, cloud-init logs,\
Why this skill is useful
Adds a comprehensive executable script for collecting OCI instance diagnostics that significantly extends the AI's capabilities in troubleshooting Oracle Cloud instances.
What it needs
Requires oci, python3 installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Oracle Cloud Debug Bundle Overview Collect comprehensive diagnostics from an unresponsive OCI compute instance without touching the OCI Console. When an instance reports "unavailable due to an issue with the underlying infrastructure" or cloud-init failures, you need serial console output, cloud-init logs, instance metadata, and VCN flow logs — all gathered via CLI commands into a single tar archive for root-cause analysis or support ticket attachment. Purpose: Generate a self-contained debug bundle (.tar.gz) with all the data OCI Support will ask for, collected in under 60 seconds. Prerequisites OCI CLI installed and configured — oci --version returns 3.x+, ~/.oci/config is valid (see oraclecloud-install-auth) Python 3.8+ with the OCI SDK — pip install oci Compartment OCID — the compartment containing the target instance Instance OCID — format: ocid1.instance.oc1.{region}.aaaa... IAM policies granting inspect instance-console-histories, read instances, read vcn-flow-logs in the target compartment Instructions Step 1: Set Target Variables Step 2: Capture Instance Metadata Step 3: Retrieve Serial Console History The serial console captures kernel panics, boot failures, and cloud-init output — even when SSH is unreachable: Step 4: Extract Cloud-Init Logs via Instance Agent If the instance agent is running, pull cloud-init logs via the run-command plugin: Step 5: Collect VCN Flow Logs Step 6: Query Instance Metrics Step 7: Package the Bundle Output Successful completion produces: A oci-debug-YYYYMMDD-HHMMSS.tar.gz archive containing five diagnostic files Instance metadata showing current lifecycle state, shape, and fault domain Serial console log capturing boot output, kernel messages, and cloud-init status Cloud-init execution logs (last 200 lines) retrieved via the instance agent VCN flow logs for the last hour to identify network-level issues CPU utilization metrics to detect resource exhaustion Error Handling Error Code Cause Solution ------- ------ ------- ------- …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/oraclecloud-debug-bundle