NerdGraphチュートリアルNRQLコンディションアラート

NerdGraphAPIを使用してアラート条件を管理できます。

ヒント

NerdGraphおよびNerdGraphエクスプローラーの使用を開始するためのヘルプについては、 NerdGraphの概要を参照してください。

NRQLの条件を作成する手順

以下の手順に従ってください。

作成する条件タイプを決定します（ NRQL 条件しきい値タイプを参照）。
次のいずれかを実行して、関連するpolicyIDを見つけます。
- NerdGraphポリシーAPIを使用する.
- one.newrelic.com > All capabilities > Alerts & AI > Alert conditions (Policies)
  に移動します。ポリシーを選択します。ポリシー名の下にある ID を見つけます。
NRQL の条件タイプに適したミューテーションと関連する値を提供してください。

ヒント

NerdGraph GraphiQLエクスプローラーは、NerdGraph NRQLConditionsAPIのフィールドごとの詳細に関する最新のドキュメントを見つけるのに最適な場所です。たとえば、「 valueFunctionフィールドは何を受け入れますか？」などの質問です。インラインのNerdGraphドキュメントで最もよく答えられます。

NRQLの静的条件

ここでは、静的な条件を作成する例を紹介します。

mutation {
  alertsNrqlConditionStaticCreate(
    accountId: YOUR_ACCOUNT_ID
    policyId: YOUR_POLICY_ID
    condition: {
      name: "Low Host Count - Catastrophic"
      enabled: true
      nrql: {
        query: "SELECT uniqueCount(host) FROM Transaction WHERE appName='my-app-name'"
      }
      signal: {
        aggregationWindow: 60
        aggregationMethod: EVENT_FLOW
        aggregationDelay: 120
      }
      terms: {
        threshold: 2
        thresholdOccurrences: AT_LEAST_ONCE
        thresholdDuration: 600
        operator: BELOW
        priority: CRITICAL
      }
      valueFunction: SINGLE_VALUE
      violationTimeLimitSeconds: 86400
    }
  ) {
    id
    name
  }
}

NRQLベースライン条件

ここでは、ベースラインの状態を作成する例を紹介します。

mutation {
  alertsNrqlConditionBaselineCreate(
    accountId: YOUR_ACCOUNT_ID
    policyId: YOUR_POLICY_ID
    condition: {
      name: "Baseline Condition"
      enabled: true
      baselineDirection: UPPER_ONLY
      nrql: { query: "SELECT average(duration) FROM Transaction" }
      signal: {
        aggregationWindow: 60
        aggregationMethod: EVENT_FLOW
        aggregationDelay: 120
      }
      terms: {
        threshold: 13
        thresholdDuration: 180
        thresholdOccurrences: ALL
        operator: ABOVE
        priority: CRITICAL
      }
      violationTimeLimitSeconds: 86400
    }
  ) {
    id
    name
    baselineDirection
  }
}

条件の更新

次の項目を完了します。

次のようにnrqlConditionsSearchクエリのタイプフィールドをリクエストして、既存の条件のタイプを判別します。
```
{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlConditionsSearch {
          nrqlConditions {
            id
            type
          }
        }
      }
    }
  }
}
```
ヒント
返されるtypeは、更新ミューテーションに使用するものです。たとえば、返されるタイプがSTATICの場合、 alertsNrqlConditionStaticUpdateを使用します。返されるタイプがBASELINEの場合は、 alertsNrqlConditionBaselineUpdateを使用します。
条件のidを関連する条件タイプのミューテーションに提供します。更新できるのは、関連するタイプの条件のみであることに注意してください。

更新したいフィールドの更新変異のみを提供します。アップデートに提供していないフィールドはタッチされません。

変異点の更新

アップデートで指定したフィールドのみが変更されます。次の例では、 baselineDirectionは変更されずに返されますが、 nameは更新されます。

mutation {
  alertsNrqlConditionBaselineUpdate(
    id: YOUR_CONDITION_ID
    accountId: YOUR_ACCOUNT_ID
    condition: { name: "Your updated name" }
  ) {
    id
    name
    baselineDirection
  }
}

NRQL条件のリストアップとフィルタリング

