Reference
The Reference section is the fast lookup layer for operators who already know the workflow and need exact commands, limits, and option names.
Use these pages during deployment windows, incident triage, and change reviews when speed and precision matter.
Reference Pages
| Page | Primary Use | Typical Moment | Scope |
| EB CLI Cheatsheet | Find exact eb commands and long flags | Deploy, inspect, or recover an environment | Command-level |
| EB Diagnostics | Interpret eb status, eb health, eb logs, and events | Incident triage and deployment validation | Diagnostic interpretation |
| CloudWatch Logs Insights Queries | Run reusable log analysis queries for EB log groups | Live troubleshooting and post-incident review | Query reference |
| Platform Limits | Check service quotas and fixed platform constraints | Capacity planning and preflight checks | Quotas and limits |
| Environment Properties | Find namespace + option names for .ebextensions and API updates | Configuration design and review | Option settings |
| Troubleshooting Reference | Map common errors to likely causes and first fixes | Incident response | Error-to-resolution |
Reference Categories
flowchart LR
A[Reference] --> B[Commands]
A --> F[Diagnostics]
A --> C[Limits]
A --> D[Configuration]
A --> E[Troubleshooting]
B --> B1[EB CLI Cheatsheet]
F --> F1[EB Diagnostics]
F --> F2[CloudWatch Logs Insights Queries]
C --> C1[Platform Limits]
D --> D1[Environment Properties]
E --> E1[Troubleshooting Reference]
Lookup Matrix
Quick Navigation by Task
| Task Category | Fast Path | What to Extract |
| Deployments | Cheatsheet -> Troubleshooting | eb deploy flags, failed update error mappings |
| Diagnostics | EB Diagnostics -> CloudWatch Queries | Health meaning, event reading, reusable log analysis |
| Capacity Planning | Platform Limits -> Environment Properties | Account quotas, Auto Scaling and VPC options |
| Configuration Audits | Environment Properties -> Platform docs | Namespace defaults and drift candidates |
| Incident Triage | Troubleshooting -> Operations runbooks | Error family, first safe remediation |
Command and Option Conventions
| Convention | Rule | Example |
| CLI flags | Use long flags only | --application-name, --environment-name, --region |
| Placeholders | Mask account and resource PII | <account-id>, i-xxxxxxxxxxxxxxxxx, 10.0.x.x |
| Source policy | AWS docs only | https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/... |
| Tail sections | Always end with See Also then Sources | Required for every page |
Operator Workflow in 30 Seconds
| Step | Action | Output |
| 1 | Identify symptom (deployment, health, quota, permission) | Problem class |
| 2 | Open the matching reference page | Canonical command, query, limit, or namespace |
| 3 | Execute with long flags and masked placeholders | Reproducible, reviewable change |
| 4 | Cross-check in Platform or Operations section | Architectural and operational fit |
| 5 | If unresolved, pivot to troubleshooting playbooks | Deeper root-cause workflow |
Reference by Role
Internal Cross-Link Index
AWS API Alignment
| Reference Topic | Primary AWS API Family |
| EB CLI command actions | elasticbeanstalk:* control plane APIs |
| EB diagnostics | describe-environments, describe-environment-health, describe-instances-health |
| CloudWatch log analysis | logs:StartQuery, logs:GetQueryResults |
| Quotas and service ceilings | service-quotas:* APIs |
| Environment option updates | update-environment with option settings |
| Health diagnostics | describe-environment-health and describe-instances-health |
See Also
Sources