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

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

  • 現在の使用量に基づいて将来の費用を見積もる。
  • DICOM ストアの変化や経時的な変化を追跡します。
  • DICOM インスタンスの数がインポートした数と一致していることを確認します。

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

ストレージ タイプ

いくつかの指標は、次のデータ ストレージ クラスのサイズ(バイト単位)を示します。

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

DICOM ストア指標を表示する

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

コンソール

  1. Google Cloud コンソールで、[データセット] ページに移動します。

    [データセット] に移動

  2. 指標を表示する FHIR ストアを含むデータセットを選択します。

  3. [データストア] リストで、指標を表示する DICOM ストアを選択します。[Datastore の詳細] ページが表示されます。

  4. [指標] タブをクリックします。

    このタブには、スコアカードに次の指標が表示されます。

    • スタディの合計数
    • シリーズの合計数
    • インスタンスの合計数
    • すべてのインスタンスの構造化ストレージ サイズ
    • すべてのインスタンスの blob ストレージ サイズ
    • すべてのインスタンスの合計サイズ

    指標テーブルには次の列があります。

    説明
    ID スタディ ID とシリーズ ID。スタディのエントリを展開してスタディ内のシリーズを表示します。
    Number of series スタディ内のシリーズの数。
    Number of instances スタディ内またはシリーズ内のインスタンスの数。
    Structured size スタディまたはシリーズ内の構造化データのサイズ。
    Blob size スタディまたはシリーズ内の blob データのサイズ。
  5. テーブルデータをフィルタリングするには、[フィルタ] フィールドにスタディ ID を入力します。

REST

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

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

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

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

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:getDICOMStoreMetrics"

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:getDICOMStoreMetrics" | Select-Object -Expand Content

API Explorer

メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。

次のような JSON レスポンスが返されます。

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

メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。

次のような JSON レスポンスが返されます。

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

メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。

次のような JSON レスポンスが返されます。