Créer une condition NRQL de base de référence

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

Crée une nouvelle condition d’alerte NRQL de base de référence sous une règle d’alerte. Une condition de base de référence prédit dynamiquement la plage attendue d’un signal à partir de son comportement historique et ouvre une violation lorsque le signal en direct dévie de cette base de référence prédite d’une valeur supérieure au seuil configuré.

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.	`"Anomalous throughput"`
nrqlQuery	Chaîne	Obligatoire. La requête NRQL à évaluer.	`"SELECT count(*) FROM Transaction WHERE appName = 'MyApp'"`
enabled	Booléen	Obligatoire. Si la condition est active.	`true`
baselineDirection	Chaîne	Obligatoire. La direction de la déviation qui déclenche une violation. L’un de `UPPER_ONLY` , `LOWER_ONLY` ou `UPPER_AND_LOWER` .	`"UPPER_ONLY"`
termes	List	Requis sous condition. Les seuils de la condition exprimés en pourcentage de déviation par rapport à la base de référence. Requis sauf si `expiration` est fourni avec `openViolationOnExpiration: true` . Chaque entrée : `priority` ( `CRITICAL` ou `WARNING` ), `operator` ( `ABOVE` uniquement, la direction est contrôlée par `baselineDirection` ), `threshold` (flottant, déviation en pourcentage), `thresholdDuration` (secondes), `thresholdOccurrences` ( `ALL` ou `AT_LEAST_ONCE` ).	`[{"priority": "CRITICAL", "operator": "ABOVE", "threshold": 20, "thresholdDuration": 300, "thresholdOccurrences": "ALL"}]`
nrqlDataAccountId	Int	Facultatif. Compte sur lequel exécuter la requête NRQL s'il est différent de `accountId` .	`123456`
saisonnalitéDuSignal	Chaîne	Facultatif. Motif saisonnier appliqué au modèle de prédiction de la base de référence. L’un de `NEW_RELIC_CALCULATION` (par défaut), `HOURLY` , `DAILY` , `WEEKLY` , ou `NONE` .	`"NEW_RELIC_CALCULATION"`
description	Chaîne	Facultatif. Description en texte libre de la condition.	`"Alerts when throughput deviates from its baseline."`
runbookUrl	Chaîne	Facultatif. URL d'un runbook à lier depuis la condition.	`"https://runbooks.example.com/anomalous-throughput"`
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. Consultez `createStaticNrqlCondition` pour les descriptions des champs.	`{"aggregationWindow": 60, "aggregationMethod": "EVENT_FLOW", "aggregationDelay": 120}`
expiration	Carte	Facultatif. Paramètres de perte de signal. Consultez `createStaticNrqlCondition` pour les descriptions des champs.	`{"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.alertsNrqlConditionBaselineCreate.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`, `type`, ou `baselineDirection` de `data`. `{ "data": { "alertsNrqlConditionBaselineCreate": { "id": "7654322", "name": "Anomalous throughput", "enabled": true, "policyId": "2000002", "entityGuid": "MTE5MzMzNDd8TlIxfE5SUV9DT05EQVRJT058NzY1NDMyMg", "type": "BASELINE", "baselineDirection": "UPPER_ONLY" } } }`

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, type, ou baselineDirection de data.

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

L'exemple suivant crée une condition NRQL de base de référence qui déclenche une alerte lorsque le débit s'écarte au-dessus de sa plage attendue.

Exemple de workflow
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

Exemple de workflow

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

Cette traduction automatique est fournie pour votre commodité.

Créer une condition NRQL de base de référence