Tutorial NerdGraph: Configurar nível de serviço

Consulte Criar e editar SLIs e SLOs para aprender os conceitos básicos da configuração de SLI e SLO, como a entidade à qual um SLI está associado. Além disso, você pode consultar essa documentação para encontrar exemplos dos indicadores mais comuns para APMserviços e monitoramento de browseraplicativo.

Veja a seguir um exemplo de chamada do NerdGraph que cria um SLI usando a consulta de mutação serviceLevelCreate :

mutation {
  serviceLevelCreate(
    entityGuid: "entityGuid"
    indicator: {
      name: "Latency below 0.25 seconds"
      description: "The proportion of valid requests that were served faster than 0.25s, which is considered to correspond to a good experience."
      events: {
        validEvents: { from: "Transaction", where: "entityGuid = 'entityGuid'" }
        goodEvents: {
          from: "Transaction"
          where: "entityGuid = 'entityGuid' and duration < 0.25"
        }
        accountId: accountId
      }
      objectives: {
        target: 99.5
        timeWindow: { rolling: { count: 7, unit: DAY } }
      }
    }
  ) {
    id
    description
  }
}

Ele contém estes campos:

• entityGuid: o GUID da entidade (por exemplo, serviço APM, aplicativo de browser, etc.) à qual você deseja relacionar este SLI. Na interface, você pode encontrar esse GUID na página da entidade, em See metadata and manage tags.

• description: Use descrições detalhadas, incluindo o limite selecionado que determina um bom evento.

  • Por exemplo, para um SLI de disponibilidade, inclua algo como “A proporção de solicitações válidas que foram atendidas sem erros”.
  • Ou, para um SLI de latência, inclua uma descrição como “A proporção de solicitações válidas que foram atendidas mais rápido que 0,25s, o que é considerado como correspondendo a uma boa experiência”.

• accountId: o ID da conta à qual pertence o serviço APMou aplicativo de browser, que contém os dados NRDB para os cálculos de SLI/SLO.

• badEvents.from, badEvents.where

  • A consulta NRQL que define evento inválido, SELECT count(*) FROM badEvents.from WHERE badEvents.where, requer estas cláusulas FROM e WHERE .
  • Se você definiu um SLI de evento válido e inválido, deixe o objeto goodEvents vazio.

• goodEvents.from, goodEvents.where

  • A consulta NRQL que define o evento bom, SELECT count(*) FROM goodEvents.from WHERE goodEvents.where, requer estas cláusulas FROM e WHERE .
  • Se você definiu um SLI de evento válido e bom, deixe o objeto badEvents vazio.

• validEvents.from, validEvents.where

  • Estas são as cláusulas FROM e WHERE para a consulta NRQL que define o evento válido, que resultará em SELECT count(*) FROM validEvents.from WHERE validEvents.where.

• name: um nome curto de categoria para seu SLI para ajudar a entender do que se trata o nível de serviço. Sugerimos incluir quaisquer parâmetros e filtros específicos envolvidos na definição do SLI. Exemplos:

  • Disponibilidade
  • Latência abaixo de 4 segundos
  • CLS para desktops abaixo de 0,1

• objectives: Uma matriz de objetivos (SLOs) para o SLI.

  • target: O destino do seu SLO, até 100,00. O campo suporta até 5 casas decimais.
    • Se o seu usuário estiver satisfeito com a experiência atual, defina a porcentagem de SLO para corresponder à baseline atual. Por exemplo, o percentil utilizado para determinar o evento bom do SLI.
  • timeWindow.rolling.count: A duração do período considerado para calcular o SLO. Os valores suportados são 1, 7, 14, 28 e 30.
  • timeWindow.rolling.unit: DAYé o valor suportado.

mutation {
  serviceLevelCreate(
    entityGuid: "entityGuid"
    indicator: {
      name: "Success request"
      description: "The proportion of success requests count is 99% that the total count"
      events: {
        validEvents: {
          select: { function: SUM, attribute: "http.request.status.%.count" }
          from: "Metric"
        }
        goodEvents: {
          select: { function: SUM, attribute: "http.request.status.2%.count" }
          from: "Metric"
        }
        accountId: accountId
      }
      objectives: {
        target: 99.5
        timeWindow: { rolling: { count: 7, unit: DAY } }
      }
    }
  ) {
    id
    description
  }
}

{
  actor {
    entity(guid: "entityGuid") {
      guid
      name
      serviceLevel {
        indicators {
          createdAt
          createdBy {
            email
          }
          description
          entityGuid
          id
          name
          objectives {
            target
            timeWindow {
              rolling {
                count
                unit
              }
            }
          }
        }
      }
    }
  }
}

mutation {
  serviceLevelUpdate(
    id: "indicators.id"
    indicator: {
      objectives: {
        target: 99.00
        timeWindow: { rolling: { count: 7, unit: DAY } }
      }
    }
  ) {
    id
  }
}