Ações de nível de serviço New Relic

Esta página fornece uma referência para todas as ações de nível de serviço do New Relic disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem criar, atualizar, excluir e listar indicadores de nível de serviço (SLI) e seus objetivos de nível de serviço (SLO) diretamente de um fluxo de trabalho — permitindo a integração automatizada de serviços, a correção de SLO e fluxos de trabalho de conformidade.

Pré-requisitos

Antes de usar as ações de nível de serviço da New Relic na automação de fluxo de trabalho, certifique-se de ter o seguinte:

Uma conta New Relic com as permissões apropriadas para gerenciar nível de serviço.

Criar um nível de serviço

O identificador da ação é newrelic.serviceLevel.create.

Cria um novo indicador de nível de serviço (SLI) com seus objetivos de nível de serviço (SLO) para uma entidade.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada	Tipo	Descrição	Exemplo
EntidadeGuia	Corda	Obrigatório. A entidade para a qual este SLI está definido.	`"MjXzMzQ2fEFQTXxBUFBMSUNBVElPTnwyMzU5MzAzOTU"`
nome	Corda	Obrigatório. Nome do SLI.	`"Checkout API availability"`
descrição	Corda	Opcional. Descrição do SLI.	`"Auto-provisioned on service onboarding"`
ID da conta	Interno	Obrigatório. A conta New Relic que possui o SLI.	`1234567`
validEventsFrom	Corda	Obrigatório. Tipo de evento do NRDB para o pool de eventos válidos.	`"Transaction"`
validEventsWhere	Corda	Opcional. Condição booleana NRQL para filtrar o pool de eventos válidos.	`"appName = 'checkout-api'"`
validEventsSelectFunction	Corda	Opcional. Função de agregação para o pool de eventos válidos. Um de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
validEventsSelectAttribute	Corda	Opcional. Atributo a ser agregado para o pool de eventos válidos. Obrigatório quando `validEventsSelectFunction` for `SUM` , `GET_FIELD` ou `GET_CDF_COUNT` .	`"duration"`
validEventsSelectThreshold	Float	Opcional. Valor limite para o pool de eventos válidos. Usado somente quando `validEventsSelectFunction` é `GET_CDF_COUNT` .	`500`
eventCategory	Corda	Obrigatório. Classificação do bucket de eventos de condição como eventos bons ou ruins. Um de `GOOD` , `BAD` .	`"GOOD"`
conditionEventsFrom	Corda	Obrigatório. Tipo de evento do NRDB para o bucket de eventos bons/ruins.	`"Transaction"`
conditionEventsWhere	Corda	Opcional. Condição booleana do NRQL para filtrar o bucket de evento bom/ruim.	`"appName = 'checkout-api' AND error IS FALSE"`
conditionEventsSelectFunction	Corda	Opcional. Função de agregação para o bucket de eventos bons/ruins. Um de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
conditionEventsSelectAttribute	Corda	Opcional. Atributo a ser agregado para o bucket bom/ruim. Obrigatório quando `conditionEventsSelectFunction` for `SUM` , `GET_FIELD` ou `GET_CDF_COUNT` .	`"duration"`
conditionEventsSelectThreshold	Float	Opcional. Valor limite para o bucket bom/ruim. Usado somente quando `conditionEventsSelectFunction` é `GET_CDF_COUNT` .	`500`
facets	Lista	Opcional. Atributos pelos quais agrupar os resultados do SLI.	`["appName"]`
destino	Float	Obrigatório. Destino de SLO como uma porcentagem.	`99.9`
windowDays	Interno	Obrigatório. Janela móvel em dias. Deve ser `1` , `7` ou `28` .	`28`
selectors	Lista	Opcional. Seletores JQ para extrair valores específicos da resposta. Use `.data.serviceLevelCreate.guid` para capturar o GUID do novo SLI para uso em etapas subsequentes.	`selectors: - name: sliGuid expression: ".data.serviceLevelCreate.guid"`

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída	Tipo	Descrição
success	Boleano	`true` / `false` , herdado da chamada `newrelic.nerdgraph.execute` subjacente — abrange tanto falhas de transporte quanto erros de lógica de negócios do NerdGraph.
errorMessage	Corda	Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph. `null` em caso de sucesso.
dados	Mapa	Resposta do NerdGraph: `{ "data": { "serviceLevelCreate": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } } }` Use `selectors` para extrair `guid` ou `name` de `data`.

Saída

Tipo

Descrição

success

Boleano

true

false

, herdado da chamada

newrelic.nerdgraph.execute

subjacente — abrange tanto falhas de transporte quanto erros de lógica de negócios do NerdGraph.

errorMessage

Corda

Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph.

null

em caso de sucesso.

dados

Mapa

Resposta do NerdGraph:

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

Use selectors para extrair guid ou name de data.

O exemplo a seguir cria um SLI/SLO e captura o GUID do novo SLI usando selectors para uso em uma etapa subsequente.

Exemplo de fluxo de trabalho
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

Exemplo de fluxo de trabalho

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

Atualizar um nível de serviço

O identificador da ação é newrelic.serviceLevel.update.

