{"id":36872835,"url":"https://github.com/observeinc/cloudformation-aws-collection","last_synced_at":"2026-01-12T15:03:10.936Z","repository":{"id":76081757,"uuid":"549887756","full_name":"observeinc/cloudformation-aws-collection","owner":"observeinc","description":" CloudFormation templates for assembling different methods of collecting data from AWS into Observe","archived":false,"fork":false,"pushed_at":"2024-04-30T00:05:22.000Z","size":97,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-04-30T22:02:00.310Z","etag":null,"topics":["aws","cloudformation-template","integrationname-aws","integrations"],"latest_commit_sha":null,"homepage":"https://docs.observeinc.com/en/latest/content/integrations/aws/aws.html#installation","language":"HCL","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/observeinc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-11T22:30:08.000Z","updated_at":"2024-04-30T00:05:24.000Z","dependencies_parsed_at":"2023-05-06T22:46:18.996Z","dependency_job_id":"7ded8e96-f2f2-4e7c-a0c3-92c282f85c09","html_url":"https://github.com/observeinc/cloudformation-aws-collection","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/observeinc/cloudformation-aws-collection","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/observeinc%2Fcloudformation-aws-collection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/observeinc%2Fcloudformation-aws-collection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/observeinc%2Fcloudformation-aws-collection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/observeinc%2Fcloudformation-aws-collection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/observeinc","download_url":"https://codeload.github.com/observeinc/cloudformation-aws-collection/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/observeinc%2Fcloudformation-aws-collection/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28340416,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aws","cloudformation-template","integrationname-aws","integrations"],"created_at":"2026-01-12T15:03:06.803Z","updated_at":"2026-01-12T15:03:10.930Z","avatar_url":"https://github.com/observeinc.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Observe AWS Collection CloudFormation Templates\n\nThis repository contains a set of CloudFormation templates for\nassembling different methods of collecting data from AWS into\nObserve. It is intended as both a starting point and as a reference.\n\nThe main template `collection.yaml` sets up the following forwarding methods:\n\n- the Observe lambda\n- an S3 bucket, subscribed to the aforementioned Lambda\n- a Firehose stream\n\nGiven these egresses, we extract data from the following sources:\n\n- Cloudwatch Metrics, via Firehose\n- CloudTrail, via S3\n- EventBridge, via Firehose\n- AWS snapshot data, via Lambda\n\n# Usage\n\nWhen creating a CloudFormation stack, set the S3 URL to [`https://observeinc.s3-us-west-2.amazonaws.com/cloudformation/collection-latest.yaml`](https://observeinc.s3-us-west-2.amazonaws.com/cloudformation/collection-latest.yaml).\n\n# Control Tower\nWhen creating a CloudFormation for **control tower**, set the S3 URL to https://observeinc.s3-us-west-2.amazonaws.com/cloudformation/controltower-latest.yaml\n\nFor pinned template versions, see [the Observe Collection CF template change log](https://github.com/observeinc/cloudformation-aws-collection/blob/main/CHANGELOG.md) in GitHub.\n\n# Release Process\n\n## Automated Release via GitHub Actions\n\nThe preferred method for releasing new versions of the CloudFormation templates is through the automated GitHub Actions workflow.\n\n1. **Initiate the Release Workflow**: Go to the \"Actions\" tab in the GitHub repository and select the \"Release\" workflow. Then, click on \"Run workflow\" to manually start the release process. The action takes care of the rest: generating changelogs, uploading the CloudFormation templates to S3, and creating a GitHub release.\n\n## Manual Release Using Make\n\nIf for any reason the GitHub Action workflow fails, you can manually release the templates using the `Makefile` provided in the repository:\n\n1. **Set the Release Version**: Before starting, ensure you have an environment variable `RELEASE_VERSION` set with the desired release version. For instance, if you want to release version `v1.2.3`, you'd set:\n   \n   ```bash\n   export RELEASE_VERSION=v1.2.3\n   ```\n\n2. **Run the Release**: Execute the `make release` command:\n\n   ```bash\n   make release\n   ```\n\n3. **Verify Templates on S3**: Ensure that the CloudFormation templates have been uploaded to the S3 bucket under both version-specific and `latest` paths.\n\n4. **Create a GitHub Release**: Manually create a GitHub release, setting both the tag name and release name to the `RELEASE_VERSION` value. Make sure to include the changelog or relevant changes in the release description.\n\nRemember: Ensure you have the necessary AWS credentials and permissions set up when manually executing the `Makefile` release process.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobserveinc%2Fcloudformation-aws-collection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fobserveinc%2Fcloudformation-aws-collection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobserveinc%2Fcloudformation-aws-collection/lists"}