{"id":25519702,"url":"https://github.com/aligent/cdk-cloudwatch-rds-alert","last_synced_at":"2025-12-22T10:30:13.086Z","repository":{"id":45165930,"uuid":"436418976","full_name":"aligent/cdk-cloudwatch-rds-alert","owner":"aligent","description":null,"archived":false,"fork":false,"pushed_at":"2022-09-14T01:59:23.000Z","size":170,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-02-16T13:23:56.437Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aligent.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-08T23:10:29.000Z","updated_at":"2022-09-14T01:58:53.000Z","dependencies_parsed_at":"2023-01-18T06:45:27.629Z","dependency_job_id":null,"html_url":"https://github.com/aligent/cdk-cloudwatch-rds-alert","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fcdk-cloudwatch-rds-alert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fcdk-cloudwatch-rds-alert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fcdk-cloudwatch-rds-alert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fcdk-cloudwatch-rds-alert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aligent","download_url":"https://codeload.github.com/aligent/cdk-cloudwatch-rds-alert/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239703297,"owners_count":19683242,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-19T17:29:25.742Z","updated_at":"2025-12-22T10:30:12.992Z","avatar_url":"https://github.com/aligent.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Create CloudWatch Alerts for RDS Instance CPU Usage\n\n## Archived\nFurther updates can be found here https://github.com/aligent/cdk-stacks/tree/main/packages/cloudwatch-rds-alert\n\n## Introduction\nThis stack creates CloudWatch alerts for a given RDS instances and configure Slack notification for them, incorporating CDKv2.0.\n\n## Usage\nYou just need `AWS profiles` properly configured and `docker` installed to use this; you don't need `CDK`, `Node` or other tools. \nThis ensures all the commands are run inside the docker container so that you don't need to fork/clone the repo or to deal with version compatibilities, etc.\n\nBefore moving on, make sure the below have been completed:\n\n- Bootstrap your environment with CDKv2.x (https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html)\n- Create Slack Channel and Incoming Webhook URL (https://api.slack.com/messaging/webhooks)\n- Save the Webhook URL in SSM Parameter store (https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html)\n \n### Interactive Mode:\nJust run this command for an interactive deployment:\n\n`docker run --rm -it --volume ~/.aws:/home/node/.aws aligent/cdk-cloudwatch-rds-alert`\n\nIt will ask a few parameters including:\n\n- RDS Instances: **comma-separated** list of RDS instance identifiers\n- SSM Parameter: the SSM parameter name where the Webhook URL is stored\n- Slack Alert User Name and Channel\n\n### Headless Mode\nYou can run a one-liner by specifying all the arguments required:\n\n`docker run --rm -it --volume ~/.aws:/home/node/.aws aligent/cdk-cloudwatch-rds-alert --profile \u003cAWS_PROFILE\u003e --rds-instances \u003cRDS_INSTANCE_ID\u003e --security-group \u003cSECURITY_GROUP\u003e --slack-webhook-url-ssm \u003cAWS_SSM_PARAMETER_FOR_SLACK_WEBHOOK_URL\u003e --slack-channel \u003cSLACK_CHANNEL\u003e [--slack-username \u003cSLACK_USERNAME\u003e]`\n\n*Note: if you run the command once again against the same account with different parameters, the existing stack will be overwritten.*\n\n## Limitations\nThe only available RDS CPU metric in CDK is \"Average 5 over minutes\". Therefore the alerts fire off with one violation.\nhttps://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_rds.DatabaseInstance.html#metricwbrcpuutilizationprops\n\n## Future updates\n- Optional: DB alias and alert threshold\n- Additional monitoring metrics, e.g. per cent of max_connections\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faligent%2Fcdk-cloudwatch-rds-alert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faligent%2Fcdk-cloudwatch-rds-alert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faligent%2Fcdk-cloudwatch-rds-alert/lists"}