Crear una condición NRQL de línea de base

El identificador de la acción es newrelic.alerts.createBaselineNrqlCondition.

Crea una nueva condición de alerta NRQL de línea de base bajo una política de alertas. Una condición de línea de base predice dinámicamente el rango esperado de una señal a partir de su comportamiento histórico y abre una infracción cuando la señal en vivo se desvía de esa línea de base predicha en más del umbral configurado.

Se debe proporcionar al menos uno de terms o expiration (con openViolationOnExpiration: true). Omitir ambos hace que falle la validación de NerdGraph.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
ID de la cuenta	En t	Requerido. La cuenta de New Relic en la que se creará la condición.	`123456`
policyId	Cadena	Requerido. El ID de la política de alertas a la que adjuntar esta condición.	`"2000002"`
nombre	Cadena	Requerido. El nombre de la condición.	`"Anomalous throughput"`
nrqlQuery	Cadena	Requerido. La consulta NRQL a evaluar.	`"SELECT count(*) FROM Transaction WHERE appName = 'MyApp'"`
activado	Booleano	Requerido. Si la condición está activa.	`true`
baselineDirection	Cadena	Requerido. La dirección de la desviación que desencadena una infracción. Uno de `UPPER_ONLY` , `LOWER_ONLY` o `UPPER_AND_LOWER` .	`"UPPER_ONLY"`
términos	Lista	Requerido condicionalmente. Los umbrales de la condición expresados como desviación porcentual respecto a la línea de base. Requerido a menos que `expiration` se proporcione con `openViolationOnExpiration: true` . Cada entrada: `priority` ( `CRITICAL` o `WARNING` ), `operator` (solo `ABOVE` —la dirección está controlada por `baselineDirection` ), `threshold` (flotante, desviación porcentual), `thresholdDuration` (segundos), `thresholdOccurrences` ( `ALL` o `AT_LEAST_ONCE` ).	`[{"priority": "CRITICAL", "operator": "ABOVE", "threshold": 20, "thresholdDuration": 300, "thresholdOccurrences": "ALL"}]`
nrqlDataAccountId	En t	Opcional. Cuenta en la que se ejecutará la consulta NRQL si es diferente de `accountId` .	`123456`
signalSeasonality	Cadena	Opcional. Patrón estacional aplicado al modelo de predicción de la línea de base. Uno de `NEW_RELIC_CALCULATION` (predeterminado), `HOURLY` , `DAILY` , `WEEKLY` o `NONE` .	`"NEW_RELIC_CALCULATION"`
descripción	Cadena	Opcional. Descripción de texto libre de la condición.	`"Alerts when throughput deviates from its baseline."`
runbookUrl	Cadena	Opcional. URL de un runbook para vincular desde la condición.	`"https://runbooks.example.com/anomalous-throughput"`
titleTemplate	Cadena	Opcional. Plantilla de estilo Handlebars para el título de la infracción.	`"{{ conditionName }} on {{ entity.name }}"`
violationTimeLimitSeconds	En t	Opcional. Cierra de forma forzada una infracción abierta después de esta cantidad de segundos.	`86400`
señal	Mapa	Opcional. Configuración avanzada de señal y streaming. Consulte `createStaticNrqlCondition` para ver las descripciones de los campos.	`{"aggregationWindow": 60, "aggregationMethod": "EVENT_FLOW", "aggregationDelay": 120}`
vencimiento	Mapa	Opcional. Configuración de pérdida de señal. Consulte `createStaticNrqlCondition` para ver las descripciones de los campos.	`{"closeViolationsOnExpiration": true, "expirationDuration": 300, "openViolationOnExpiration": false}`
selectors	Lista	Opcional. Selectores JQ para extraer valores de la respuesta.	`selectors: - name: conditionId expression: ".data.alertsNrqlConditionBaselineCreate.id"`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
success	Booleano	`true` cuando el paso se ejecutó sin errores.
errorMessage	Cadena	Mensaje de error en caso de fallo, incluidos los errores de NerdGraph. `null` en caso de éxito.
datos	Mapa	Respuesta de NerdGraph. Use `selectors` para extraer `id`, `name`, `enabled`, `policyId`, `entityGuid`, `type` o `baselineDirection` de `data`. `{ "data": { "alertsNrqlConditionBaselineCreate": { "id": "7654322", "name": "Anomalous throughput", "enabled": true, "policyId": "2000002", "entityGuid": "MTE5MzMzNDd8TlIxfE5SUV9DT05EQVRJT058NzY1NDMyMg", "type": "BASELINE", "baselineDirection": "UPPER_ONLY" } } }`

Producción

Tipo

Descripción

success

Booleano

true

cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Mensaje de error en caso de fallo, incluidos los errores de NerdGraph.

null

en caso de éxito.

datos

Mapa

Respuesta de NerdGraph. Use selectors para extraer id, name, enabled, policyId, entityGuid, type o baselineDirection de data.

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

El siguiente ejemplo crea una condición NRQL de línea de base que genera alertas cuando el rendimiento se desvía por encima de su rango esperado.

Ejemplo de flujo de trabajo
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

Ejemplo de flujo de trabajo

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Crear una condición NRQL de línea de base