Visualizar métricas de armazenamento FHIR

Nesta página, explicamos como visualizar as seguintes métricas sobre um armazenamento FHIR:

• Os tipos de recursos FHIR no repositório FHIR
• O número de cada tipo de recurso
• O tamanho dos dados no repositório FHIR

Você pode usar as métricas para fazer o seguinte:

• Estimar custos futuros com base no uso atual.
• Acompanhe como o armazenamento FHIR está crescendo e mudando ao longo do tempo.
• Verifique se o número de recursos FHIR em um repositório de FHIR corresponde ao número que você importou, criou usando um pacote ou de-identified.

Quando você adiciona ou altera recursos FHIR, eles são adicionados ao armazenamento FHIR de forma assíncrona. Pode haver um atraso entre o momento em que você faz uma alteração e quando ela aparece nas métricas.

Os exemplos a seguir mostram como visualizar as métricas sobre um armazenamento de FHIR.

Console

1. No console do Google Cloud, acesse a página Conjuntos de dados.

   Acessar conjuntos de dados

2. Selecione o conjunto de dados que contém o repositório FHIR com as métricas que você quer visualizar. A página Repositórios de dados é exibida.

3. Na lista Repositórios de dados, selecione o repositório FHIR com as métricas que você quer visualizar. A página Detalhes do Datastore é exibida.

4. Clique na guia Métricas. A guia mostra as seguintes métricas:

   • Número total de tipos de recursos
   • Número total de recursos
   • Tamanho total de todos os recursos

5. Confira e filtre métricas na tabela Métricas. Depois de filtrar as métricas, selecione um tipo de recurso FHIR para exibir informações sobre todos os recursos desse tipo no visualizador FHIR.

gcloud

Execute o comando gcloud healthcare fhir-stores metrics.

Antes de usar os dados do comando abaixo, faça estas substituições:

• PROJECT_ID: o ID do seu projeto do Google Cloud;
• LOCATION: o local do conjunto de dados;
• DATASET_ID: o conjunto de dados pai do armazenamento de FHIR
• FHIR_STORE_ID: o ID de armazenamento de FHIR

Execute o comando a seguir:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou 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)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou 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)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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

Você receberá uma resposta semelhante a esta:

Resposta

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

Use o método fhirStores.getFHIRStoreMetrics.

Antes de usar os dados da solicitação, faça as substituições a seguir:

• PROJECT_ID: o ID do seu projeto do Google Cloud;
• LOCATION: o local do conjunto de dados;
• DATASET_ID: o conjunto de dados pai do armazenamento de FHIR
• FHIR_STORE_ID: o ID de armazenamento de FHIR

Para enviar a solicitação, escolha uma destas opções:

curl

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte 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

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte 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

APIs Explorer

Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.

Você receberá uma resposta JSON semelhante a esta:

Resposta

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