Acciones de nivel de servicio de New Relic

Esta página proporciona una referencia de todas las acciones de nivel de servicio de New Relic disponibles en el catálogo de acciones de automatización de flujos de trabajo. Estas acciones le permiten crear, actualizar, eliminar y listar indicadores de nivel de servicio (SLI) y sus objetivos de nivel de servicio (SLO) directamente desde un flujo de trabajo —lo que permite la incorporación automatizada de servicios, la corrección de SLO y los flujos de trabajo de cumplimiento.

Requisitos previos

Antes de usar las acciones de nivel de servicio de New Relic en la automatización del flujo de trabajo, asegúrese de tener lo siguiente:

Una cuenta de New Relic con los permisos apropiados para administrar los niveles de servicio.

Crear un nivel de servicio

El identificador de la acción es newrelic.serviceLevel.create.

Crea un nuevo indicador de nivel de servicio (SLI) con su objetivo de nivel de servicio (SLO) para una entidad.

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

Aporte	Tipo	Descripción	Ejemplo
Guía de entidad	Cadena	Requerido. La entidad para la que se define este SLI.	`"MjXzMzQ2fEFQTXxBUFBMSUNBVElPTnwyMzU5MzAzOTU"`
nombre	Cadena	Requerido. Nombre del SLI.	`"Checkout API availability"`
descripción	Cadena	Opcional. Descripción del SLI.	`"Auto-provisioned on service onboarding"`
ID de la cuenta	En t	Requerido. La cuenta de New Relic que posee el SLI.	`1234567`
validEventsFrom	Cadena	Requerido. Tipo de evento de NRDB para el grupo de eventos válidos.	`"Transaction"`
validEventsWhere	Cadena	Opcional. Condición booleana de NRQL para filtrar el grupo de eventos válidos.	`"appName = 'checkout-api'"`
validEventsSelectFunction	Cadena	Opcional. Función de agregación para el grupo de eventos válidos. Uno de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
validEventsSelectAttribute	Cadena	Opcional. Atributo a agregar para el grupo de eventos válidos. Requerido cuando `validEventsSelectFunction` es `SUM` , `GET_FIELD` o `GET_CDF_COUNT` .	`"duration"`
validEventsSelectThreshold	Flotante	Opcional. Valor del umbral para el grupo de eventos válidos. Solo se usa cuando `validEventsSelectFunction` es `GET_CDF_COUNT` .	`500`
eventCategory	Cadena	Requerido. Clasificación del bucket de eventos de condición como eventos buenos o malos. Uno de `GOOD` , `BAD` .	`"GOOD"`
conditionEventsFrom	Cadena	Requerido. Tipo de evento de NRDB para el bucket de eventos buenos/malos.	`"Transaction"`
conditionEventsWhere	Cadena	Opcional. Condición booleana de NRQL para filtrar el bucket de eventos buenos/malos.	`"appName = 'checkout-api' AND error IS FALSE"`
conditionEventsSelectFunction	Cadena	Opcional. Función de agregación para el bucket de eventos buenos/malos. Uno de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
conditionEventsSelectAttribute	Cadena	Opcional. Atributo a agregar para el bucket bueno/malo. Requerido cuando `conditionEventsSelectFunction` es `SUM` , `GET_FIELD` o `GET_CDF_COUNT` .	`"duration"`
conditionEventsSelectThreshold	Flotante	Opcional. Valor del umbral para el bucket bueno/malo. Solo se usa cuando `conditionEventsSelectFunction` es `GET_CDF_COUNT` .	`500`
facets	Lista	Opcional. Atributos para agrupar los resultados de SLI.	`["appName"]`
objetivo	Flotante	Requerido. Objetivo de SLO como porcentaje.	`99.9`
windowDays	En t	Requerido. Ventana móvil en días. Debe ser `1` , `7` o `28` .	`28`
selectors	Lista	Opcional. Selectores JQ para extraer valores específicos de la respuesta. Utilice `.data.serviceLevelCreate.guid` para capturar el GUID del nuevo SLI para usarlo en pasos posteriores.	`selectors: - name: sliGuid expression: ".data.serviceLevelCreate.guid"`

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

