This page describes how to view DICOM store, DICOM study, and DICOM series metrics. You can use these metrics to do the following:
- Estimate future costs based on current usage.
- Track how a DICOM store grows and changes over time.
- Ensure that the number of DICOM instances matches the number that you imported.
Modifications to DICOM data, such as storing or deleting the data, are asynchronous. There might be a delay between when you modify the data and when the modifications are shown in the DICOM store metrics.
Storage types
Several metrics show the size, in bytes, of the following data storage classes:
- Blob storage
- Unstructured DICOM data and DICOM data that uses blob bytes.
- Structured storage
- Non-blob storage data, such as searchable metadata.
View DICOM store metrics
The following samples show how to view DICOM store metrics.
Console
In the Google Cloud console, go to the Datasets page.
Select the dataset containing the DICOM store whose metrics you want to view.
In the Data stores list, select the DICOM store whose metrics you want to view. The Datastore details page is displayed.
Click the Metrics tab.
The tab shows the following metrics on a scorecard:
- Total number of studies
- Total number of series
- Total number of instances
- Structured storage size of all instances
- Blob storage size of all instances
- Total size of all instances
The metrics table contains the following columns:
Column Description ID
The study IDs and the series IDs. Expand a study entry to view the series within the study. Number of series
The number of series within a study. Number of instances
The number of instances within a study or within a series. Structured size
The size of the structured data in the study or the series. Blob size
The size of the blob data in the study or the series. To filter the table data, enter the study ID in the Filter field.
REST
Use the dicomStores.getDICOMStoreMetrics
method.
Before using any of the request data, make the following replacements:
PROJECT_ID
: the ID of your Google Cloud projectLOCATION
: the dataset locationDATASET_ID
: the DICOM store's parent datasetDICOM_STORE_ID
: the DICOM store ID
To send your request, choose one of these options:
curl
Execute the following command:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:getDICOMStoreMetrics"
PowerShell
Execute the following command:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:getDICOMStoreMetrics" | Select-Object -Expand Content
APIs Explorer
Open the method reference page. The APIs Explorer panel opens on the right side of the page. You can interact with this tool to send requests. Complete any required fields and click Execute.
You should receive a JSON response similar to the following:
View DICOM studies metrics
The following samples show how to view DICOM studies metrics.
Console
To view DICOM study metrics in the Google Cloud console, see View DICOM store metrics.
REST
Use the dicomStores.studies.getStudyMetrics
method.
Before using any of the request data, make the following replacements:
PROJECT_ID
: the ID of your Google Cloud projectLOCATION
: the dataset locationDATASET_ID
: the DICOM store's parent datasetDICOM_STORE_ID
: the DICOM store IDSTUDY_UID
: the DICOMweb study unique identifier (UID)
To send your request, choose one of these options:
curl
Execute the following command:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID:getStudyMetrics"
PowerShell
Execute the following command:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID:getStudyMetrics" | Select-Object -Expand Content
APIs Explorer
Open the method reference page. The APIs Explorer panel opens on the right side of the page. You can interact with this tool to send requests. Complete any required fields and click Execute.
You should receive a JSON response similar to the following:
View DICOM series metrics
The following samples show how to view DICOM series metrics.
Console
To view DICOM series metrics in the Google Cloud console, see View DICOM store metrics.
REST
Use the dicomStores.dicomWeb.studies.series.getSeriesMetrics
method.
Before using any of the request data, make the following replacements:
PROJECT_ID
: the ID of your Google Cloud projectLOCATION
: the dataset locationDATASET_ID
: the DICOM store's parent datasetDICOM_STORE_ID
: the DICOM store IDSTUDY_UID
: the DICOMweb study unique identifier (UID)SERIES_UID
: the DICOMweb series unique identifier (UID)
To send your request, choose one of these options:
curl
Execute the following command:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID:getSeriesMetrics"
PowerShell
Execute the following command:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID:getSeriesMetrics" | Select-Object -Expand Content
APIs Explorer
Open the method reference page. The APIs Explorer panel opens on the right side of the page. You can interact with this tool to send requests. Complete any required fields and click Execute.
You should receive a JSON response similar to the following: