• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Crie e gerencie macros NRQL

|View as Markdown (English)

Antes de criar uma macro, verifique as permissões de macro e as regras de nomenclatura e expressão abaixo. Uma macro que não segue essas regras falha na validação quando você tenta salvá-la.

Regras e limitações de macros

Importante

As macros são visíveis para todos os usuários na sua organização. Não devem ser incluídas informações confidenciais ou específicas da conta ao criar ou atualizar uma macro.

Macros de acesso

Na plataforma New Relic, vá para Administration > NRQL Macros. A partir desta página, você pode visualizar, criar, editar e excluir macros.

Criar uma macro

A partir da página NRQL Macros, crie uma macro fornecendo um nome exclusivo e uma expressão. Siga as regras de nomenclatura e de expressão. Não adicione o caractere $ como prefixo do nome. Por exemplo, para salvar uma condição de cláusula WHERE, insira appName = 'ProductionApp' AND environment = 'prod' sem a palavra-chave WHERE.

Depois de criar uma macro, ela aparece na lista NRQL Macros. Você pode usá-la em qualquer consulta NRQL em todo o New Relic.

Você também pode criar, atualizar e consultar macros de forma programática usando a API NerdGraph. Antes de criar ou atualizar macros, revise as regras de nomenclatura, as regras de expressão e as limitações.

Para começar, acesse o NerdGraph API explorer. Se você precisar de ajuda para usar o NerdGraph API explorer, consulte o tutorial do NerdGraph API explorer.

Use a mutação entityManagementCreateNrqlMacro:

mutation CreateMacro($name: String!, $expression: String!, $orgId: ID!) {
entityManagementCreateNrqlMacro(
nrqlMacroEntity: {
expression: $expression
name: $name
scope: { type: ORGANIZATION, id: $orgId }
}
) {
entity {
id
name
expression
}
}
}

Variáveis de exemplo:

{
"name": "prod_filter",
"expression": "(appName = 'ProductionApp' AND environment = 'prod')",
"orgId": "your-organization-id"
}

Para encontrar o ID da sua organização, consulte Encontrar o ID da sua organização ou macro.

Usar uma macro em uma consulta

Para usar uma macro em suas consultas NRQL, digite $ seguido pelo nome da macro no criador de consulta. Por exemplo, suponha que você tenha uma macro chamada prod_filter com a expressão appName = 'ProductionApp' AND environment = 'prod'. Você pode usá-la em uma consulta como esta:

SELECT count(*) FROM Transaction WHERE $prod_filter SINCE 1 hour ago

Quando a consulta é executada, a New Relic substitui a macro por sua expressão:

SELECT count(*) FROM Transaction WHERE appName = 'ProductionApp' AND environment = 'prod' SINCE 1 hour ago

Dica

Coloque os nomes de macros que contêm caracteres especiais entre crases no momento da consulta. Por exemplo: $`my#Macro`.

Importante

As macros são embutidas antes da execução, o que afeta a precedência de operadores binários. Por exemplo, uma macro chamada five definida como 1 + 4 e usada como $five * 3 é avaliada como 13, não 15, porque a expressão se torna 1 + 4 * 3. Para evitar isso, coloque a expressão entre parênteses ao definir a macro, como em (1 + 4), ou coloque a macro entre parênteses ao usá-la, como em ($five) * 3. Qualquer uma das abordagens é avaliada corretamente como 15.

Os exemplos a seguir mostram macros resolvendo problemas comuns de consulta:

Gerenciar macros

Editar uma macro

Na página NRQL Macros, selecione a macro e atualize sua expressão, seguindo as regras de expressão.

Você também pode atualizar a expressão de uma macro de forma programática usando o NerdGraph. Revise as regras de expressão antes de atualizá-la.

Use a mutação entityManagementUpdateNrqlMacro .

mutation UpdateMacro($expression: String!, $macroId: ID!) {
entityManagementUpdateNrqlMacro(
id: $macroId
nrqlMacroEntity: { expression: $expression }
) {
entity {
id
name
expression
}
}
}

Variáveis de exemplo:

{
"expression": "(appName = 'ProductionApp' AND environment = 'prod' AND region = 'us-east-1')",
"macroId": "your-macro-id"
}

Para encontrar o ID de uma macro, consulte Encontrar o ID da sua organização ou macro.

Importante

Quando você edita uma macro, todas as consultas que usam essa macro utilizam automaticamente a versão atualizada. Revise suas alterações para garantir que elas não quebrem as consultas existentes. Devido ao cache, pode haver um pequeno atraso antes que a atualização entre em vigor. Não é possível atualizar o nome de uma macro após a criação. Se você precisar alterar o nome, exclua a macro e crie uma nova.

Encontre o ID da sua organização ou macro

Tópicos relacionados

Macros NRQL

Saiba o que são as macros NRQL, o que você pode fazer com elas e quem pode usá-las.

Referência NRQL

Explore a sintaxe, as cláusulas e as funções do NRQL.

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.