Tutorial do NerdGraph: visualizar e adicionar tag

Você pode usar nossa API NerdGraph para adicionar tags 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, consulte Como as tags são adicionadas. Para saber como automatizar tags usando nossa ferramenta CLI, consulte nosso site de desenvolvedores.

Ler tag para uma entidade

Para construir essas consultas e ver as respostas:

1. Vá para o explorador NerdGraph GraphiQL em api.newrelic.com/graphiql.
2. Use entitySearch() 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 chamado Cookie Checkout:

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

Os valores reais variam dependendo dos seus dados. Use o explorador 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 em api.newrelic.com/graphiql.
2. Use entitySearch() para localizar o GUID da entidade que você deseja tag.
3. Use a mutação taggingAddTagsToEntity para adicionar uma tag com um valor à entidade.
4. Para o agente APM, é necessário reiniciar após adicionar uma nova tag.

Neste exemplo, temos um aplicativo de browser chamado Cookie Checkout de propriedade de uma equipe de interface. Queremos adicionar uma tag team com um valor ui a esta instância. Depois que a tag for adicionada, podemos filtrar pela tag team:ui e encontrar o aplicativo Cookie 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 em api.newrelic.com/graphiql.
2. Use entitySearch() para localizar o GUID da entidade com a tag que você deseja remover.
3. Use a mutação taggingDeleteTagFromEntity .
4. Para o agente APM, é necessário reiniciar após alterar a tag.

O exemplo de mutação a seguir remove a tag team 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 em api.newrelic.com/graphiql.
2. Use entitySearch() para localizar o GUID da entidade com a tag que você deseja remover.
3. Use a mutação taggingDeleteTagValuesFromEntity .

O exemplo de mutação a seguir exclui o valor ui da chave tag :

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

Como tagValues é 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 em api.newrelic.com/graphiql.
2. Use entitySearch() para localizar o GUID da entidade com a tag que você deseja remover.
3. Use a mutação taggingReplaceTagsOnEntity .

Neste exemplo, o aplicativo browser Cookie Checkout foi transferido da equipe ui para a equipe cookie-dev . Você pode substituir os valores de tag de team pela seguinte mutação:

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