Producción	Tipo	Descripción
success	Booleano	`true` / `false` , heredado de la llamada `newrelic.nerdgraph.execute` subyacente —cubre tanto los fallos de transporte como los errores de lógica empresarial de NerdGraph.
errorMessage	Cadena	Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph. `null` en caso de éxito.
datos	Mapa	Respuesta de NerdGraph: `{ "data": { "serviceLevelCreate": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } } }` Use `selectors` para extraer `guid` o `name` de `data`.

Producción

Tipo

Descripción

success

Booleano

true

false

, heredado de la llamada

newrelic.nerdgraph.execute

subyacente —cubre tanto los fallos de transporte como los errores de lógica empresarial de NerdGraph.

errorMessage

Cadena

Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph.

null

en caso de éxito.

datos

Mapa

Respuesta de NerdGraph:

{
  "data": {
    "serviceLevelCreate": {
      "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
      "name": "Checkout API availability"
    }
  }
}

Use selectors para extraer guid o name de data.

El siguiente ejemplo crea un SLI/SLO y captura el GUID del nuevo SLI usando selectors para usarlo en un paso posterior.

Ejemplo de flujo de trabajo
name: newrelic_service_level_create_workflow description: Create an SLI/SLO for a service entity steps: - name: createSlo type: action action: newrelic.serviceLevel.create version: 1 inputs: entityGuid: ${{ .workflowInputs.entityGuid }} name: "Checkout API availability" accountId: ${{ .workflowInputs.accountId }} validEventsFrom: "Transaction" eventCategory: "GOOD" conditionEventsFrom: "Transaction" conditionEventsWhere: "appName = 'checkout-api' AND error IS FALSE" target: 99.9 windowDays: 28 selectors: - name: sliGuid expression: ".data.serviceLevelCreate.guid" next: end

Ejemplo de flujo de trabajo

name: newrelic_service_level_create_workflow
description: Create an SLI/SLO for a service entity
steps:
  - name: createSlo
    type: action
    action: newrelic.serviceLevel.create
    version: 1
    inputs:
      entityGuid: ${{ .workflowInputs.entityGuid }}
      name: "Checkout API availability"
      accountId: ${{ .workflowInputs.accountId }}
      validEventsFrom: "Transaction"
      eventCategory: "GOOD"
      conditionEventsFrom: "Transaction"
      conditionEventsWhere: "appName = 'checkout-api' AND error IS FALSE"
      target: 99.9
      windowDays: 28
      selectors:
        - name: sliGuid
          expression: ".data.serviceLevelCreate.guid"
    next: end

Actualizar un nivel de servicio

El identificador de la acción es newrelic.serviceLevel.update.

Actualiza la configuración de un indicador de nivel de servicio existente o sus objetivos de nivel de servicio. Usa newrelic.nerdgraph.execute.

Los campos name y description son opcionales individualmente —omitir cualquiera de ellos conserva el valor existente. Los campos target y windowDays son a todo o nada: proporcione ambos para cambiar el objetivo de SLO, u omita ambos para mantener el SLO existente sin cambios.

Para la configuración de eventos (validEvents*, conditionEvents*, eventCategory, facets), omitir cualquier campo lo elimina en lugar de conservarlo. Para cambiar un campo en la sección de eventos, vuelva a proporcionar la definición completa de eventos actuales junto con el cambio.

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

