Créer une condition NRQL statique

L’identifiant de l’action est newrelic.alerts.createStaticNrqlCondition.

Crée une nouvelle condition d’alerte NRQL statique sous une règle d’alerte. Une condition NRQL statique évalue une requête NRQL selon une planification fixe et ouvre une violation lorsque le résultat franchit un seuil fixe.

Au moins l’un de terms ou expiration (avec openViolationOnExpiration: true) doit être fourni. L’omission des deux entraîne l’échec de la validation NerdGraph.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir	Type	Description	Exemple
accountId	Int	Obligatoire. Le compte New Relic dans lequel créer la condition.	`123456`
policyId	Chaîne	Obligatoire. L’ID de la règle d’alerte à laquelle attacher cette condition.	`"2000002"`
name	Chaîne	Obligatoire. Le nom de la condition.	`"High error rate"`
nrqlQuery	Chaîne	Obligatoire. La requête NRQL à évaluer.	`"SELECT count(*) FROM TransactionError WHERE appName = 'MyApp'"`
enabled	Booléen	Obligatoire. Si la condition est active.	`true`
termes	List	Requis sous condition. Les seuils de la condition. Requis sauf si `expiration` est fourni avec `openViolationOnExpiration: true` . Chaque entrée nécessite : `priority` ( `CRITICAL` ou `WARNING` ), `operator` ( `ABOVE` , `ABOVE_OR_EQUALS` , `BELOW` , `BELOW_OR_EQUALS` , `EQUALS` , ou `NOT_EQUALS` ), `threshold` (flottant), `thresholdDuration` (secondes), et `thresholdOccurrences` ( `ALL` ou `AT_LEAST_ONCE` ).	`[{"priority": "CRITICAL", "operator": "ABOVE", "threshold": 5, "thresholdDuration": 300, "thresholdOccurrences": "ALL"}]`
nrqlDataAccountId	Int	Facultatif. Compte sur lequel exécuter la requête NRQL s'il est différent de `accountId` .	`123456`
description	Chaîne	Facultatif. Description en texte libre de la condition.	`"Alerts when the error rate exceeds the threshold."`
runbookUrl	Chaîne	Facultatif. URL d'un runbook à lier depuis la condition.	`"https://runbooks.example.com/high-error-rate"`
titleTemplate	Chaîne	Facultatif. Modèle de style Handlebars pour le titre de la violation.	`"{{ conditionName }} on {{ entity.name }}"`
violationTimeLimitSeconds	Int	Facultatif. Force la fermeture d’une violation ouverte après ce nombre de secondes.	`86400`
signal	Carte	Facultatif. Paramètres avancés de signal et de streaming : `aggregationWindow` , `aggregationMethod` ( `EVENT_FLOW` , `EVENT_TIMER` ou `CADENCE` ), `aggregationDelay` , `aggregationTimer` , `slideBy` , `evaluationDelay` , `fillOption` ( `NONE` , `LAST_VALUE` ou `STATIC` ), `fillValue` , `pollingFrequency` .	`{"aggregationWindow": 60, "aggregationMethod": "EVENT_FLOW", "aggregationDelay": 120}`
expiration	Carte	Facultatif. Paramètres de perte de signal : `closeViolationsOnExpiration` , `expirationDuration` (secondes), `openViolationOnExpiration` , `ignoreOnExpectedTermination` .	`{"closeViolationsOnExpiration": true, "expirationDuration": 300, "openViolationOnExpiration": false}`
selectors	List	Facultatif. Sélecteurs JQ pour extraire des valeurs de la réponse.	`selectors: - name: conditionId expression: ".data.alertsNrqlConditionStaticCreate.id"`

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir	Type	Description
success	Booléen	`true` lorsque l'étape s'est exécutée sans erreur.
errorMessage	Chaîne	Message d’erreur en cas d'échec, y compris les erreurs NerdGraph. `null` en cas de succès.
données	Carte	Réponse NerdGraph. Utilisez `selectors` pour extraire `id`, `name`, `enabled`, `policyId`, `entityGuid`, ou `type` de `data`. `{ "data": { "alertsNrqlConditionStaticCreate": { "id": "7654321", "name": "High error rate", "enabled": true, "policyId": "2000002", "entityGuid": "MTE5MzMzNDd8TlIxfE5SUV9DT05EQVRJT058NzY1NDMyMQ", "type": "STATIC" } } }`

Sortir

Type

Description

success

Booléen

true

lorsque l'étape s'est exécutée sans erreur.

errorMessage

Chaîne

Message d’erreur en cas d'échec, y compris les erreurs NerdGraph.

null

en cas de succès.

données

Carte

Réponse NerdGraph. Utilisez selectors pour extraire id, name, enabled, policyId, entityGuid, ou type de data.

{
  "data": {
    "alertsNrqlConditionStaticCreate": {
      "id": "7654321",
      "name": "High error rate",
      "enabled": true,
      "policyId": "2000002",
      "entityGuid": "MTE5MzMzNDd8TlIxfE5SUV9DT05EQVRJT058NzY1NDMyMQ",
      "type": "STATIC"
    }
  }
}

L'exemple suivant crée une condition NRQL statique et capture son ID pour l'utiliser dans les étapes ultérieures.

Exemple de workflow
name: create_static_nrql_condition description: Create a static NRQL alert condition steps: - name: createCondition type: action action: newrelic.alerts.createStaticNrqlCondition version: 1 inputs: accountId: ${{ .workflowInputs.accountId }} policyId: ${{ .workflowInputs.policyId }} name: "High error rate" nrqlQuery: "SELECT count(*) FROM TransactionError WHERE appName = 'MyApp'" enabled: true terms: - priority: "CRITICAL" operator: "ABOVE" threshold: 5 thresholdDuration: 300 thresholdOccurrences: "ALL" selectors: - name: conditionId expression: ".data.alertsNrqlConditionStaticCreate.id" next: end

Exemple de workflow

name: create_static_nrql_condition
description: Create a static NRQL alert condition
steps:
  - name: createCondition
    type: action
    action: newrelic.alerts.createStaticNrqlCondition
    version: 1
    inputs:
      accountId: ${{ .workflowInputs.accountId }}
      policyId: ${{ .workflowInputs.policyId }}
      name: "High error rate"
      nrqlQuery: "SELECT count(*) FROM TransactionError WHERE appName = 'MyApp'"
      enabled: true
      terms:
        - priority: "CRITICAL"
          operator: "ABOVE"
          threshold: 5
          thresholdDuration: 300
          thresholdOccurrences: "ALL"
      selectors:
        - name: conditionId
          expression: ".data.alertsNrqlConditionStaticCreate.id"
    next: end

Cette traduction automatique est fournie pour votre commodité.