Visualizzare le metriche del datastore FHIR

Questa pagina spiega come visualizzare le seguenti metriche relative a un archivio FHIR:

• I tipi di risorse FHIR nell'archivio FHIR
• Il numero di ciascun tipo di risorsa
• Le dimensioni dei dati nell'archivio FHIR

Puoi utilizzare le metriche per:

• Stima i costi futuri in base all'utilizzo attuale.
• Monitora la crescita e l'evoluzione del datastore FHIR nel tempo.
• Assicurati che il numero di risorse FHIR in un archivio FHIR corrisponda al numero importato, creato utilizzando un bundle o anonimizzato.

Quando aggiungi o modifichi le risorse FHIR, queste vengono aggiunte all'archivio FHIR in modo asincrono. Potrebbe esserci un ritardo tra il momento in cui apporti una modifica e quello in cui viene visualizzata nelle metriche.

Gli esempi riportati di seguito mostrano come visualizzare le metriche relative a un archivio FHIR.

Console

1. Nella console Google Cloud, vai alla pagina Set di dati.

   Vai a Set di dati

2. Seleziona il set di dati contenente l'archivio FHIR di cui vuoi visualizzare le metriche. Viene visualizzata la pagina Datastore.

3. Nell'elenco Datastore, seleziona l'archivio FHIR di cui vuoi visualizzare le metriche. Viene visualizzata la pagina Dettagli del data store.

4. Fai clic sulla scheda Metriche. La scheda mostra le seguenti metriche:

   • Numero totale di tipi di risorse
   • Numero totale di risorse
   • Dimensione totale di tutte le risorse

5. Visualizza e filtra le metriche nella tabella Metriche. Dopo aver filtrato le metriche, seleziona un tipo di risorsa FHIR per visualizzare le informazioni su tutte le risorse di quel tipo nel visualizzatore FHIR.

gcloud

Esegui il comando gcloud healthcare fhir-stores metrics.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

• PROJECT_ID: l'ID del tuo Google Cloud progetto
• LOCATION: la posizione del set di dati
• DATASET_ID: il set di dati principale dell'archivio FHIR
• FHIR_STORE_ID: l'ID dell'archivio FHIR

Esegui il seguente comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto, eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud healthcare fhir-stores metrics FHIR_STORE_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --dataset=DATASET_ID

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto, eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud healthcare fhir-stores metrics FHIR_STORE_ID `
  --project=PROJECT_ID `
  --location=LOCATION `
  --dataset=DATASET_ID

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto, eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud healthcare fhir-stores metrics FHIR_STORE_ID ^
  --project=PROJECT_ID ^
  --location=LOCATION ^
  --dataset=DATASET_ID

Dovresti ricevere una risposta simile alla seguente:

Risposta

metrics:
- count: 'FHIR_RESOURCE_TYPE_COUNT'
  resourceType: FHIR_RESOURCE_TYPE
  structuredStorageSizeBytes: 'FHIR_RESOURCE_TYPE_SIZE'
...
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

REST

Utilizza il metodo fhirStores.getFHIRStoreMetrics.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID del tuo Google Cloud progetto
• LOCATION: la posizione del set di dati
• DATASET_ID: il set di dati principale dell'archivio FHIR
• FHIR_STORE_ID: l'ID dell'archivio FHIR

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID:getFHIRStoreMetrics"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$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/fhirStores/FHIR_STORE_ID:getFHIRStoreMetrics" | Select-Object -Expand Content

Explorer API

Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Esplora API. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID",
  "metrics": [
    {
      "resourceType": "FHIR_RESOURCE_TYPE",
      "count": "FHIR_RESOURCE_TYPE_COUNT",
      "structuredStorageSizeBytes": "FHIR_RESOURCE_TYPE_SIZE"
    },
    ...
  ]
}