Aporte	Tipo	Descripción	Ejemplo
sliGuid	Cadena	Requerido. El GUID del SLI. Utilice la salida del selector `sliGuid` de `newrelic.serviceLevel.create` .	`"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"`
nombre	Cadena	Opcional. Nuevo nombre del SLI. Si se omite, se conserva el nombre existente.	`"Checkout API availability (v2)"`
descripción	Cadena	Opcional. Nueva descripción del SLI. Si se omite, se conserva la descripción existente.	`"Tightened after Q3 reliability review"`
validEventsFrom	Cadena	Opcional. Tipo de evento de NRDB para el grupo de eventos válidos. Obligatorio si se establece cualquier otro campo `validEvents` , `conditionEvents` o `eventCategory` .	`"Transaction"`
validEventsWhere	Cadena	Opcional. Condición booleana de NRQL para filtrar el grupo de eventos válidos.	`"appName = 'checkout-api'"`
validEventsSelectFunction	Cadena	Opcional. Función de agregación para el grupo de eventos válidos. Uno de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
validEventsSelectAttribute	Cadena	Opcional. Atributo a agregar para el grupo de eventos válidos. Requerido cuando `validEventsSelectFunction` es `SUM` , `GET_FIELD` o `GET_CDF_COUNT` .	`"duration"`
validEventsSelectThreshold	Flotante	Opcional. Valor del umbral para el grupo de eventos válidos. Solo se usa cuando `validEventsSelectFunction` es `GET_CDF_COUNT` .	`500`
eventCategory	Cadena	Opcional. Clasificación del bucket de eventos de condición como eventos buenos o malos. Uno de `GOOD` , `BAD` . Requerido junto con `conditionEventsFrom` al establecer la configuración de eventos.	`"GOOD"`
conditionEventsFrom	Cadena	Opcional. Tipo de evento de NRDB para el bucket de eventos buenos/malos.	`"Transaction"`
conditionEventsWhere	Cadena	Opcional. Condición booleana de NRQL para filtrar el bucket de eventos buenos/malos.	`"appName = 'checkout-api' AND error IS FALSE"`
conditionEventsSelectFunction	Cadena	Opcional. Función de agregación para el bucket de eventos buenos/malos. Uno de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
conditionEventsSelectAttribute	Cadena	Opcional. Atributo a agregar para el bucket bueno/malo. Requerido cuando `conditionEventsSelectFunction` es `SUM` , `GET_FIELD` o `GET_CDF_COUNT` .	`"duration"`
conditionEventsSelectThreshold	Flotante	Opcional. Valor del umbral para el bucket bueno/malo. Solo se usa cuando `conditionEventsSelectFunction` es `GET_CDF_COUNT` .	`500`
facets	Lista	Opcional. Atributos para agrupar los resultados de SLI.	`["appName"]`
objetivo	Flotante	Opcional. Nuevo objetivo de SLO como porcentaje. Todo o nada con `windowDays` : proporcione ambos juntos u omita ambos.	`99.95`
windowDays	En t	Opcional. Ventana móvil en días. Debe ser `1` , `7` o `28` cuando se establece. Todo o nada con `target` : proporcione ambos juntos u omita ambos.	`28`
selectors	Lista	Opcional. Selectores JQ para extraer valores específicos de la respuesta.	`selectors: - name: sliGuid expression: ".data.serviceLevelUpdate.guid"`

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

Producción	Tipo	Descripción
success	Booleano	`true` / `false` , heredado de la llamada `newrelic.nerdgraph.execute` subyacente —cubre tanto los fallos de transporte como los errores de lógica empresarial de NerdGraph.
errorMessage	Cadena	Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph. `null` en caso de éxito.
datos	Mapa	Respuesta de NerdGraph: `{ "data": { "serviceLevelUpdate": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability (v2)" } } }` Use `selectors` para extraer `guid` o `name` de `data`.

Producción

Tipo

Descripción

success

Booleano

true

false

, heredado de la llamada

newrelic.nerdgraph.execute

subyacente —cubre tanto los fallos de transporte como los errores de lógica empresarial de NerdGraph.

errorMessage

Cadena

Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph.

null

en caso de éxito.

datos

Mapa

Respuesta de NerdGraph:

{
  "data": {
    "serviceLevelUpdate": {
      "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
      "name": "Checkout API availability (v2)"
    }
  }
}

Use selectors para extraer guid o name de data.

