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

このページでは、DICOM ストア、DICOM スタディ、DICOM シリーズの指標を表示する方法について説明します。これらのモニタリング指標を使用すると、次のことができます。

現在の使用量に基づいて将来の費用を見積もる。
DICOM ストアがどのように成長し、時間の経過とともに変化しているのかを追跡する。
DICOM インスタンスの数は、インポートした数と一致していることを確認します。

データの保存や削除など、DICOM データの変更は非同期です。データを変更してから、DICOM ストアの指標に変更が反映されるまでに時間がかかることがあります。

ストレージタイプ

次のデータストレージクラスのサイズ（バイト単位）を示す指標がいくつかあります。

blob ストレージ: 非構造化 DICOM データと blob バイトを使用するDICOM データ。
構造化ストレージ: 検索可能なメタデータなど、blob 以外のストレージデータ。

DICOM ストアの指標を表示する

次のサンプルは、DICOM ストアの指標を表示する方法を示しています。

Console

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 スタディの指標を表示する方法を示しています。

Console

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 シリーズの指標を表示する方法を示しています。

Console

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 ストアの指標を表示する

Console

REST

curl

PowerShell

API Explorer

レスポンス

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

Console

REST

curl

PowerShell

API Explorer

レスポンス

DICOM シリーズの指標の表示

Console

REST

curl

PowerShell

API Explorer

レスポンス

ストレージタイプ