diff --git a/concepts/monitoring-as-code.mdx b/concepts/monitoring-as-code.mdx index bf803912..828fa005 100644 --- a/concepts/monitoring-as-code.mdx +++ b/concepts/monitoring-as-code.mdx @@ -4,7 +4,7 @@ description: 'Define, version, and maintain your monitoring infrastructure along canonical: 'https://www.checklyhq.com/docs/concepts/monitoring-as-code/' --- -**Monitoring as Code (MaC)** treats monitoring configurations like any other code artifactversion controlled, reviewed, tested, and deployed through automated pipelines. +**Monitoring as Code (MaC)** treats monitoring configurations like any other code artifact—version controlled, reviewed, tested, and deployed through automated pipelines. With MaC, you can define, version, and maintain your monitoring infrastructure alongside your application code, reusing existing tests, code, data, and other assets to create a consistent, automated, and scalable monitoring setup. @@ -22,6 +22,22 @@ To get started with Monitoring as Code, see our [Constructs](/constructs/overvie **Infrastructure Automation**: Deploy monitoring changes through CI/CD pipelines with the same rigor as application deployments. +### Projects + +A **project** is the unit of deployment in monitoring as code. It bundles your checks, alert channels, and other resources with shared defaults and is identified by a `logicalId` that is unique within your Checkly account. Every project is defined in its own `checkly.config.ts` (or `checkly.config.js`) file at the project root, using the [Project construct](/constructs/project). + + + Projects page in the Checkly UI listing two projects with their repository, last deploy, sync status, and resource count + + +A single Checkly account can hold multiple projects. Each team can keep its monitoring code next to the service or repository it owns and deploy it independently, while all results stay in the same account. See [Logical IDs](/constructs/overview#logical-ids) for how projects and their resources are identified. + +Every resource deployed from a project with [`checkly deploy`](/cli/checkly-deploy) shows a **Managed by** section in the Checkly UI. It links to the project and shows the `logicalId` the resource has within it, so you can trace any check back to the code that defines it. + + + API check detail page in the Checkly UI with a Managed by row linking to the Storefront project and showing the logical ID api-products + + ## Benefits of Monitoring as Code @@ -42,4 +58,4 @@ Checkly supports monitoring as code through multiple approaches: - **[Pulumi Integration](/integrations/iac/pulumi/overview)**: Define monitoring using modern IaC patterns - **[API](/api-reference/overview)**: Programmatically manage checks in custom automation -This approach ensures your monitoring evolves with your applications, maintaining accuracy and reducing maintenance overhead. \ No newline at end of file +This approach ensures your monitoring evolves with your applications, maintaining accuracy and reducing maintenance overhead. diff --git a/images/projects-managed-by.png b/images/projects-managed-by.png new file mode 100644 index 00000000..31a2e481 Binary files /dev/null and b/images/projects-managed-by.png differ diff --git a/images/projects-overview.png b/images/projects-overview.png new file mode 100644 index 00000000..44348ce5 Binary files /dev/null and b/images/projects-overview.png differ