El siguiente ejemplo ajusta el objetivo de SLO en un SLI existente utilizando el GUID capturado de un paso newrelic.serviceLevel.create anterior.

Ejemplo de flujo de trabajo
`name: newrelic_service_level_update_workflow description: Tighten the SLO target on an existing SLI steps: - name: tightenSlo type: action action: newrelic.serviceLevel.update version: 1 inputs: sliGuid: ${{ .steps.createSlo.outputs.sliGuid }} target: 99.95 windowDays: 28 next: end`

Ejemplo de flujo de trabajo

name: newrelic_service_level_update_workflow
description: Tighten the SLO target on an existing SLI
steps:
  - name: tightenSlo
    type: action
    action: newrelic.serviceLevel.update
    version: 1
    inputs:
      sliGuid: ${{ .steps.createSlo.outputs.sliGuid }}
      target: 99.95
      windowDays: 28
    next: end

Eliminar un nivel de servicio

El identificador de la acción es newrelic.serviceLevel.delete.

Elimina un indicador de nivel de servicio (SLI) existente y su objetivo de nivel de servicio (SLO). Usa newrelic.nerdgraph.execute.

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

Aporte

Tipo

Descripción

Ejemplo

sliGuid

Cadena

Requerido.

El GUID del SLI. Utilice la salida del selector

sliGuid

newrelic.serviceLevel.create

"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"

selectors

Lista

Opcional.

Selectores JQ para extraer valores específicos de la respuesta.

selectors:
  - name: deletedGuid
    expression: ".data.serviceLevelDelete.guid"

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

Producción	Tipo	Descripción
success	Booleano	`true` / `false` , heredado de la llamada `newrelic.nerdgraph.execute` subyacente —cubre tanto las fallas de transporte (distinto de 200, error de red) como los errores de lógica de negocios de NerdGraph (matriz `errors` en una respuesta que de otro modo sería 200).
errorMessage	Cadena	Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph. `null` en caso de éxito.
datos	Mapa	Respuesta de NerdGraph: `{ "data": { "serviceLevelDelete": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } } }` Use `selectors` para extraer `guid` o `name` de `data`.

Producción

Tipo

Descripción

success

Booleano

true

false

, heredado de la llamada

newrelic.nerdgraph.execute

subyacente —cubre tanto las fallas de transporte (distinto de 200, error de red) como los errores de lógica de negocios de NerdGraph (matriz

errors

en una respuesta que de otro modo sería 200).

errorMessage

Cadena

Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph.

null

en caso de éxito.

datos

Mapa

Respuesta de NerdGraph:

{
  "data": {
    "serviceLevelDelete": {
      "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
      "name": "Checkout API availability"
    }
  }
}

Use selectors para extraer guid o name de data.

El siguiente ejemplo elimina un SLI mediante un GUID que se pasa como entrada del flujo de trabajo.

Ejemplo de flujo de trabajo
`name: newrelic_service_level_delete_workflow description: Delete an existing SLI/SLO steps: - name: retireSlo type: action action: newrelic.serviceLevel.delete version: 1 inputs: sliGuid: ${{ .workflowInputs.sliGuid }} next: end`

Ejemplo de flujo de trabajo

name: newrelic_service_level_delete_workflow
description: Delete an existing SLI/SLO
steps:
  - name: retireSlo
    type: action
    action: newrelic.serviceLevel.delete
    version: 1
    inputs:
      sliGuid: ${{ .workflowInputs.sliGuid }}
    next: end

Listar nivel de servicio

El identificador de la acción es newrelic.serviceLevel.list.

