DICOM ストア、DICOM スタディ、DICOM シリーズの指標を表示する

このページでは、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 を入力します。

REST

dicomStores.getDICOMStoreMetrics メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: Google Cloud プロジェクトの ID
LOCATION: データセットの場所
DATASET_ID: DICOM ストアの親データセット
DICOM_STORE_ID: DICOM ストアの ID

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

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

注:次のコマンドは、gcloud init、または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

$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

メソッドリファレンスページを開きます。ページの右側に [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 ストア指標を表示するをご覧ください。

REST

dicomStores.studies.getStudyMetrics メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: Google Cloud プロジェクトの ID
LOCATION: データセットの場所
DATASET_ID: DICOM ストアの親データセット
DICOM_STORE_ID: DICOM ストアの ID
STUDY_UID: DICOMweb スタディの一意の識別子（UID）

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

次のコマンドを実行します。

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

次のコマンドを実行します。

$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

次のような 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 ストアの指標を表示するをご覧ください。

REST

dicomStores.dicomWeb.studies.series.getSeriesMetrics メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: Google Cloud プロジェクトの ID
LOCATION: データセットの場所
DATASET_ID: DICOM ストアの親データセット
DICOM_STORE_ID: DICOM ストアの ID
STUDY_UID: DICOMweb スタディの一意の識別子（UID）
SERIES_UID: DICOMweb シリーズの一意の識別子（UID）

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

次のコマンドを実行します。

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

次のコマンドを実行します。

$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

次のような 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"
}

DICOM ストア、DICOM スタディ、DICOM シリーズの指標を表示する

ストレージ タイプ

DICOM ストア指標を表示する

コンソール

REST

curl

PowerShell

API Explorer

レスポンス

DICOM のスタディの指標を表示する

コンソール

REST

curl

PowerShell

API Explorer

レスポンス

DICOM シリーズの指標の表示

コンソール

REST

curl

PowerShell

API Explorer

レスポンス

ストレージタイプ