Manage Your Cloud Usage

📘
Subscription Information
This feature is supported on the Cloud (SaaS) platform for all licenses.

When you log in to MyJFrog, you can see an overall view of your current data usage in the MyJFrog Cloud Portal Dashboard. Click the Usage Explorer page (or the specific date on the dashboard) on the left to see a more detailed breakdown of information about your cloud usage.

Usage Explorer

If your subscription includes additional services such as JFrog Advanced Security (JAS), or Curation, the Usage Explorer in MyJFrog provides detailed insights into how these services are being used over time. It helps you monitor scan activity and curated package results.

❗️
Important
Data Transfer, Data Storage, Consumption, and Projects usage are currently available only in SaaS subscriptions.

Charts and Visualization

The Usage Explorer provides several visualization modes to help you analyze data trends:

Line chart: View changes over time.
Stacked chart: Compare multiple values layered on top of each other.
Grouped chart: Compare values side by side.

Charts update dynamically based on the selected time range, group by option, and granularity (daily or monthly). You can also export results for reporting and analysis.

Advanced Security

The Advanced Security tab shows the total number of scans performed by JFrog Advanced Security.

Scans can be grouped and analyzed at different levels:

Subscription level: Total scans across your account.
By JPD: Scans per deployment.
By Repository: Scans per repository.

Availability: Enterprise X and Enterprise+ subscriptions with Advanced Security add-on.

Filters:

Date range: Last 14 days, 30 days, 3 months, 6 months, or a custom range.
Group by: None, JPD, Repository.
Granularity: Daily or Monthly.

Curation

The Curation tab provides visibility into curated packages from remote repositories.

The data includes the following:

Subscription level: Aggregated number of curated packages.
By Verdict: Packages allowed (approved) or blocked.
By Package Type: Breakdown by package technology (for example, Maven, npm, PyPI).

Availability: Enterprise X and Enterprise+ subscriptions with Curation add-on.

Visualization

You have the following tabs available in the Usage Explorer page for visualization.

📘
Note
Data Transfer, Data Storage, and Consumption tabs are available as options within a single dropdown list, where they are displayed as separate tabs when selected.

Data Transfer
Data Storage
Consumption
Projects
Advanced Security
Curation

Charts View

You can select from the following views to visualize the data usage.

📘
Note
The charts display the data based on the selected Time range, Group by options, and Granularity (daily or monthly).

Line chart
Stacked chart
Grouped chart

You can utilize the filtering options, visualization, and export capabilities for in-depth analysis.

Data Transfer

The Data Transfer tab in the Usage Explorer serves as your primary access point to view comprehensive information about the data transfer through a variety of charts using various filtering options.

Data Storage

The Data Storage tab in the Usage Explorer displays comprehensive information about the data storage through a variety of charts using various filtering options.

The Data Storage will show the High-Water Mark (the highest level of storage reached) indication for your subscription or JPD based on the data range selected and granularity chosen.

In addition to the Date Range, Group By, and Aggregation filtering options, the Data Storage section includes an additional filtering option known as the Storage View.

The Storage View dropdown list has the following two options:

Peak Storage: Displays the highest storage usage during the selected time period, without considering any changes made, like deletions.
Storage Overtime: Displays the peak storage usage at the end of each day during the selected time period. This reflects changes including deletions, additions, or optimizations.

Consumption

The Consumption tab in the Usage Explorer displays comprehensive information about the data consumption through a variety of charts using various filtering options. Consumption is the sum of the peak storage and the total amount of data transferred during the calendar month

The Consumption will show the High-Water Mark (the highest level of consumption reached) for your subscription only on a monthly view as this is the indication of your consumption billed for a calendar month.

Projects

The Projects tab in the Usage Explorer displays comprehensive information about the projects through a variety of charts using various filtering options.

You can filter the data in two ways. First, you can filter based on the JPD level to view specific JPDs. Alternatively, you can filter at the Subscriptions level to see all JPDs.