Enumera las entidades de indicador de nivel de servicio, opcionalmente limitadas a una cuenta o estado de cumplimiento. Usa newrelic.nerdgraph.execute.

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	Opcional. Limitar los resultados a una cuenta de New Relic. Si se omite, devuelve los SLI de todas las cuentas a las que tiene acceso el solicitante.	`11933347`
onlyNonCompliant	Booleano	Opcional. Filtro de estado de cumplimiento. Cuando `true` , restringe los resultados a los SLI con la etiqueta `Non-compliant` o `At risk` —equivalente a la opción "Show only at risk and non-compliant" de la UI de administración a nivel de servicio. Tanto `false` como la omisión de este campo devuelven todos los SLI independientemente del estado de cumplimiento.	`true`
filtro	Cadena	Opcional. Cláusula de filtro `entitySearch` adicional sin procesar anexada a la consulta.	`"name LIKE '%checkout%'"`
limit	En t	Opcional. Tamaño de página para los resultados.	`50`
cursor	Cadena	Opcional. Token de paginación de la salida `nextCursor` de una llamada anterior. Déjelo en blanco en la primera llamada.	`"oWUNlXQ65ke3hEVGplVS1UOWJFRstmVTZFMVhj..."`
selectors	Lista	Opcional. Selectores JQ para extraer valores específicos de la respuesta. Utilice `.data.actor.entitySearch.results.entities` para obtener la lista de SLI y `.data.actor.entitySearch.results.nextCursor` para el token de paginación.	`selectors: - name: entities expression: ".data.actor.entitySearch.results.entities" - name: nextCursor expression: ".data.actor.entitySearch.results.nextCursor"`

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

Producción	Tipo	Descripción
success	Booleano	`true` / `false` , heredado de la llamada `newrelic.nerdgraph.execute` subyacente —cubre tanto los fallos de transporte como los errores de lógica empresarial de NerdGraph.
errorMessage	Cadena	Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph. `null` en caso de éxito.
datos	Mapa	Respuesta sin procesar de NerdGraph. Utilice `selectors` para extraer `entities`, `count` o `nextCursor` de `data`. `nextCursor` es `null` cuando no hay más páginas. `{ "data": { "actor": { "entitySearch": { "count": 2, "results": { "entities": [ { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } ], "nextCursor": null } } } } }`

Producción

Tipo

Descripción

success

Booleano

true

false

, heredado de la llamada

newrelic.nerdgraph.execute

subyacente —cubre tanto los fallos de transporte como los errores de lógica empresarial de NerdGraph.

errorMessage

Cadena

Mensaje de error en caso de falla, ya sea a nivel de transporte o un error de lógica de negocios de NerdGraph.

null

en caso de éxito.

datos

Mapa

Respuesta sin procesar de NerdGraph. Utilice selectors para extraer entities, count o nextCursor de data. nextCursor es null cuando no hay más páginas.

{
  "data": {
    "actor": {
      "entitySearch": {
        "count": 2,
        "results": {
          "entities": [
            {
              "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
              "name": "Checkout API availability"
            }
          ],
          "nextCursor": null
        }
      }
    }
  }
}

El siguiente ejemplo enumera todos los SLI no conformes de una cuenta y extrae la lista de entidades mediante selectors.

Ejemplo de flujo de trabajo
`name: newrelic_service_level_list_workflow description: List non-compliant SLIs for an account steps: - name: findNonCompliantSlis type: action action: newrelic.serviceLevel.list version: 1 inputs: accountId: ${{ .workflowInputs.accountId }} onlyNonCompliant: true limit: 50 selectors: - name: entities expression: ".data.actor.entitySearch.results.entities" next: end`

Ejemplo de flujo de trabajo

name: newrelic_service_level_list_workflow
description: List non-compliant SLIs for an account
steps:
  - name: findNonCompliantSlis
    type: action
    action: newrelic.serviceLevel.list
    version: 1
    inputs:
      accountId: ${{ .workflowInputs.accountId }}
      onlyNonCompliant: true
      limit: 50
      selectors:
        - name: entities
          expression: ".data.actor.entitySearch.results.entities"
    next: end

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

Acciones de nivel de servicio de New Relic

Requisitos previos.css-21sua1{background:none;border:none;width:0;padding:0;}

Crear un nivel de servicio

Actualizar un nivel de servicio

Eliminar un nivel de servicio

Listar nivel de servicio

Requisitos previos