InfrastructureアラートのREST API呼び出し

一貫性

• InfrastructureモニタリングUIで同じ条件を毎回設定せずに、すべてのクラスタに同じ一連の条件を定義します。
• 複数の条件をUIで個別に更新することなく、迅速に管理します。

柔軟性

• 任意のホストグループに対して条件を作成できます。
• オフラインになったホストに対する条件をいつでも無効化、あるいは削除できます。
• 排他的なフィルタリング（たとえば、environment NOT LIKE x）を使用して条件を作成します。詳細については、排他的なフィルタリングに関するこの記事を参照してください。
• AWS Cloud Integrationsについては、まだAWSから送信されていない属性を選択する。
• where_clauseを使用してセカンダリまたはターシャリメトリックに制限を指定することによって、複合アラート条件を作成します。
• NRQLアラート条件の500ファセット制限を上回る。

信頼性

• 最後に条件が更新されたタイミングで監査できます。

comparison （列挙体）

条件タイプ： infra_metric、 infra_process_running

閾値の定義に使用する値（例："["above", "below", "equal"]）。

critical_threshold および warning_threshold

条件タイプ：all

このオブジェクトは、違反をオープンする前に閾値を識別します。

• critical_thresholdは必須です。

• warning_thresholdはオプションで、infra_metric条件でのみ使用できます。

  このオブジェクトのキーは、条件タイプによって異なります。

  条件タイプ： infra_metricフォーマット：

  "critical_threshold":{
     "value":<number>,
     "duration_minutes":<integer>,
     "time_function":"any" or "all"
  },

  コピー

  条件タイプ： infra_process_runningフォーマット：

  "critical_threshold":{
     "value":<integer>,
     "duration_minutes":<integer>,
  },

  コピー

  条件タイプ： infra_host_not_reportingフォーマット：

  "critical_threshold":{
     "duration_minutes":<integer>,
  },

  コピー

  value

  条件が違反をオープンするには、この数値を超過する必要があります

  duration_minutes

  条件が違反をオープンするためにvalueが費やす、または到達する必要がある分数

  time_function

  違反を作成するために条件が特定の期間中保持される必要がある、または特定の期間中に閾値を一度超過する必要があるだけかを示します。for at least x minutes閾値を設定する場合は、allを使用します。at least once in x minutes閾値の場合は、anyを使用します。

enabled （ブール値）

条件タイプ：all

条件のオンまたはオフ（trueまたはfalse）の状態を示します。

event_type [string])

条件タイプ： infra_metric

メトリックのイベント（例：システムメトリクス、プロセスメトリクス、ストレージメトリクス、ネットワークメトリクス）。Infrastructureインテグレーションにデータを自動入力します（例：StorageSampleまたはSystemSample）。

filter [string])

条件タイプ：all

条件がUIで作成された場合は、where_clauseの代わりにfilterが表示されます。たとえば：

{and: [{is: {ec2InstanceType: "m3.medium"}}]}

推奨：新しい条件を作成する際は、where_clauseを使用してください。

id （整数）

条件タイプ：all

URL内の条件ID。

• GET：この値はGETレスポンスに出力されます。
• PUT：この値をDATAセクションに含めてください。
• POST：これはDATAセクションに含めないようにしてください。
• この値は、-X DELETEコールに含めてください。

integration_provider [string])

条件タイプ： infra_metric

インテグレーションに関するアラートについては、event_typeの代わりにintegration_providerを使用します。有効な値を参照するには：ご利用のクラウドサービスのNew Relicドキュメンテーションから、データを見つけて使用するセクションを確認してください。

例：AWS RDS監視インテグレーションのドキュメンテーションからは、DatastoreSampleイベントタイプをintegration_provider値と共に使用できることが分かります。この場合、DBインスタンスではRdsDbInstance、またAurora DBクラスタではRdsDbClusterとなります。

name [string])

条件タイプ：all

Infrastructureのアラート条件の名前。たとえば：

"[test] process running"

policy_id （整数）

条件タイプ：all

条件に関連するアラートポリシーのアカウントIDに対するユニークID（例：1234567890）。これはポリシーのグローバルIDではありません。

process_where_clause [string])

条件タイプ： infra_process_running

プロセスに適用したすべてのフィルタ、特にアラート条件を実行中のプロセス。このパラメーターは、こうした種類のアラート条件において必須です。例：

"commandName = '\''java'\''"

runbook_url [string])

条件タイプ： all

通知に表示されるランブック URL。

select_value [string])

条件タイプ： infra_metric

ターゲットとするメトリックを識別する属性名（例："cpuPercent"、"diskFreePercent"、"memoryResidentSizeBytes", or "memoryFreeBytes/memoryTotalBytes*100"）。Infrastructureインテグレーションにデータを自動入力します（例：diskFreePercent）。

type （列挙体）

条件タイプ：all

Infrastructureアラート条件のタイプ："infra_process_running"、"infra_metric"または"infra_host_not_reporting"。

violation_close_timer （整数）

条件タイプ：all

時間で表された、違反時間制限設定。可能な値は0、1、2、4、8、12、24、48、72。これにより、違反が自動的に終了する前にどのくらいの時間が経過するかが決まります。

新たな条件については、値が示されていない場合、次のデフォルト値を使用します：

• すべての条件： 24 hours

  既存の条件を更新する際、値が示されていない場合、既存の値を上書きしますが、すでに開かれている違反には影響はありません。

where_clause [string])

条件タイプ：all

該当する場合、使用されているすべてのInfrastructureホストフィルターを識別します。たとえば：

"(`hostname` LIKE '\''%cassandra%'\'')",