Skip to content

Operating Runbook — Medplum AWS Dev

After deployment, monitor

  • Application/API health.
  • ECS task health.
  • RDS database metrics.
  • Redis/ElastiCache metrics.
  • Load balancer errors and latency.
  • CloudWatch logs.
  • SES send/delivery status.
  • AWS budget alerts.

Upgrade process

Use Medplum documented commands after reviewing release notes:

npx cdk diff -c config=medplum.<env>.config.json
npx cdk deploy -c config=medplum.<env>.config.json
npx medplum aws update-app <env>
npx medplum aws update-server <env>

Database rule

Do not manually alter the PostgreSQL schema unless there is a documented, reviewed reason. Medplum manages its own schema.

Incident notes

For any issue, capture:

  • Date/time.
  • User-visible impact.
  • AWS services affected.
  • Logs/screenshots/metrics.
  • Action taken.
  • Follow-up prevention work.