diff --git a/content/manuals/offload/usage.md b/content/manuals/offload/usage.md index dcc0161db143..f25d8f3df795 100644 --- a/content/manuals/offload/usage.md +++ b/content/manuals/offload/usage.md @@ -10,17 +10,20 @@ keywords: cloud, usage, cloud minutes, shared cache, top repositories, cloud bui > [!NOTE] > -> All free trial usage granted for the Docker Offload Beta expire after 90 days from the time they are granted. To -> continue using Docker Offload Beta after your usage expires, you can enable on-demand usage at [Docker Home +> All free trial usage granted for the Docker Offload Beta expire after 90 days +> from the time they are granted. To continue using Docker Offload Beta after +> your usage expires, you can enable on-demand usage at [Docker Home > Billing](https://app.docker.com/billing). ## Understand usage and billing models -Docker Offload offers two usage models to fit different team needs and usage patterns: +Docker Offload offers two usage models to fit different team needs and usage +patterns: -- Committed usage: This provides a committed amount of cloud compute time for your organization. -- On-demand usage: This provides pay-as-you-go flexibility. You can enable or disable on-demand usage in - [Billing](#manage-billing). +- Committed usage: This provides a committed amount of cloud compute time for + your organization. +- On-demand usage: This provides pay-as-you-go flexibility. You can enable or + disable on-demand usage in [Billing](#manage-billing). ## Manage billing @@ -34,35 +37,75 @@ can: - Track your organization's Docker Offload usage - Add or change payment methods -You must be an organization owner to manage billing. For more general information about billing, see -[Billing](../billing/_index.md). +You must be an organization owner to manage billing. For more general +information about billing, see [Billing](../billing/_index.md). ## Monitor your usage -The **Offload overview** page in Docker Home provides visibility into -how you are using cloud resources to build and run containers. +The **Offload activity** page in Docker Home provides visibility into how you +are using cloud resources to run containers. To monitor your usage: 1. Sign in to [Docker Home](https://app.docker.com/). 2. Select the account for which you want to monitor usage. -3. Select **Offload** > **Offload overview**. +3. Select **Offload** > **Offload activity**. -The following widgets are available: +### Overview metrics -- My recent sessions: This widget shows your total session time as well as a break down of your most recent sessions' - duration. -- My top 10 images: This widget shows the top 10 images used in Docker Offload in run sessions. It provides insight into - which images are most frequently used, helping you understand your container usage patterns. -- My active sessions: This widget displays any currently active Docker Offload sessions. +Key metrics at the top of the page summarize your Docker Offload usage: -### View recent activity +- **Total duration**: The total time spent in Offload sessions +- **Average duration**: The average time per Offload session +- **Total sessions**: The total number of Offload sessions +- **Unique images used**: The number of distinct container images used across + sessions +- **Unique users**: The number of different users in Docker Offload sessions -The **Recent activity** page in Docker Home provides detailed information about your recent Docker Offload sessions. -This includes session ID, start date and time, duration, and number of containers. +### Filter and export your data -To view the **Recent activity** page: +You can filter the Offload activity data by: -1. Sign in to [Docker Home](https://app.docker.com/). -2. Select the account for which you want to manage Docker Offload. -3. Select **Offload** > **Recent activity**. \ No newline at end of file +- **Period**: Select a preset time period or choose a custom date range +- **Users**: Organization owners and members with analytics permissions can + filter by specific users + +Export your session data by selecting the **Download CSV** button. The exported +file includes: + +- Session ID +- Username +- Image +- Started time +- Ended time +- Duration (in seconds) +- Status +- Container count + +The CSV export includes data for your selected date range and user filters, +letting you download exactly what you're viewing. + +### Activity cards + +The following cards provide insights into your Docker Offload usage: + +- **Offload usage**: Shows your usage trends over time and cloud resource + consumption patterns. If you have billing permissions, you can select the card + to view detailed billing information. +- **Popular images**: Shows the top 4 most frequently used container images in + your Docker Offload sessions. Select the card to see more images. +- **Top users**: Shows the top 4 users by session count and duration. Select + the card to see more users. + +### Offload sessions + +A detailed list of Offload sessions appears below the activity cards. The list: + +- Starts with any currently active sessions +- Shows session details including start time, duration, images used, and user + information +- Can be filtered using the date and user filters described above +- Displays **Offload sessions** if you have organization-wide analytics + permissions, or **My Offload sessions** if viewing only your own data + +Select any session to view more details in a side panel. \ No newline at end of file