Advanced Security

The Advanced Security tab displays the total number of scans performed by JFrog Advanced Security. The scans are displayed based on the subscriptions level or JPD or repository. This is available for Enterprise X and Enterprise+ subscriptions that includes JAS (JFrog Advanced Security).

Curation

The Curation tab displays data about the number of curated packages. The number of curated packages are displayed based on the subscriptions level or verdict (approved or blocked packages) or package Type. This is available for Enterprise X and Enterprise+ subscriptions that includes Curation.

Filtering

You can utilize the following filtering options for analysis:

Date range
Group by
Aggregation

For advanced filtering, use the Filters button located in the upper-right corner of these tabs. Clicking the Filters button will display the options in the Group by dropdown list relevant to that tab. Additionally, you can filter and drill down for specific data using the pie charts available at the bottom of the tab.

To clear the filtering criteria selected, click Clear All.

Date range

You can filter the information by selecting dates from the Date range dropdown list. By default, it shows the data usage of the last 30 days with a daily granularity and the Group by dropdown list set to None.

📘
Note
To access information, in MyJFrog regarding data generated by the various products included in your subscriptions—such as data transfer, storage, consumption, scan reports, curated packages, and more—the maximum allowable date range is 18 months prior to the current date.

The Date range dropdown list has the following options for all the tabs except the Consumption tab:

Last 14 days
Last 30 days
Last 3 months
Last 6 months
Custom Range

📘
Note
In the Consumption tab, the Data range dropdown list has the following options:

Month to date

Last month

Last 3 months

Last 6 months

Last 12 months

Custom range

Group by

You can filter the information by selecting any of the following options from the Group by dropdown list. Using this you can easily drill down the data to uncover specific insights.

📘
Note
Selecting the None option in the dropdown list for filtering displays data of the overall Subscription level.

The following table displays the various options in the Group by dropdown list for all the tabs:

Data Transfer	Data Storage	Consumption	Projects	Advanced Security	Curation
None Project Service User JPD Action Repository Repository Type Package Type	None JPD	The Group by dropdown is not available. Data consumption is displayed based on the Subscription level.	None JPD	None JPD Repository	None Verdict Package Type

Aggregation

You can filter the information by selecting any of the following options from the Aggregation dropdown list.

Daily: When the Aggregation dropdown list is set to Daily, you can select a date range with a maximum interval of up to 3 months.
Monthly: When the Aggregation dropdown list is set to Monthly, you can select a date range with a maximum interval of up to 12 months.

Reporting

In the upper-right corner of these tabs, click the Export CSV button to export a report in CSV format. This opens the Export CSV Report dialog.

📘
Note

The reporting capability using the Export CSV option is available only in the Data Transfer tab.

The Usage Explorer report is designed to include up to 2,000 records per selected granularity (day or month). For more information, see Report Details and Best Practices for Export.

The following is an example of exporting a report from the Data Transfer tab.

In the Export CSV Report dialog, the date range and granularity are set automatically based on the options selected in the Date range and Granularity dropdown lists.
Use the radio buttons, to select the options that are needed for your report. Note that, these radio buttons are same as the options available in the Group by dropdown list for the Data Transfer tab.

📘
Note

The following options are available: JPD, Repository type, Repository, Package Type, Action, Service, User, Project, IP, and Artifact Path. Note that, IP and Artifact Path are additional options along with the options in the Group by dropdown list.

When the Project or Repository option is selected in the Group by dropdown list, and if you export a CSV now, the JPD radio button will be already selected, as it is associated with the specific JPD.

Data about IP and Artifact path in the reports can be exported only for a limited period of 31 days.

Click Export to export a CSV report with the selected options.

Report Details and Best Practices for Export

Here are some of the reporting capabilities and best practices to export reports:

Top Records Included in the Report

The report shows the top 2,000 records based on your selected grouping criteria (for example, Project, Repo, User, etc.).
Any additional usage beyond the 2,000 records will be aggregated and displayed under a category called Other.

