|
1 | 1 | # Dashboards Tab |
2 | 2 |
|
3 | | -With **Netdata Cloud**, you can build **custom dashboards** that target your infrastructure’s unique needs. Dashboards help you centralize key metrics from any number of distributed systems, offering a clear, interactive overview of your infrastructure. |
| 3 | +With **Netdata Cloud**, you can build **custom dashboards** that target your infrastructure's unique needs. Dashboards help you centralize key metrics from any number of distributed systems, offering a clear, interactive overview of your infrastructure. |
4 | 4 |
|
5 | 5 | Click the **Dashboards** tab in any Room to get started. |
6 | 6 |
|
@@ -136,10 +136,52 @@ If multiple users edit the same dashboard at once, the second user who clicks ** |
136 | 136 |
|
137 | 137 | ::: |
138 | 138 |
|
| 139 | +## TV Mode |
| 140 | + |
| 141 | +**TV Mode** generates shareable, token-authenticated URLs for displaying dashboards on large screens without requiring a login. This is ideal for displaying critical metrics on TVs, wallboards, or shared monitors in operations centers and team spaces. |
| 142 | + |
| 143 | +### How to Use TV Mode |
| 144 | + |
| 145 | +1. Open the dashboard you want to display. |
| 146 | +2. Click the **TV Mode** button in the dashboard action bar (located next to the **Save** button). |
| 147 | +3. A modal will appear with a generated URL that includes an embedded access token and preserves your current time range settings. |
| 148 | +4. Copy the URL and open it in a browser on your display device. |
| 149 | + |
| 150 | +### How It Works |
| 151 | + |
| 152 | +When you generate a TV Mode URL: |
| 153 | + |
| 154 | +- **Automatic Token Creation**: Netdata Cloud automatically creates an API token with full scope (`scope:all`) for authentication. |
| 155 | +- **Embedded Authentication**: The generated URL includes the access token, allowing the dashboard to load without requiring a login. |
| 156 | +- **Time Range Preservation**: The URL captures your current time range settings, so viewers see the same data timeframe you selected. |
| 157 | +- **Optimized Display**: The dashboard renders in a TV-optimized display mode for large screens. |
| 158 | + |
| 159 | +### Use Cases |
| 160 | + |
| 161 | +TV Mode is perfect for: |
| 162 | + |
| 163 | +- **Network Operations Centers (NOCs)**: Display critical infrastructure metrics on large screens for 24/7 monitoring. |
| 164 | +- **Operations Centers**: Keep teams informed with real-time system health and performance dashboards. |
| 165 | +- **Team Spaces**: Share dashboards on shared screens or wallboards for collaborative monitoring. |
| 166 | +- **Wallboard-Style Monitoring**: Create persistent displays for continuous metric visibility. |
| 167 | + |
| 168 | +### Security Considerations |
| 169 | + |
| 170 | +:::warning |
| 171 | + |
| 172 | +TV Mode URLs contain unique access tokens that provide full access to your Netdata Cloud dashboards and are embedded directly in the URL. Treat these URLs like secrets and **share them only with trusted users**. |
| 173 | + |
| 174 | +::: |
| 175 | + |
| 176 | +- **Token Security**: Anyone with the TV Mode URL can access the dashboard without authentication. |
| 177 | +- **Token Management**: TV Mode tokens can be viewed and revoked in **User Settings > API Tokens**. Learn more in the [API Tokens documentation](/docs/netdata-cloud/authentication-and-authorization/api-tokens.md). |
| 178 | +- **Safe Handling**: Because the access token is in the URL, it can appear in browser history, logs, screenshots, clipboard managers, or HTTP Referer headers. Avoid posting TV Mode URLs in tickets, chats, or other shared channels, and revoke the token immediately if the URL is exposed. |
| 179 | +- **Revocation & Lifecycle**: TV Mode tokens do not expire automatically; manage their lifecycle by revoking tokens when they're no longer needed. |
| 180 | + |
139 | 181 | ## Minimum Browser Viewport Requirement |
140 | 182 |
|
141 | 183 | Due to the visual complexity of individual charts, dashboards require a **minimum browser viewport width of 800px**. |
142 | 184 |
|
143 | 185 | ## Next Steps |
144 | 186 |
|
145 | | -After designing your dashboards, [invite your team](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#set-up-team-access) to collaborate. Add new users to the same Room so they can view and interact with your dashboards effortlessly. |
| 187 | +After designing your dashboards, [invite your team](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#set-up-team-access) to collaborate. Add new users to the same Room so they can view and interact with your dashboards effortlessly. |
0 commit comments