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

このページでは、次の HL7v2 ストアの指標を表示する方法について説明します。

特定の HL7v2 メッセージタイプ（ADT や ORU など）の HL7v2 メッセージの数。
特定の HL7v2 メッセージタイプのすべての HL7v2 メッセージの構造化ストレージサイズ（バイト単位）。

これらのモニタリング指標を使用すると、次のことができます。

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

HL7v2 データの変更（データの保存、削除、編集など）は非同期です。データを変更してから、HL7v2 ストアの指標に変更が反映されるまでに遅延が生じる場合があります。

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

Console

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

[データセット] に移動
指標を表示する HL7v2 ストアを含むデータセットを選択します。
[データストア] リストで、指標を表示する HL7v2 ストアを選択します。[Datastore の詳細] ページが表示されます。

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

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

メッセージタイプの合計数
メッセージの合計数
メッセージの合計サイズ

指標の表には次の列があります。

列	説明
`Message type`	メッセージタイプ（`ADT`、`ORM`、`ACK` など）。
`Number of messages`	特定のメッセージタイプのメッセージ数。
`Total size`	特定のメッセージタイプのすべてのメッセージの合計サイズ。

表データをフィルタするには、[フィルタ] フィールドにフィルタ条件を入力します。

メッセージタイプ、メッセージ数、メッセージタイプの合計サイズでフィルタできます。たとえば、[合計サイズ] 列をフィルタリングするには、フィルタ条件を選択して演算子を選択し、テーブルに表示されるサイズの単位を使用してフィルター値を入力します。合計サイズに応じてフィルタする有効なフィルタ条件には、Total size:> 2 MiB と Total size:>= 2 GiB があります。

REST

hl7V2Stores.getHL7v2StoreMetrics メソッドを使用します。

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

PROJECT_ID: Google Cloud プロジェクトの ID
LOCATION: データセットの場所
DATASET_ID: HL7v2 ストアの親データセット
HL7V2_STORE_ID: HL7v2 ストア 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/hl7V2Stores/HL7V2_STORE_ID:getHL7v2StoreMetrics"

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/hl7V2Stores/HL7V2_STORE_ID:getHL7v2StoreMetrics" | Select-Object -Expand Content

API Explorer

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

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

レスポンス

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID",
  "metrics": [
    {
      "messageType": "MESSAGE_TYPE",
      "count": "COUNT",
      "structuredStorageSizeBytes": "STRUCTURED_STORAGE_BYTES"
    }
  ]
}