NRQL条件を一覧表示またはフィルタリングするには、NerdGraphでnrqlConditionsSearchクエリを使用します。

NRQL条件の基本的なリスト機能では、NRQL条件をページングしたり、アカウントごとの条件の合計数を要求したりすることができます。

nrqlConditionsSearchクエリは、カーソルのページ付けを利用してリソースをページ分割します。カーソルのページ付けの背後にある考え方は、カーソルが空に戻るまで、クライアントがプログラムループでカーソルを要求することです。

初期のリスト対応は以下のようになります。

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlConditionsSearch {
          nextCursor
          nrqlConditions {
            id
            name
            type
          }
          totalCount
        }
      }
    }
  }
}

この例では、次のようなJSONレスポンスを返します。

{
  "data": {
    "actor": {
      "account": {
        "alerts": {
          "nrqlConditionsSearch": {
            "nextCursor": "WOwfJ4+TWm9QTFeKMGyg+w==:QqkI8S4+Wwnpno6z+uk8kQ==",
            "nrqlConditions": [
              {
                "id": "4432",
                "name": "Baseline Condition",
                "type": "BASELINE"
              },
              {
                "id": "443",
                "name": "A static condition",
                "type": "STATIC"
              }
              // more conditions here in reality
            ],
            "totalCount": 435
          }
        }
      }
    }
  }
}

応答の条件をページ分割するには、 nextCursorが応答からnullとして返されるまでカーソルを返すようにクライアントに要求させます。

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlConditionsSearch(
          cursor: "WOwfJ4+TWm9QTFeKMGyg+w==:QqkI8S4+Wwnpno6z+uk8kQ=="
        ) {
          nextCursor
          nrqlConditions {
            id
            name
            type
          }
          totalCount
        }
      }
    }
  }
}

特定のフィールドは、特定のNRQL条件タイプでしか利用できません。異なる条件タイプの間で変異が分割されている主な理由は、受け入れられるフィールドの間に細かい違いがあるからです。

たとえば、 valueFunctionは静的NRQL条件にのみ関連し、 baselineDirectionはベースラインNRQL条件にのみ関連します。

しかし、これらのフィールドが特定の条件タイプでしか利用できない場合、すべての条件タイプのリストでそれらを返すにはどうすればよいのでしょうか？その答えは、インライン・フラグメントと呼ばれるGraphQLの慣習です。インライン・フラグメントでは、特定のタイプのNRQL条件のデータにアクセスすることができます。

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlConditionsSearch {
          nrqlConditions {
            id
            name
            type
            ... on AlertsNrqlStaticCondition {
              valueFunction
            }
            ... on AlertsNrqlBaselineCondition {
              baselineDirection
            }
          }
        }
      }
    }
  }
}

前述のクエリ例では、どのNRQL条件が正しいタイプなのかを判断するために、GraphQLにハードワークを依頼しています。

そのため、返されたタイプが静的条件の場合はオブジェクトでvalueFunctionを返し、返されたタイプがベースライン条件の場合は代わりにbaselineDirectionを返します。応答の例を次に示します。

{
  "data": {
    "actor": {
      "account": {
        "alerts": {
          "nrqlConditionsSearch": {
            "nrqlConditions": [
              {
                "baselineDirection": "UPPER_ONLY",
                "id": "342",
                "name": "My baseline condition",
                "type": "BASELINE"
              },
              {
                "id": "553",
                "name": "My static condition",
                "type": "STATIC",
                "valueFunction": "SINGLE_VALUE"
              }
            ]
          }
        }
      }
    }
  }
}

nrqlConditionsSearchクエリのsearchCriteria引数を使用してNRQL条件をフィルタリングできます。

ここでは、名前によるマッチングでNRQL条件をフィルタリングする例を紹介します。このクエリは、指定された名前にマッチする NRQL 条件を返します。このマッチは大文字と小文字を区別しないことに注意してください。

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlConditionsSearch(searchCriteria: { name: "Baseline Condition" }) {
          nrqlConditions {
            id
            name
            type
          }
        }
      }
    }
  }
}

単数形のNRQL条件検索

NRQL条件APIを使用して、単一の条件を照会できます。 alert名前空間でnrqlConditionクエリを実行します。