Atualiza a configuração de um Indicador de nível de serviço existente ou seus objetivos de nível de serviço. Usa newrelic.nerdgraph.execute.

Os campos name e description são individualmente opcionais — omitir qualquer um deles preserva o valor existente. Os campos target e windowDays são tudo ou nada: forneça ambos para alterar o destino do SLO ou omita ambos para manter o SLO existente inalterado.

Para a configuração de eventos (validEvents*, conditionEvents*, eventCategory, facets), omitir qualquer campo o remove em vez de preservá-lo. Para alterar um campo na seção de eventos, forneça novamente a definição completa de eventos atuais junto com a alteração.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada	Tipo	Descrição	Exemplo
sliGuid	Corda	Obrigatório. O GUID do SLI. Use a saída do seletor `sliGuid` de `newrelic.serviceLevel.create` .	`"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"`
nome	Corda	Opcional. Novo nome do SLI. A omissão preserva o nome existente.	`"Checkout API availability (v2)"`
descrição	Corda	Opcional. Nova descrição de SLI. A omissão preserva a descrição existente.	`"Tightened after Q3 reliability review"`
validEventsFrom	Corda	Opcional. Tipo de evento do NRDB para o pool de eventos válidos. Obrigatório se qualquer outro campo `validEvents` , `conditionEvents` ou `eventCategory` estiver definido.	`"Transaction"`
validEventsWhere	Corda	Opcional. Condição booleana NRQL para filtrar o pool de eventos válidos.	`"appName = 'checkout-api'"`
validEventsSelectFunction	Corda	Opcional. Função de agregação para o pool de eventos válidos. Um de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
validEventsSelectAttribute	Corda	Opcional. Atributo a ser agregado para o pool de eventos válidos. Obrigatório quando `validEventsSelectFunction` for `SUM` , `GET_FIELD` ou `GET_CDF_COUNT` .	`"duration"`
validEventsSelectThreshold	Float	Opcional. Valor limite para o pool de eventos válidos. Usado somente quando `validEventsSelectFunction` é `GET_CDF_COUNT` .	`500`
eventCategory	Corda	Opcional. Classificação do bucket de eventos de condição como eventos bons ou ruins. Um de `GOOD` , `BAD` . Obrigatório junto com `conditionEventsFrom` ao definir a configuração de eventos.	`"GOOD"`
conditionEventsFrom	Corda	Opcional. Tipo de evento do NRDB para o bucket de eventos bons/ruins.	`"Transaction"`
conditionEventsWhere	Corda	Opcional. Condição booleana do NRQL para filtrar o bucket de evento bom/ruim.	`"appName = 'checkout-api' AND error IS FALSE"`
conditionEventsSelectFunction	Corda	Opcional. Função de agregação para o bucket de eventos bons/ruins. Um de `COUNT` , `SUM` , `GET_FIELD` , `GET_CDF_COUNT` .	`"COUNT"`
conditionEventsSelectAttribute	Corda	Opcional. Atributo a ser agregado para o bucket bom/ruim. Obrigatório quando `conditionEventsSelectFunction` for `SUM` , `GET_FIELD` ou `GET_CDF_COUNT` .	`"duration"`
conditionEventsSelectThreshold	Float	Opcional. Valor limite para o bucket bom/ruim. Usado somente quando `conditionEventsSelectFunction` é `GET_CDF_COUNT` .	`500`
facets	Lista	Opcional. Atributos pelos quais agrupar os resultados do SLI.	`["appName"]`
destino	Float	Opcional. Novo destino de SLO como uma porcentagem. Tudo ou nada com `windowDays` : forneça ambos juntos ou omita ambos.	`99.95`
windowDays	Interno	Opcional. Janela móvel em dias. Deve ser `1` , `7` ou `28` quando definido. Tudo ou nada com `target` : forneça ambos juntos ou omita ambos.	`28`
selectors	Lista	Opcional. Seletores JQ para extrair valores específicos da resposta.	`selectors: - name: sliGuid expression: ".data.serviceLevelUpdate.guid"`

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída	Tipo	Descrição
success	Boleano	`true` / `false` , herdado da chamada `newrelic.nerdgraph.execute` subjacente — abrange tanto falhas de transporte quanto erros de lógica de negócios do NerdGraph.
errorMessage	Corda	Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph. `null` em caso de sucesso.
dados	Mapa	Resposta do NerdGraph: `{ "data": { "serviceLevelUpdate": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability (v2)" } } }` Use `selectors` para extrair `guid` ou `name` de `data`.

Saída

Tipo

Descrição

success

Boleano

true

false

, herdado da chamada

newrelic.nerdgraph.execute

subjacente — abrange tanto falhas de transporte quanto erros de lógica de negócios do NerdGraph.

errorMessage

Corda

Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph.

null

em caso de sucesso.

dados

Mapa

Resposta do NerdGraph:

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

Use selectors para extrair guid ou name de data.

O exemplo a seguir restringe o destino do SLO em um SLI existente usando o GUID capturado de uma etapa newrelic.serviceLevel.create anterior.

Exemplo de fluxo de trabalho
`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`

Exemplo de fluxo de trabalho

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

Excluir um nível de serviço

