Você pode usar nossaAPI NerdGraph para adicionartags aos seus dados para ajudar a melhorar a organização e localização dos dados.

Visão geral

Este documento explica como usar nossa API NerdGraph para adicionar e gerenciar tags. Observe que esta é apenas uma maneira de adicionar tag. Para outros métodos, consulteComo as tags são adicionadas. Para saber como automatizar tags usando nossa ferramenta CLI, consulte nossosite de desenvolvedores.

Ler tag para uma entidade

Para construir essas consultas e ver as respostas:

1. Vá para o explorador NerdGraph GraphiQL emapi.newrelic.com/graphiql.
2. UseentitySearch() para localizar a entidade e buscar sua tag.
3. Use a API tag do NerdGraph para ler a tag existente e seus valores.

Neste exemplo, nossa entidade é um aplicativo de browser chamadoCookie Checkout:

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

Os valores reais variam dependendo dos seus dados. Use oexplorador New Relic GraphiQL para experimentar a consulta.

Adicionar tag para uma entidade

Para adicionar uma nova tag para uma entidade:

1. Vá para o explorador NerdGraph GraphiQL emapi.newrelic.com/graphiql.
2. UseentitySearch() para localizar o GUID da entidade que você deseja tag.
3. Use a mutaçãotaggingAddTagsToEntity para adicionar uma tag com um valor à entidade.
4. Para o agenteAPM, é necessário reiniciar após adicionar uma nova tag.

Neste exemplo, temos um aplicativo de browser chamadoCookie Checkout de propriedade de uma equipe de interface. Queremos adicionar uma tagteam com um valorui a esta instância. Depois que a tag for adicionada, podemos filtrar pela tagteam:ui e encontrar o aplicativoCookie Checkout na interface do New Relic.

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

Remover uma tag de uma entidade

Para excluir uma tag e todos os seus valores associados de uma entidade:

1. Vá para o explorador NerdGraph GraphiQL emapi.newrelic.com/graphiql.
2. UseentitySearch() para localizar o GUID da entidade com a tag que você deseja remover.
3. Use a mutaçãotaggingDeleteTagFromEntity .
4. Para o agenteAPM, é necessário reiniciar após alterar a tag.

O exemplo de mutação a seguir remove a tagteam de uma entidade:

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

Excluir valores tag específicos para uma entidade

Em vez de excluir uma tag inteira e todos os seus valores, você pode excluir um único valor de tag.

1. Vá para o explorador NerdGraph GraphiQL emapi.newrelic.com/graphiql.
2. UseentitySearch() para localizar o GUID da entidade com a tag que você deseja remover.
3. Use a mutaçãotaggingDeleteTagValuesFromEntity .

O exemplo de mutação a seguir exclui o valorui da chavetag :

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

ComotagValues é uma matriz, é possível excluir vários valores específicos de uma única entidade em uma mutação.

Substitua todos os valores de tag de uma entidade

Para substituir todo o conjunto de tags da entidade pelo conjunto tag fornecido:

1. Vá para o explorador NerdGraph GraphiQL emapi.newrelic.com/graphiql.
2. UseentitySearch() para localizar o GUID da entidade com a tag que você deseja remover.
3. Use a mutaçãotaggingReplaceTagsOnEntity .

Neste exemplo, o aplicativo browserCookie Checkout foi transferido da equipeui para a equipecookie-dev . Você pode substituir os valores de tag deteam pela seguinte mutação:

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