Afficher les métriques du magasin DICOM, de l'étude DICOM et de la série DICOM

Cette page explique comment afficher les métriques du magasin DICOM, de l'étude DICOM et de la série DICOM. Grâce à ces métriques, vous pouvez:

• Évaluez les coûts futurs en fonction de l'utilisation actuelle.
• Suivez l'évolution d'un magasin DICOM au fil du temps.
• Assurez-vous que le nombre d'instances DICOM correspond à celui que vous avez importé.

Les modifications apportées aux données DICOM, telles que le stockage ou la suppression des données, sont asynchrones. Il peut s'écouler un certain temps entre la modification des données et l'affichage des modifications dans les métriques du magasin DICOM.

Types de stockage

Plusieurs métriques indiquent la taille, en octets, des classes de stockage de données suivantes:

Stockage de blobs

Données DICOM non structurées et données DICOM qui utilisent des octets de blob.

Stockage structuré

Données de stockage autres que des blobs, telles que des métadonnées indexables.

Afficher les métriques du magasin DICOM

Les exemples suivants montrent comment afficher les métriques du datastore DICOM.

Console

1. Dans la console Google Cloud, accédez à la page Ensembles de données.

   Accéder à la page "Ensembles de données"

2. Sélectionnez l'ensemble de données contenant le magasin DICOM dont vous souhaitez afficher les métriques.

3. Dans la liste Datastores (Datastores), sélectionnez le magasin DICOM dont vous souhaitez afficher les métriques. La page Détails du datastore s'affiche.

4. Cliquez sur l'onglet Métriques.

   L'onglet affiche les métriques suivantes dans un tableau de données:

   • Nombre total d'études
   • Nombre total de séries
   • Nombre total d'instances
   • Taille de l'espace de stockage structuré de toutes les instances
   • Taille de stockage des blobs de toutes les instances
   • Taille totale de toutes les instances

   Le tableau des métriques contient les colonnes suivantes:

   Colonne	Description
   ID	Les ID d'étude et les ID de série. Développez une entrée d'étude pour afficher les séries de l'étude.
   Number of series	Nombre de séries dans une étude.
   Number of instances	Nombre d'instances dans une étude ou une série.
   Structured size	Taille des données structurées de l'étude ou de la série.
   Blob size	Taille des données blob dans l'étude ou la série.

5. Pour filtrer les données de la table, saisissez l'ID de l'étude dans le champ Filtre.

REST

Utilisez la méthode dicomStores.getDICOMStoreMetrics.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud
• LOCATION : emplacement de l'ensemble de données
• DATASET_ID : ensemble de données parent du magasin DICOM
• DICOM_STORE_ID : ID du store DICOM

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

Vous devriez recevoir une réponse JSON de ce type :

Réponse

{
  "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",
}

Afficher les métriques des études DICOM

Les exemples suivants montrent comment afficher les métriques des études DICOM.

Console

Pour afficher les métriques des études DICOM dans la console Google Cloud, consultez la section Afficher les métriques des magasins DICOM.

REST

Utilisez la méthode dicomStores.studies.getStudyMetrics.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud
• LOCATION : emplacement de l'ensemble de données
• DATASET_ID : ensemble de données parent du magasin DICOM
• DICOM_STORE_ID : ID du magasin DICOM
• STUDY_UID: identifiant unique (UID) de l'étude DICOMweb

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

Vous devriez recevoir une réponse JSON de ce type :

Réponse

{
  "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"
}

Afficher les métriques des séries DICOM

Les exemples suivants montrent comment afficher les métriques des séries DICOM.

Console

Pour afficher les métriques des séries DICOM dans la console Google Cloud, consultez la section Afficher les métriques des magasins DICOM.

REST

Utilisez la méthode dicomStores.dicomWeb.studies.series.getSeriesMetrics.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud
• LOCATION : emplacement de l'ensemble de données
• DATASET_ID : ensemble de données parent du magasin DICOM
• DICOM_STORE_ID : ID du magasin DICOM
• STUDY_UID: identifiant unique (UID) de l'étude DICOMweb
• SERIES_UID: identifiant unique (UID) de la série DICOMweb

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.

Vous devriez recevoir une réponse JSON de ce type :

Réponse

{
  "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"
}