Add a Bandwidth subpage to the Usage section

umbraco-cloud/.gitbook.yaml

@@ -15,7 +15,7 @@ redirects:
     set-up/external-services: set-up/project-settings/external-services.md
     set-up/dedicated-resources: set-up/project-settings/dedicated-resources.md
     set-up/upgrade-umbraco-cloud-plan: set-up/project-settings/upgrade-umbraco-cloud-plan.md
-    set-up/usage: set-up/project-settings/usage.md
+    set-up/usage: set-up/project-settings/usage/README.md
     set-up/manage-subscriptions: set-up/manage-subscriptions/README.md
     upgrades/migrate-from-umbraco-10-to-11: product-upgrades/major-upgrades.md
     product-upgrades/migrate-a-umbraco-8-project-to-umbraco-10: product-upgrades/version-specific-upgrades/migrate-from-8-to-latest.md

umbraco-cloud/SUMMARY.md

@@ -51,7 +51,8 @@
     * [Troubleshooting](set-up/project-settings/umbraco-cicd/Troubleshooting.md)
     * [Known Limitations and Considerations](set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md)
   * [External Services](set-up/project-settings/external-services.md)
-  * [Usage](set-up/project-settings/usage.md)
+  * [Usage](set-up/project-settings/usage/README.md)
+    * [Bandwidth](set-up/project-settings/usage/bandwidth.md)
   * [Availability and Performance](set-up/project-settings/availability-performance.md)
   * [Team Members](set-up/project-settings/team-members/README.md)
     * [Technical Contact](set-up/project-settings/team-members/technical-contact.md)

umbraco-cloud/set-up/project-settings/README.md

@@ -40,7 +40,7 @@ On the project history page, you can see a history of activities that have happe
 
 You can see metrics related to the overall health and performance of the Azure app service hosting the live environment of your solution.
 
-### [Usage](usage.md)
+### [Usage](usage/)
 
 On your Umbraco Cloud project, it is possible to see the usage of Custom Domains, Media Storage, Content Nodes, and Bandwidth for the project. You can also check if it is using above or below the allowed amount for the plan that your project is on.
 

umbraco-cloud/set-up/project-settings/usage/bandwidth.md

@@ -0,0 +1,23 @@
+# Bandwidth
+
+Bandwidth in Umbraco Cloud refers to the amount of data transferred from your website to its visitors. Bandwidth is measured in Umbraco Cloud, and you can monitor your usage on the Umbraco Cloud Usage page.
+
+## What is Bandwidth?
+
+Bandwidth usage includes all data sent by your website. Every time a visitor loads a page, views images, or downloads files, data is transferred, contributing to your total bandwidth usage. This includes both requests served from the origin and those served from cache/edge.
+
+## How is Bandwidth Measured?
+
+In Umbraco Cloud, bandwidth is measured in gigabytes (GB). It represents the total amount of data transferred from your site to users over a period, typically one month. It is calculated by summarizing the `bytes_served` from all request logs at the edge. All requests, whether served from the edge or the origin, pass through the edge, so all egress bandwidth is summarized.
+
+<figure><img src="./images/bandwidth-flow-diagram.png" alt="Bandwidth data flow diagram"><figcaption></figcaption></figure>
+
+**What is Edge?**
+
+The "edge" refers to servers located closer to the end-users, which cache content to reduce latency and improve load times. By serving content from these edge servers, we can deliver data more efficiently and quickly to users.
+
+## How to Reduce Bandwidth Usage
+
+To avoid upgrades to higher Umbraco Cloud Tiers and improve performance, consider the following optimization techniques:
+*   **Optimize Images**: Compress images and use modern formats like WebP to reduce their size without losing quality.
+*   **Cache Static Content**: Leverage caching mechanisms to reduce the number of times static assets (like images, CSS, and JavaScript) are requested from the server. You can control your caching configuration here.