# yogesh09-git/serverless-cloud-auto-remediation architecture

> Architecture diagram of the GitHub repository yogesh09-git/serverless-cloud-auto-remediation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yogesh09-git/serverless-cloud-auto-remediation
- Repository: https://github.com/yogesh09-git/serverless-cloud-auto-remediation

## Overview

This repository describes a serverless AWS auto-remediation platform, with its infrastructure defined in one CloudFormation template. The documented workflow monitors EC2 metrics, routes high-CPU alerts through CloudWatch and EventBridge to a Lambda remediation function, and records incidents in DynamoDB. A separate access branch exposes incident data through API Gateway to a dashboard hosted in S3. The README documents these relationships; no source excerpts were available to verify implementation details or the specific remediation action.

Main entry points: [`Auto_Remediation_IaC_CloudFormation.yaml`](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml) (CloudFormation Stack)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["Infrastructure"]
  node_cloudformation["CloudFormation Stack"]
end

subgraph group_remediation["Detection &amp; Remediation"]
  node_ec2["EC2 Resources"]
  node_cloudwatch["CloudWatch Monitoring"]
  node_eventbridge["EventBridge Routing"]
  node_lambda["Remediation Lambda"]
end

subgraph group_incident_access["Incident Access"]
  node_dynamodb[("Incident Records")]
  node_api_gateway["API Gateway"]
  node_s3[("Dashboard Hosting")]
  node_dashboard["Dashboard"]
end

node_cloudformation -->|"provisions"| node_ec2
node_cloudformation -->|"provisions"| node_cloudwatch
node_cloudformation -->|"provisions"| node_eventbridge
node_cloudformation -->|"provisions"| node_lambda
node_cloudformation -->|"provisions"| node_dynamodb
node_cloudformation -->|"provisions"| node_api_gateway
node_cloudformation -->|"provisions"| node_s3
node_ec2 -->|"emits metrics"| node_cloudwatch
node_cloudwatch -->|"triggers"| node_eventbridge
node_eventbridge -->|"invokes"| node_lambda
node_lambda -->|"stores incidents"| node_dynamodb
node_lambda -.->|"remediates"| node_ec2
node_api_gateway -->|"accesses incidents"| node_dynamodb
node_api_gateway -->|"provides incident data"| node_dashboard
node_s3 -->|"hosts"| node_dashboard

click node_cloudformation "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"
click node_ec2 "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"
click node_cloudwatch "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"
click node_eventbridge "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"
click node_lambda "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"
click node_dynamodb "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"
click node_api_gateway "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"
click node_s3 "https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cloudformation toneBlue
class node_ec2,node_cloudwatch,node_eventbridge,node_lambda toneAmber
class node_dynamodb,node_api_gateway,node_s3,node_dashboard toneMint
```

## Components

### Infrastructure

- [CloudFormation Stack](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`

### Detection & Remediation

- [EC2 Resources](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`
- [CloudWatch Monitoring](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`
- [EventBridge Routing](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`
- [Remediation Lambda](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`

### Incident Access

- [Incident Records](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`
- [API Gateway](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`
- [Dashboard Hosting](https://github.com/yogesh09-git/serverless-cloud-auto-remediation/blob/main/Auto_Remediation_IaC_CloudFormation.yaml): `Auto_Remediation_IaC_CloudFormation.yaml`
- **Dashboard**

## Connections

- CloudFormation Stack → EC2 Resources: provisions (evidence: `Readme.md`)
- CloudFormation Stack → CloudWatch Monitoring: provisions (evidence: `Readme.md`)
- CloudFormation Stack → EventBridge Routing: provisions (evidence: `Readme.md`)
- CloudFormation Stack → Remediation Lambda: provisions (evidence: `Readme.md`)
- CloudFormation Stack → Incident Records: provisions (evidence: `Readme.md`)
- CloudFormation Stack → API Gateway: provisions (evidence: `Readme.md`)
- CloudFormation Stack → Dashboard Hosting: provisions (evidence: `Readme.md`)
- EC2 Resources → CloudWatch Monitoring: emits metrics (evidence: `Readme.md`)
- CloudWatch Monitoring → EventBridge Routing: triggers (evidence: `Readme.md`)
- EventBridge Routing → Remediation Lambda: invokes (evidence: `Readme.md`)
- Remediation Lambda → Incident Records: stores incidents (evidence: `Readme.md`)
- Remediation Lambda → EC2 Resources: remediates
- API Gateway → Incident Records: accesses incidents (evidence: `Readme.md`)
- API Gateway → Dashboard: provides incident data (evidence: `Readme.md`)
- Dashboard Hosting → Dashboard: hosts (evidence: `Readme.md`)
