このページでは、DICOM ストア、DICOM スタディ、DICOM シリーズの指標を表示する方法について説明します。これらのモニタリング指標を使用すると、次のことができます。
- 現在の使用量に基づいて将来の費用を見積もる。
- DICOM ストアがどのように成長し、時間の経過とともに変化しているのかを追跡する。
- DICOM インスタンスの数は、インポートした数と一致していることを確認します。
データの保存や削除など、DICOM データの変更は非同期です。データを変更してから、DICOM ストアの指標に変更が反映されるまでに時間がかかることがあります。
ストレージ タイプ
次のデータ ストレージ クラスのサイズ(バイト単位)を示す指標がいくつかあります。
- blob ストレージ
- 非構造化 DICOM データと blob バイトを使用するDICOM データ。
- 構造化ストレージ
- 検索可能なメタデータなど、blob 以外のストレージ データ。
DICOM ストアの指標を表示する
次のサンプルは、DICOM ストアの指標を表示する方法を示しています。
Google Cloud コンソールで、[データセット] ページに移動します。
指標を表示する FHIR ストアを含むデータセットを選択します。
[データストア] リストで、指標を表示する DICOM ストアを選択します。[Datastore の詳細] ページが表示されます。
[指標] タブをクリックします。
このタブでは、スコアカードに次の指標が表示されます。
- スタディの合計数
- シリーズの合計数
- インスタンスの合計数
- すべてのインスタンスの構造化ストレージ サイズ
- すべてのインスタンスの blob ストレージ サイズ
- すべてのインスタンスの合計サイズ
指標の表には次の列があります。
列 説明 ID
調査 ID とシリーズ ID。調査エントリを開くと、調査内のシリーズが表示されます。 Number of series
調査内のシリーズの数。 Number of instances
スタディ内またはシリーズ内のインスタンス数。 Structured size
スタディまたはシリーズ内の構造化データのサイズ。 Blob size
スタディまたはシリーズ内の blob データのサイズ。 テーブルデータをフィルタするには、[フィルタ] フィールドに調査 ID を入力します。
dicomStores.getDICOMStoreMetrics
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
: Google Cloud プロジェクトの IDPROJECT_ID
: データセットの場所LOCATION
: DICOM ストアの親データセットDATASET_ID
: DICOM ストアの IDDICOM_STORE_ID
リクエストを送信するには、次のいずれかのオプションを選択します。
次のコマンドを実行します。
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"
次のコマンドを実行します。
$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
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。
レスポンス
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID ", "studyCount": "STUDY_COUNT ", "seriesCount": "SERIES_COUNT ", "instanceCount": "INSTANCE_COUNT ", "structuredStorageSizeBytes": "STRUCTURED_STORAGE_BYTES ", "blobStorageSizeBytes": "BLOB_STORAGE_BYTES ", }
DICOM のスタディの指標を表示する
次のサンプルは、DICOM スタディの指標を表示する方法を示しています。
Google Cloud コンソールで DICOM スタディの指標を表示するには、DICOM ストアの指標を表示するをご覧ください。
dicomStores.studies.getStudyMetrics
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
: Google Cloud プロジェクトの IDPROJECT_ID
: データセットの場所LOCATION
: DICOM ストアの親データセットDATASET_ID
: DICOM ストアの IDDICOM_STORE_ID
: DICOMweb スタディの一意の識別子(UID)STUDY_UID
リクエストを送信するには、次のいずれかのオプションを選択します。
次のコマンドを実行します。
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"
次のコマンドを実行します。
$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
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。
レスポンス
{ "study": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID /dicomWeb/studies/STUDY_UID ", "seriesCount": "SERIES_COUNT ", "instanceCount": "INSTANCE_COUNT ", "structuredStorageSizeBytes": "STRUCTURED_STORAGE_BYTES ", "blobStorageSizeBytes": "BLOB_STORAGE_BYTES " }
DICOM シリーズの指標の表示
次のサンプルは、DICOM シリーズの指標を表示する方法を示しています。
Google Cloud コンソールで DICOM シリーズの指標を表示するには、DICOM ストアの指標を表示するをご覧ください。
dicomStores.dicomWeb.studies.series.getSeriesMetrics
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
: Google Cloud プロジェクトの IDPROJECT_ID
: データセットの場所LOCATION
: DICOM ストアの親データセットDATASET_ID
: DICOM ストアの IDDICOM_STORE_ID
: DICOMweb スタディの一意の識別子(UID)STUDY_UID
: DICOMweb シリーズの一意の識別子(UID)SERIES_UID
リクエストを送信するには、次のいずれかのオプションを選択します。
次のコマンドを実行します。
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"
次のコマンドを実行します。
$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
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。
レスポンス
{ "series": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID /dicomWeb/studies/STUDY_UID /series/SERIES_UID ", "structuredStorageSizeBytes": "STRUCTURED_STORAGE_BYTES ", "blobStorageSizeBytes": "BLOB_STORAGE_BYTES ", "instanceCount": "INSTANCE_COUNT " }