Tutoriel NerdGraph : afficher et ajouter une balise

Vous pouvez utiliser notre APINerdGraph pour ajouter des balises à vos données afin d'améliorer l'organisation et la recherche des données.

Présentation

Ce document explique comment utiliser notre API NerdGraph pour ajouter et gérer des balises. Notez qu'il ne s'agit que d'une façon d'ajouter une balise. Pour d’autres méthodes, voir Comment les balises sont ajoutées. Pour savoir comment automatiser le balisage à l'aide de notre outil CLI, consultez le site de nos développeurs.

Lire l'étiquette d'une entité

Pour construire ces requêtes et voir les réponses :

1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
2. Utilisez entitySearch() pour trouver l’entité, puis récupérez sa balise.
3. Utilisez de NerdGraph tag API pour lire la balise existante et ses valeurs.

Dans cet exemple, notre entité est une application de navigateur appelée Cookie Checkout:

{
  actor {
    entitySearch(query: "name like 'Cookie Checkout'") {
      results {
        entities {
          tags {
            key
            values
          }
        }
      }
    }
  }
}

Les valeurs réelles varient en fonction de vos données. Utilisez l'explorateurNew Relic GraphiQL pour expérimenter les requêtes.

Ajouter une balise pour une entité

Pour ajouter une nouvelle balise pour une entité :

1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
2. Utilisez entitySearch() pour localiser le GUID de l’entité que vous souhaitez tag.
3. Utilisez la mutation taggingAddTagsToEntity pour ajouter une tag avec une valeur à l'entité.
4. Pour APMagent, un redémarrage est nécessaire après l'ajout d'une nouvelle tag.

Dans cet exemple, nous avons une application de navigateur appelée Cookie Checkout appartenant à une équipe UI . Nous souhaitons ajouter une tag team avec une valeur ui à cette instance. Une fois la tag ajoutée, nous pouvons filtrer par la tag team:ui et trouver Cookie Checkout l'application dans l'UI de New Relic.

mutation {
  taggingAddTagsToEntity(
    guid: "ENTITY_GUID"
    tags: { key: "team", values: ["ui"] }
  ) {
    errors {
      message
    }
  }
}

Supprimer une tag d'une entité

Pour supprimer une tag et toutes ses valeurs associées d'une entité :

1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
2. Utilisez entitySearch() pour localiser le GUID de l’entité avec la tag que vous souhaitez supprimer.
3. Utilisez la mutation taggingDeleteTagFromEntity .
4. Pour l'agent APM, un redémarrage est nécessaire après le changement de balise.

L'exemple de mutation suivant supprime la tag team d'une entité :

mutation {
  taggingDeleteTagFromEntity(guid: "ENTITY_GUID", tagKeys: ["team"]) {
    errors {
      message
    }
  }
}

Supprimer des valeurs tag spécifiques pour une entité

Au lieu de supprimer une tag entière et toutes ses valeurs, vous pouvez supprimer une seule valeur tag .

1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
2. Utilisez entitySearch() pour localiser le GUID de l’entité avec la tag que vous souhaitez supprimer.
3. Utilisez la mutation taggingDeleteTagValuesFromEntity .

L'exemple de mutation suivant supprime la valeur ui de la clé tag :

mutation {
  taggingDeleteTagValuesFromEntity(
    guid: "ENTITY_GUID"
    tagValues: [{ key: "team", value: "ui" }]
  ) {
    errors {
      message
    }
  }
}

Parce que tagValues est un éventail, vous pouvez supprimer plusieurs valeurs spécifiques d’une seule entité en une seule mutation.

Remplacer toutes les valeurs tag pour une entité

Pour remplacer l'ensemble des balises de l'entité par l'ensemble tag fourni :

1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
2. Utilisez entitySearch() pour localiser le GUID de l’entité avec la tag que vous souhaitez supprimer.
3. Utilisez la mutation taggingReplaceTagsOnEntity .

Dans cet exemple, l'application de navigateur Cookie Checkout a été transférée de l'équipe ui à l'équipe cookie-dev . Vous pouvez remplacer les valeurs tag pour team par la mutation suivante :

mutation {
  taggingReplaceTagsOnEntity(
    guid: "ENTITY_GUID"
    tags: { key: "team", values: ["cookie-dev"] }
  ) {
    errors {
      message
    }
  }
}