O identificador da ação é newrelic.serviceLevel.delete.

Remove um Indicador de nível de serviço (SLI) existente e seu Objetivo de nível de serviço (SLO). Usa newrelic.nerdgraph.execute.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada

Tipo

Descrição

Exemplo

sliGuid

Corda

Obrigatório.

O GUID do SLI. Use a saída do seletor

sliGuid

newrelic.serviceLevel.create

"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"

selectors

Lista

Opcional.

Seletores JQ para extrair valores específicos da resposta.

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

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída	Tipo	Descrição
success	Boleano	`true` / `false` , herdado da chamada `newrelic.nerdgraph.execute` subjacente — abrange tanto falhas de transporte (não 200, erro de rede) quanto erros de lógica de negócios do NerdGraph (matriz `errors` em uma resposta que, de outra forma, seria 200).
errorMessage	Corda	Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph. `null` em caso de sucesso.
dados	Mapa	Resposta do NerdGraph: `{ "data": { "serviceLevelDelete": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } } }` Use `selectors` para extrair `guid` ou `name` de `data`.

Saída

Tipo

Descrição

success

Boleano

true

false

, herdado da chamada

newrelic.nerdgraph.execute

subjacente — abrange tanto falhas de transporte (não 200, erro de rede) quanto erros de lógica de negócios do NerdGraph (matriz

errors

em uma resposta que, de outra forma, seria 200).

errorMessage

Corda

Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph.

null

em caso de sucesso.

dados

Mapa

Resposta do NerdGraph:

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

Use selectors para extrair guid ou name de data.

O exemplo a seguir exclui um SLI usando um GUID passado como uma entrada de fluxo de trabalho.

Exemplo de fluxo de trabalho
`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`

Exemplo de fluxo de trabalho

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 nível de serviço

O identificador da ação é newrelic.serviceLevel.list.

Lista entidades de Indicador de nível de serviço, opcionalmente com escopo para uma conta ou status de conformidade. Usa newrelic.nerdgraph.execute.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada	Tipo	Descrição	Exemplo
ID da conta	Interno	Opcional. Defina o escopo dos resultados para uma conta do New Relic. A omissão retorna SLIs em todas as contas acessíveis ao solicitante.	`11933347`
onlyNonCompliant	Boleano	Opcional. Filtro de status de conformidade. Quando `true` , restringe os resultados a SLIs com tag `Non-compliant` ou `At risk` — equivalente à alternância "Show only at risk and non-compliant" da interface de gerenciamento a nível de serviço. `false` e a omissão deste campo retornam todos os SLIs, independentemente do status de conformidade.	`true`
filtro	Corda	Opcional. Cláusula de filtro `entitySearch` bruta adicional anexada à consulta.	`"name LIKE '%checkout%'"`
limit	Interno	Opcional. Tamanho da página para os resultados.	`50`
cursor	Corda	Opcional. Token de paginação da saída `nextCursor` de uma chamada anterior. Deixe em branco na primeira chamada.	`"oWUNlXQ65ke3hEVGplVS1UOWJFRstmVTZFMVhj..."`
selectors	Lista	Opcional. Seletores JQ para extrair valores específicos da resposta. Use `.data.actor.entitySearch.results.entities` para obter a lista de SLIs e `.data.actor.entitySearch.results.nextCursor` para o token de paginação.	`selectors: - name: entities expression: ".data.actor.entitySearch.results.entities" - name: nextCursor expression: ".data.actor.entitySearch.results.nextCursor"`

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída	Tipo	Descrição
success	Boleano	`true` / `false` , herdado da chamada `newrelic.nerdgraph.execute` subjacente — abrange tanto falhas de transporte quanto erros de lógica de negócios do NerdGraph.
errorMessage	Corda	Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph. `null` em caso de sucesso.
dados	Mapa	Resposta bruta do NerdGraph. Use `selectors` para extrair `entities`, `count` ou `nextCursor` de `data`. `nextCursor` é `null` quando não há mais páginas. `{ "data": { "actor": { "entitySearch": { "count": 2, "results": { "entities": [ { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } ], "nextCursor": null } } } } }`

Saída

Tipo

Descrição

success

Boleano

true

false

, herdado da chamada

newrelic.nerdgraph.execute

subjacente — abrange tanto falhas de transporte quanto erros de lógica de negócios do NerdGraph.

errorMessage

Corda

Mensagem de erro em caso de falha, seja no nível de transporte ou um erro de lógica de negócios do NerdGraph.

null

em caso de sucesso.

dados

Mapa

Resposta bruta do NerdGraph. Use selectors para extrair entities, count ou nextCursor de data. nextCursor é null quando não há mais páginas.

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

O exemplo a seguir lista todos os SLIs não compatíveis para uma conta e extrai a lista de entidades usando selectors.

Exemplo de fluxo de trabalho
`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`

Exemplo de fluxo de trabalho

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

Esta tradução de máquina é fornecida para sua comodidade.

Ações de nível de serviço New Relic

Pré-requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Criar um nível de serviço

Atualizar um nível de serviço

Excluir um nível de serviço

Listar nível de serviço

Pré-requisitos