| 1 | # Spaces and Rooms |
| 2 | |
| 3 | This guide explains how you can effectively organize your infrastructure monitoring using Netdata Cloud. |
| 4 | |
| 5 | ## Overview |
| 6 | |
| 7 | You can organize your monitoring with two primary concepts that work together. |
| 8 | |
| 9 | **Spaces** serve as your primary collaboration environment where you organize team members and manage access levels, connect nodes for monitoring, and create a unified monitoring environment. |
| 10 | |
| 11 | **Rooms** function as organizational units within Spaces that provide infrastructure-wide dashboards, real-time metrics visualization, focused monitoring views, and flexible node grouping. |
| 12 | |
| 13 | **Key Relationship:** Each node can only belong to **one** Space, but you can assign a node to **multiple** Rooms within that Space. |
| 14 | |
| 15 | ## Getting Started |
| 16 | |
| 17 | ### Create Your Space |
| 18 | |
| 19 | 1. Use the left-most sidebar to switch between Spaces |
| 20 | 2. Click the plus (**+**) icon to create a new Space |
| 21 | |
| 22 | :::tip |
| 23 | |
| 24 | You can create multiple Spaces, but we recommend using a single Space for most use cases. All team members in a Space can access its monitoring data based on their assigned roles. |
| 25 | |
| 26 | ::: |
| 27 | |
| 28 | ### Set Up Team Access |
| 29 | |
| 30 | 1. Click "Invite Users" in the Space's sidebar |
| 31 | 2. Set appropriate access levels: |
| 32 | - Rooms |
| 33 | - User roles |
| 34 | |
| 35 | :::tip |
| 36 | |
| 37 | **Best Practices for Team Access:** Invite all relevant team members (SRE, DevOps, ITOps) and configure role-based access control. Maintain clear permission hierarchies and conduct regular access reviews and updates. |
| 38 | |
| 39 | ::: |
| 40 | |
| 41 | ### Create Your First Room |
| 42 | |
| 43 | 1. Access Rooms through the Space's sidebar |
| 44 | 2. Click the green plus (**+**) icon next to "Rooms" to create new Rooms |
| 45 | |
| 46 | <img src="https://github.com/user-attachments/assets/16958ba8-53ac-4e78-a51f-7ea328e97f31" height="400px" alt="Individual Space sidebar"/> |
| 47 | |
| 48 | :::info |
| 49 | |
| 50 | All nodes automatically appear in the "All nodes" Room. Each Room has independent dashboards and monitoring tools. |
| 51 | |
| 52 | ::: |
| 53 | |
| 54 | ## Organize Your Infrastructure |
| 55 | |
| 56 | ### Room Organization Strategies |
| 57 | |
| 58 | | Strategy | Use Case | Examples | |
| 59 | |---------------------------------------|---------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |
| 60 | | **Service-Based Organization** | Group nodes by **specific services**, **purpose**, **location**, or **infrastructure type** | **Nginx**, **MySQL**, **Pulsar**, **webserver**, **database**, **application**, **physical location**, **bare metal**, **containers**, **cloud provider** | |
| 61 | | **End-to-End Application Monitoring** | Create Rooms for **complete application stacks** and **service dependencies** | **Complete SaaS product stacks**, **internal service dependencies**, **full application ecosystems** including **Kubernetes clusters**, **Docker containers**, **Proxies**, **Databases**, **Web servers**, **Message brokers** | |
| 62 | | **Incident Response** | Create dedicated Rooms for **troubleshooting** and **problem resolution** | **Active incident investigation**, **problem diagnosis**, **performance troubleshooting**, **root cause analysis** | |
| 63 | |
| 64 | ## Manage Your Setup |
| 65 | |
| 66 | ### Space Configuration |
| 67 | |
| 68 | 1. Select your Space |
| 69 | 2. Click **Space Settings** (⚙️) on the left sidebar below the spaces list |
| 70 | 3. Access settings for room management, node configuration, integration setup, and general Space settings |
| 71 | |
| 72 | ### Room Configuration |
| 73 | |
| 74 | 1. Click the ⚙️ next to the Room name |
| 75 | 2. Manage room access, node grouping, dashboard settings, and monitoring configurations |