Understanding Other Records

Other category ensures that no usage data is lost, but detailed insights for those additional resources are not displayed within the report itself.

Recommendations for Accurate Filtering

To minimize the amount of data grouped into Other while generating report for Artifact Path or IP address and get more precise insights, apply filters to narrow down the report to relevant resources such as specific Projects.

Enable Detailed Data Transfer Logs in MyJFrog

📘
Subscription Information
This feature is supported on the Cloud (SaaS) platform for all licenses.

📘
Note
Detailed Data Transfer Logs are not available for Artifactory JCR subscriptions.

Enable Logs in MyJFrog

To enable detailed data transfer logs through MyJFrog Portal:

Go to Settings > Data Transfer Logs to display the logs dialog.
Select the Enable Logs checkbox to enable the logs.

📘
Important
Enabling detailed data transfer logs may incur additional costs, as it adds to your standard storage. If you have multiple JPDs operating under the same topology, the logs from each of these JPDs will be uploaded to main JPD where they will be stored in the jfrog-billing-logs repository in Artifactory.

View Data Transfer Logs

Once you enable detailed data transfer logs, they appear after a few hours in a dedicated repository in Artifactory called jfrog-billing-logs. The logs are uploaded every hour, and every upload may contain multiple files. The logs appear in JSON Lines format where event entries are separated by line breaks.

Each edge JPD gets its own data transfer logs.

To view the detailed logs in the JFrog Platform UI.

On the JFrog Platform UI, go to Application > Artifactory > Artifacts > jfrog-billing-logs.
Open the file logs. Every time a data transfer event occurs, any available metadata about the event will be logged on logs, including the following parameters:

Parameter	Description
`billing_timestamp`	The `billing_timestamp` is the event time rounded down to the hour, aligning with the billing cycle. Events logged after the cutoff period are timestamped for the next cycle, shown as `YYYY-MM-01 00:00:00.0`.
`event_timestamp`	The `event_timestamp` is the timestamp of the event in UTC format.
`server_name`	The server name. If your JFrog URL is `myserver.jfrog.io`, the `server_name` is `myserver`.
`service`	The JFrog service name: Artifactory or Xray.
`action`	The action performed on the artifact: upload or download.
`ip`	The IP address of the user who performed the action.
`repository`	The repository key.
`project`	The project name.
`artifact_path`	The path to the artifact that was uploaded or downloaded.
`user_name`	The username of the user who performed the action.
`package_type`	The package type.
`repo_type`	The repository key.
`consumption_unit`	The unit of measurement: currently only supports bytes.
`quantity`	The number of consumption units used.

See below an example for a data transfer log .JSON file output.

{"billing_timestamp": "2022-06-01 00:00:00.0","event_timestamp": "2022-05-31 23:50:00.0", "server_name": "serverName", "service": "artifactory","action": "download","project": "projectName", "user_name": "userName", "ip": "11.111.11.111","repository": "repositoryName","artifact_path": "artifactPath","consumption_unit": "bytes", "quantity": 1}
{"billing_timestamp": "2022-05-30 10:00:00.0", "server_name": "serverName", "service": "artifactory","action": "download","project": "projectName", "user_name": "userName", "ip": "11.111.11.111","repository": "repositoryName","artifact_path": "artifactPath","package_type":"packageType","repo_type":"repositoryType","consumption_unit": "bytes", "quantity": 1}

Connect Your Logs to Third-Party Analytics Tools

To analyze your data transfer logs, you can fetch the logs using the Retrieve Artifact API endpoint.

📘
Note
We recommend using your analytics tool to digest and parse the data transfer logs.

Detailed Data Transfer Logs Associated Costs

See the following list of data transfer logs phases and the costs associated with each phase.

Upload: no associated cost, you will not be charged for uploading data transfer logs.
Storage: usual storage costs apply, same as storing any other binary.
Download (optional): usual data transfer costs apply, same as downloading any other binary.