ベースラインNRQL条件の作成

アクション識別子はnewrelic.alerts.createBaselineNrqlConditionです。

アラートポリシーの下に新しいベースラインNRQLアラート条件を作成します。ベースライン条件は、過去の動作からシグナルの予想される範囲を動的に予測し、ライブシグナルが設定された閾値を超えてその予測されたベースラインから逸脱した場合に違反をオープンします。

termsまたはexpiration（openViolationOnExpiration: trueとともに）の少なくとも1つを指定する必要があります。両方を省略すると、NerdGraphの検証に失敗します。

次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。

入力	タイプ	説明	例
アカウントID	Int	必須。条件を作成するNew Relicアカウント。	`123456`
policyId	弦	必須。この条件を関連付けるアラートポリシーのID。	`"2000002"`
name	弦	必須。条件の名前。	`"Anomalous throughput"`
nrqlQuery	弦	必須。評価するNRQLクエリです。	`"SELECT count(*) FROM Transaction WHERE appName = 'MyApp'"`
有効	ブール値	必須。条件がアクティブかどうか。	`true`
baselineDirection	弦	必須。違反をトリガーする偏差の方向。 `UPPER_ONLY` 、 `LOWER_ONLY` 、または `UPPER_AND_LOWER` のいずれか。	`"UPPER_ONLY"`
用語	リスト	条件付きで必須です。ベースラインからのパーセント偏差として表される条件の閾値。 `expiration` が `openViolationOnExpiration: true` とともに指定されない限り、必須です。各エントリ： `priority` （ `CRITICAL` または `WARNING` ）、 `operator` （ `ABOVE` のみ — 方向は `baselineDirection` によって制御されます）、 `threshold` （フロート、パーセント偏差）、 `thresholdDuration` （秒）、 `thresholdOccurrences` （ `ALL` または `AT_LEAST_ONCE` ）。	`[{"priority": "CRITICAL", "operator": "ABOVE", "threshold": 20, "thresholdDuration": 300, "thresholdOccurrences": "ALL"}]`
nrqlDataAccountId	Int	オプション。 `accountId` と異なる場合に、NRQLクエリを実行する対象のアカウントです。	`123456`
signalSeasonality	弦	オプション。ベースラインの予測モデルに適用される季節性パターン。 `NEW_RELIC_CALCULATION` （デフォルト）、 `HOURLY` 、 `DAILY` 、 `WEEKLY` または `NONE` のいずれか。	`"NEW_RELIC_CALCULATION"`
description	弦	オプション。条件のフリーテキストによる説明。	`"Alerts when throughput deviates from its baseline."`
runbookUrl	弦	オプション。条件からリンクするランブックのURL。	`"https://runbooks.example.com/anomalous-throughput"`
titleTemplate	弦	オプション。違反タイトルのHandlebarsスタイルのテンプレート。	`"{{ conditionName }} on {{ entity.name }}"`
ビオレーションタイムリミットセコンド	Int	オプション。指定した秒数後に、オープン状態の違反を強制的にクローズします。	`86400`
シグナル	地図	オプション。高度な信号およびストリーミング設定。フィールドの説明については、 `createStaticNrqlCondition` をご覧ください。	`{"aggregationWindow": 60, "aggregationMethod": "EVENT_FLOW", "aggregationDelay": 120}`
有効期限	地図	オプション。信号損失の設定。フィールドの説明については、 `createStaticNrqlCondition` をご覧ください。	`{"closeViolationsOnExpiration": true, "expirationDuration": 300, "openViolationOnExpiration": false}`
selectors	リスト	オプション。レスポンスから値を抽出するためのJQセレクター。	`selectors: - name: conditionId expression: ".data.alertsNrqlConditionBaselineCreate.id"`

次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。

出力	タイプ	説明
success	ブール値	`true` ステップがエラーなしで実行された場合。
errorMessage	弦	NerdGraphエラーを含む、失敗時のエラーメッセージです。成功した場合は `null` 。
データ	地図	NerdGraphのレスポンス。`data`から`id`、`name`、`enabled`、`policyId`、`entityGuid`、`type`、または`baselineDirection`を抽出するには、`selectors`を使用します。 `{ "data": { "alertsNrqlConditionBaselineCreate": { "id": "7654322", "name": "Anomalous throughput", "enabled": true, "policyId": "2000002", "entityGuid": "MTE5MzMzNDd8TlIxfE5SUV9DT05EQVRJT058NzY1NDMyMg", "type": "BASELINE", "baselineDirection": "UPPER_ONLY" } } }`

出力

タイプ

説明

success

ブール値

true

ステップがエラーなしで実行された場合。

errorMessage

弦

NerdGraphエラーを含む、失敗時のエラーメッセージです。成功した場合は

null

。

データ

地図

NerdGraphのレスポンス。dataからid、name、enabled、policyId、entityGuid、type、またはbaselineDirectionを抽出するには、selectorsを使用します。

{
  "data": {
    "alertsNrqlConditionBaselineCreate": {
      "id": "7654322",
      "name": "Anomalous throughput",
      "enabled": true,
      "policyId": "2000002",
      "entityGuid": "MTE5MzMzNDd8TlIxfE5SUV9DT05EQVRJT058NzY1NDMyMg",
      "type": "BASELINE",
      "baselineDirection": "UPPER_ONLY"
    }
  }
}

次の例では、スループットが予想範囲を上回った場合にアラートを発するベースラインNRQL条件を作成します。

ワークフローの例
name: create_baseline_nrql_condition description: Create a baseline NRQL alert condition steps: - name: createBaselineCondition type: action action: newrelic.alerts.createBaselineNrqlCondition version: 1 inputs: accountId: ${{ .workflowInputs.accountId }} policyId: ${{ .workflowInputs.policyId }} name: "Anomalous throughput" nrqlQuery: "SELECT count(*) FROM Transaction WHERE appName = 'MyApp'" enabled: true baselineDirection: "UPPER_ONLY" terms: - priority: "WARNING" operator: "ABOVE" threshold: 20 thresholdDuration: 600 thresholdOccurrences: "ALL" selectors: - name: conditionId expression: ".data.alertsNrqlConditionBaselineCreate.id" next: end

ワークフローの例

name: create_baseline_nrql_condition
description: Create a baseline NRQL alert condition
steps:
  - name: createBaselineCondition
    type: action
    action: newrelic.alerts.createBaselineNrqlCondition
    version: 1
    inputs:
      accountId: ${{ .workflowInputs.accountId }}
      policyId: ${{ .workflowInputs.policyId }}
      name: "Anomalous throughput"
      nrqlQuery: "SELECT count(*) FROM Transaction WHERE appName = 'MyApp'"
      enabled: true
      baselineDirection: "UPPER_ONLY"
      terms:
        - priority: "WARNING"
          operator: "ABOVE"
          threshold: 20
          thresholdDuration: 600
          thresholdOccurrences: "ALL"
      selectors:
        - name: conditionId
          expression: ".data.alertsNrqlConditionBaselineCreate.id"
    next: end

この機械翻訳は、参考として提供されています。