OpsCanary
observabilitysyntheticPractitioner

Scaling Synthetic Monitoring: Mastering Folders in Grafana Cloud

5 min read Grafana BlogOct 7, 2026Reviewed for accuracy
Share
Practitioner — Hands-on experience recommended

As your infrastructure grows, so does the complexity of managing synthetic checks. Grafana Cloud's introduction of Synthetic Monitoring folders addresses this challenge by allowing you to organize checks into a structured hierarchy. This organization not only simplifies management but also enhances clarity and accessibility for teams working with multiple checks across various services.

When creating or editing a synthetic check, you can select a folder from your folder tree, such as your team's folder or a service-specific folder. If you don't specify a folder, checks created through the API or Terraform default to the Synthetic Monitoring folder. Importantly, if a folder is deleted, its checks automatically migrate to the default folder, ensuring continuous monitoring without disruption. The gcx CLI further empowers you to assign checks to folders directly from the command line, streamlining your workflow.

In production, understanding folder permissions and how they interact with Synthetic Monitoring roles is crucial. This setup allows you to control which users or teams can manage specific folders, enhancing security and organization. Make sure you are using Terraform provider v4.37.0 or later to take full advantage of these features. Keep an eye on your folder structure as it can significantly impact your monitoring efficiency and clarity.

Key takeaways

  • →Utilize folders to organize synthetic checks for better management.
  • →Assign checks to specific folders using the gcx CLI for streamlined operations.
  • →Understand folder permissions to control access and management effectively.
  • →Monitor the default folder for checks created without a specified folder.
  • →Ensure you are on Terraform provider v4.37.0 or later to use folder features.

Why it matters

In production, effective organization of synthetic checks can drastically reduce the time spent managing and troubleshooting monitoring issues, leading to quicker response times and improved system reliability.

Code examples

plaintext
terraform plan

When NOT to use this

The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.

Want the complete reference?

Read official docs

Test what you just learned

Quiz questions written from this article

Take the quiz →
DigitalOcean Serverless InferenceSponsor

OpenAI & Anthropic-compatible inference API — no GPU provisioning needed. 55+ models, pay-per-token with no minimums. VPC + zero data retention by default.

Try Serverless Inference →

Get the daily digest

One email. 5 articles. Every morning.

No spam. Unsubscribe anytime.