翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

プライベートワークフローのメトリクスを実行する

HealthOmics は、実行とタスクのほぼリアルタイムのリソース使用率メトリクスを Amazon CloudWatch に発行します。これらのメトリクスにより、実行中の実行の進行状況を可視化できます。これらのメトリクスは、次の目的で使用できます。

実行メトリクスは、プライベートワークフローと共有ワークフローで使用できます。

HealthOmics は、独自の CloudWatch アカウントcloudwatch.aws/omicsの範囲内でこれらのメトリクスを提供します。

これらのメトリクスは、CloudWatch OpenTelemetry (OTel) 互換メトリクス標準を使用して出力されます。つまり、OTel 互換のオブザーバビリティツールとネイティブの CloudWatch ダッシュボードやアラームと統合できます。Prometheus Query Language (PromQL) を使用して OTel メトリクスをクエリして、データを表示および分析します。詳細については、CloudWatch OpenTelemetry メトリクス」を参照してください。

実行のメトリクスの有効化

これらのメトリクスを公開するには、実行に使用する AWS Identity and Access Management (IAM) ロールに CloudWatch にメトリクスを書き込むアクセス許可が必要です。ワークフロー実行ロールに次のアクセス許可を追加します。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "cloudwatch:PutMetricData",
      "Resource": "*"
    }
  ]
}

権限の詳細については、「のサービスロール AWS HealthOmics」を参照してください。実行の開始の詳細については、「」を参照してくださいHealthOmics で実行を開始する。

使用可能なメトリクス

次の表に、HealthOmics が実行ごとに提供するメトリクスを示します。メトリクスは CloudWatch Query Studio で使用できます。単位は OpenTelemetry の規則に従います。 Byはバイト、 {cpu} は vCPUs {operation} はオペレーション、 % はパーセンテージです。

アクセラレーターの詳細については、「」を参照してくださいHealthOmics ワークフロー定義のタスクリソース。

エフェメラルストレージの詳細については、「」を参照してくださいHealthOmics ワークフロータスク用のエフェメラルストレージ。

共通の 属性

すべての HealthOmics 実行メトリクスには、データポイントのソースを識別する共通のリソースラベルのセットが格納されます。

その他の属性

一部の実行メトリクスには、メトリクスを別々の時系列に分割する追加のデータポイント属性があります。これらの属性を使用して、PromQL クエリをフィルタリングできます。

HealthOmics 実行メトリクスのクエリ

Query Studio で PromQL クエリを実行すると、CloudWatch コンソールで HealthOmics 実行メトリクスを表示できます。

たとえば、次のクエリは、実行の各タスクで使用されている vCPUsを返します。runID を、検査する実行の ID に置き換えます。

{"aws.omics.task.cpu.usage", "@resource.aws.omics.run.id"="runID"}

各時系列に実行 ID とタスク ID でラベルを付けるには、カスタムラベルを選択して次のように入力します。

{@resource.aws.omics.run.id="${@resource.aws.omics.run.id}",@resource.aws.omics.task.id="${@resource.aws.omics.task.id}"}

HealthOmics 実行メトリクスをクエリするには (API)

CloudWatch は、メトリクスデータをクエリするための Prometheus 互換 APIs とエンドポイントを提供します。これらの APIs「Prometheus 互換 APIs」を参照してください。

CloudWatch を使用したアラームの作成

PromQL クエリから CloudWatch アラームを作成して、メトリクスがしきい値を超えたときに CloudWatch が通知するようにできます。 PromQL アラームは、Amazon Simple Notification Service (Amazon SNS) トピックに通知を送信したり、アラームの状態が変わったときに別のアクションを開始したりできます。

HealthOmics 実行メトリクスを CloudWatch ダッシュボードに追加する

PromQL クエリを CloudWatch ダッシュボードにウィジェットとして追加して、他のメトリクスとともに HealthOmics リソース使用率をモニタリングできます。

HealthOmics MCP サーバーを使用した実行メトリクスの分析

HealthOmics Model Context Protocol (MCP) サーバーを使用すると、AI モデルを使用して実行メトリクスを取得し、データの複数のディメンションにわたる実行失敗を調査できます。MCP サーバーは、Kiro CLI、Claude Code、またはその他の MCP 互換エージェントクライアントから使用できます。詳細については、AWS HealthOmics 「MCP サーバーとサポートされているエージェントツール」を参照してください。

コールアウト

料金

AWS HealthOmics では、実行メトリクスの料金は発生しません。メトリクスはアカウントの Amazon CloudWatch に発行され、CloudWatch は関連するアクティビティについて直接請求します。料金は、取り込まれたメトリクスデータの量に基づきます。特定の AWS リージョンの料金については、Amazon CloudWatch の料金」を参照してください。次の表は、CloudWatch が実行メトリクスに対してどのように課金するかを示しています。

オプトアウト

デフォルトでは、HealthOmics は、実行のサービスロールに アクセスcloudwatch:PutMetricData許可があるたびに実行メトリクスを発行します。将来の料金をオプトアウトして停止するには、各実行レベルでサービスロールからこのアクセス許可を省略できます。別のポリシーがアクセス許可を付与した場合でも発行を停止するには、ロールに明示的な拒否を追加します。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": "cloudwatch:PutMetricData",
      "Resource": "*"
    }
  ]
}

オプトアウトするもう 1 つの方法は、 StartRun リクエストLogLevel = OFFで を設定して実行のログ記録をオフにすることです。LogLevel を に設定するとOFF、HealthOmics は実行メトリクスを発行しません。