Tutorial NerdGraph: Gerenciar regras de partição de dados de log

Você pode usar o NerdGraph em api.newrelic.com/graphiql para criar, consultar e gerenciar suas regras de partição de dados para logs. NerdGraph é nosso explorador de API no formato GraphQL.

Esquema de regra de partição de dados

Os campos de regras de partição de dados disponíveis incluem:

Campos	Descrição
`id`	Identificador exclusivo de regras de partição de dados.
`targetDataPartition`	O nome da partição de dados.
`description`	Uma descrição do que esta regra de partição de dados representa.
`matchingCriteria`	(obsoleto) Os critérios de correspondência para esta regra de partição de dados. Depois que a regra for habilitada, o log que corresponder a esses critérios será roteado para a partição de dados especificada. Este campo foi descontinuado e eventualmente será substituído pelo campo `nrql` para permitir mais flexibilidade ao criar partições de dados. Se a regra for especificada com uma cláusula NRQL `WHERE` no campo `nrql` que não pode ser analisada em `matchingCriteria`, esse campo será nulo.
`nrql`	Os critérios de correspondência para esta regra de partição de dados especificados usando uma cláusula NRQL `WHERE` . Depois que a regra for habilitada, o log que corresponder a esses critérios será roteado para a partição de dados especificada.
`retentionPolicy`	A política de retenção dos dados da partição de dados.
`createdAt`	A data e hora em que a regra foi criada.
`createdBy`	O usuário que criou a regra.
`updatedAt`	A data e hora em que a regra foi alterada pela última vez.
`updatedBy`	O usuário que atualizou a regra pela última vez.
`enabled`	Se esta regra de partição de dados está habilitada ou não.
`deleted`	Se esta regra de partição de dados foi excluída ou não. A exclusão de uma regra de partição de dados não exclui o log já roteado.

Exemplo de consulta de regras de partições de dados

Este exemplo de solicitação da API NerdGraph obtém todas as regras de partição de dados para uma determinada conta. Neste exemplo, apenas alguns campos são solicitados.

{
  actor {
    account(id: 123456) {
      logConfigurations {
        dataPartitionRules {
          id
          targetDataPartition
          description
          nrql
          matchingCriteria {
            attributeName
            matchingOperator
            matchingExpression
          }
        }
      }
    }
  }
}

Crie regras de partições de dados usando uma cláusula NRQL where

Este exemplo cria uma nova regra de partição de dados. Antes de criar a regra, revise nossa documentação sobre organização de dados com partições.

mutation {
  logConfigurationsCreateDataPartitionRule(
    accountId: 1123456
    rule: {
      targetDataPartition: "Log_aNewDataPartitionRule"
      description: "Example data partition rule"
      nrql: "attrbute = 'value'"
      retentionPolicy: STANDARD
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

Criar regras de partições de dados com matchingCriteria (obsoleto)

Este exemplo cria uma nova regra de partição de dados. Antes de criar a regra, revise nossa documentação sobre organização de dados com partições. O campo matchingCriteria foi descontinuado em favor de nrql e eventualmente será removido.

mutation {
  logConfigurationsCreateDataPartitionRule(
    accountId: 1123456
    rule: {
      targetDataPartition: "Log_aNewDataPartitionRule"
      description: "Example data partition rule"
      matchingCriteria: {
        attributeName: "attribute"
        matchingMethod: LIKE
        matchingExpression: "'%example%'"
      }
      retentionPolicy: STANDARD
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

Atualizar regras de partições de dados com uma cláusula NRQL where

Este exemplo atualiza a regra de partição de dados com o ID "123" fornecido. Os campos que podem ser atualizados são description, nrql e enabled. Todos eles são opcionais, então você só precisa usar aqueles que deseja atualizar.

mutation {
  logConfigurationsUpdateDataPartitionRule(
    accountId: 1123456
    rule: {
      id: "123"
      description: "Example data partition rule"
      nrql: "attribute LIKE '%example%'"
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

Atualizar regras de partições de dados

Este exemplo atualiza a regra de partição de dados com o ID "123" fornecido. Os campos que podem ser atualizados são description, matchingCriteria e enabled. Todos eles são opcionais, então você só precisa usar aqueles que deseja atualizar.

mutation {
  logConfigurationsUpdateDataPartitionRule(
    accountId: 1123456
    rule: {
      id: "123"
      description: "Example data partition rule"
      matchingCriteria: {
        attributeName: "attribute"
        matchingMethod: LIKE
        matchingExpression: "'%example%'"
      }
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

Excluir regras de partições de dados

Este exemplo exclui uma regra de partição de dados. A exclusão de uma regra de partição de dados não exclui dados que já foram particionados. Esses dados são retidos por um determinado período definido pelo campo retentionPolicy .

mutation {
  logConfigurationsDeleteDataPartitionRule(id: "1111", accountId: 123456) {
    errors {
      message
      type
    }
  }
}