nrqlConditionSearchクエリのタイプ固有のフィールドと同様に、これらのインラインフラグメントを使用して、NRQL条件タイプに制限されているフィールドをリクエストすることもできます。

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlCondition(id: YOUR_CONDITION_ID) {
          id
          name
          ... on AlertsNrqlStaticCondition {
            valueFunction
          }
        }
      }
    }
  }
}

説明文の更新

ここでは、NRQLのアラート条件に説明文を作成する手順を説明します。

保険契約の条件をすべて把握する。

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlConditionsSearch(searchCriteria: { policyId: YOUR_POLICY_ID }) {
          nrqlConditions {
            id
            name
            description
            enabled
            nrql {
              query
            }
            signal {
              aggregationWindow
              aggregationMethod
              aggregationDelay
              aggregationTimer
            }
            policyId
            runbookUrl
            terms {
              operator
              thresholdDuration
              threshold
              priority
              thresholdOccurrences
            }
            type
            violationTimeLimitSeconds
          }
        }
      }
    }
  }
}

1つの条件の詳細を取得します。

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        nrqlCondition(id: "YOUR_CONDITION_ID") {
          description
          id
          enabled
          name
          nrql {
            query
          }
          signal {
            aggregationWindow
            aggregationMethod
            aggregationDelay
            aggregationTimer
          }
          policyId
          runbookUrl
          terms {
            operator
            priority
            threshold
            thresholdDuration
            thresholdOccurrences
          }
          type
          violationTimeLimitSeconds
        }
      }
    }
  }
}

説明文で変異を作成します。

ここには空の変異テンプレートがあります。

mutation {
  alertsNrqlConditionStaticUpdate(
    accountId: YOUR_ACCOUNT_ID
    id: "YOUR_CONDITION_ID"
    condition: { description: "" }
  ) {
    description
  }
}

ここでは、記述例を含む変異の例を紹介します。

mutation {
  alertsNrqlConditionStaticUpdate(
    accountId: 123456
    id: "123456"
    condition: {
      description: "timestamp : {{timestamp}} \n accountId : {{accountId}} \n type : {{type}} \n event : {{event}} \n description : {{description}} \n policyId : {{policyId}} \n policyName: {{policyName}} \n conditionName : {{conditionName}} \n conditionId : {{conditionId}} \n product : {{product}} \n conditionType : {{conditionType}} \n RunbookUrl : {{runbookUrl}} \n nrqlQuery : {{nrqlQuery}} \n nrqlEventType : {{nrqlEventType}} \n targetID : {{targetId}} \n targetName : {{targetName}} \n commandLine : {{tag.commandLine}} \n entityGuid : {{tag.entityGuid}} \n entityName : {{tag.entityName}} \n fullHostname : {{tag.fullHostname}} \n instanceType : {{tag.instanceType}} \n processDisplayName : {{tag.processDisplayName}}"
    }
  ) {
    description
  }
}

条件の削除

alertsConditionDeleteミューテーションを使用して、任意のタイプの条件を削除できます。削除ミューテーションでのみidフィールドをリクエストできます。例えば：

mutation {
  alertsConditionDelete(accountId: YOUR_ACCOUNT_ID, id: YOUR_CONDITION_ID) {
    id
  }
}

この機械翻訳は参考用に提供されます。

NerdGraphチュートリアルNRQLコンディションアラート

ヒント

NRQLの条件を作成する手順

ヒント

NRQLの静的条件

NRQLベースライン条件

条件の更新

ヒント

変異点の更新

NRQL条件のリストアップとフィルタリング

リクエストタイプ固有のフィールド

フィルターNRQL条件

単数形のNRQL条件検索

説明文の更新

条件の削除

この機械翻訳は参考用に提供されます。

NerdGraphチュートリアルNRQLコンディションアラート

ヒント

NRQLの条件を作成する手順 .css-21sua1{background:none;border:none;width:0;padding:0;}

ヒント

NRQLの静的条件

NRQLベースライン条件

条件の更新

ヒント

変異点の更新

NRQL条件のリストアップとフィルタリング

リクエストタイプ固有のフィールド

フィルターNRQL条件

単数形のNRQL条件検索

説明文の更新

条件の削除

NRQLの条件を作成する手順