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

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

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

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

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

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

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

コンソール

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