Tutoriel NerdGraph : gérer les règles de partition des données log

Vous pouvez utiliser NerdGraph sur api.newrelic.com/graphiql pour créer, interroger et gérer vos règles de partition de données pour les logs. NerdGraph est notre explorateur d'API au format GraphQL.

Schéma de règle de partition de données

Les champs de règle de partition de données disponibles incluent :

Champs	Description
`id`	Identifiant unique de la règle de partitionnement des données.
`targetDataPartition`	Le nom de la partition de données.
`description`	Une description de ce que représente cette règle de partition de données.
`matchingCriteria`	(obsolète) Les critères de correspondance pour cette règle de partition de données. Une fois la règle activée, les logs correspondants à ces critères sera acheminé vers la partition de données spécifiée. Ce champ est obsolète et sera éventuellement remplacé par le champ `nrql` pour permettre plus de flexibilité lors de la création de partitions de données. Si la règle est spécifiée avec une clause NRQL `WHERE` dans le champ `nrql` qui ne peut pas être analysée dans `matchingCriteria`, ce champ sera nul.
`nrql`	Les critères de correspondance pour cette règle de partition de données spécifiés à l'aide d'une clause NRQL `WHERE` . Une fois la règle activée, les logs correspondants à ces critères sera acheminé vers la partition de données spécifiée.
`retentionPolicy`	La politique de conservation des données de partition de données.
`createdAt`	La date et l'heure de création de la règle.
`createdBy`	L'utilisateur qui a créé la règle.
`updatedAt`	La date et l'heure de la dernière modification de la règle.
`updatedBy`	L'utilisateur qui a mis à jour la règle en dernier.
`enabled`	Que cette règle de partition de données soit activée ou non.
`deleted`	Que cette règle de partition de données ait été supprimée ou non. La suppression d’une règle de partition de données ne supprime pas les logs déjà acheminés.

Exemple de requête de règles de partitions de données

Cet exemple de demande d'API NerdGraph obtient toutes les règles de partition de données pour un compte donné. Dans cet exemple, seuls quelques champs sont demandés.

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

Créer des règles de partitions de données à l'aide d'une clause where NRQL

Cet exemple crée une nouvelle règle de partition de données. Avant de créer la règle, assurez-vous de consulter notre documentation sur l'organisation des données avec des partitions.

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
    }
  }
}

Créer des règles de partitions de données avec matchingCriteria (obsolète)

Cet exemple crée une nouvelle règle de partition de données. Avant de créer la règle, assurez-vous de consulter notre documentation sur l'organisation des données avec des partitions. Le champ matchingCriteria est obsolète au profit de nrql et sera éventuellement supprimé.

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
    }
  }
}

Mettre à jour les règles de partitions de données avec une clause where NRQL

Cet exemple met à jour la règle de partition de données avec l'ID donné "123". Les champs qui peuvent être mis à jour sont description, nrql et enabled. Ils sont tous facultatifs, vous n'avez donc besoin d'utiliser que ceux que vous souhaitez mettre à jour.

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
    }
  }
}

Mettre à jour les règles de partitions de données

Cet exemple met à jour la règle de partition de données avec l'ID donné "123". Les champs qui peuvent être mis à jour sont description, matchingCriteria et enabled. Ils sont tous facultatifs, vous n'avez donc besoin d'utiliser que ceux que vous souhaitez mettre à jour.

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
    }
  }
}

Supprimer les règles de partitions de données

Cet exemple supprime une règle de partition de données. La suppression d’une règle de partition de données ne supprime pas les données qui ont déjà été partitionnées. Ces données sont conservées pendant une période donnée définie par le champ retentionPolicy .

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