• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Crear y administrar macros de NRQL

|View as Markdown (English)

Antes de crear una macro, revise los permisos de macro y las reglas de nomenclatura y expresión a continuación. Una macro que no sigue estas reglas no supera la validación al intentar guardarla.

Reglas y limitaciones de las macros

Importante

Las macros son visibles para todos los usuarios de la organización. No incluya información confidencial o específica de la cuenta al crear o actualizar una macro.

Acceso a macros

En la plataforma de New Relic, vaya a Administration > NRQL Macros. Desde esta página, puede ver, crear, editar y eliminar macros.

Crear una macro

Desde la página NRQL Macros, cree una macro proporcionando un nombre único y una expresión. Siga las reglas de nomenclatura y de expresión. No anteponga el carácter $ al nombre. Por ejemplo, para guardar una condición de cláusula WHERE, ingrese appName = 'ProductionApp' AND environment = 'prod' sin la palabra clave WHERE.

Después de crear una macro, esta aparece en la lista NRQL Macros. Puede usarla en cualquier consulta NRQL en todo New Relic.

También puede crear, actualizar y consultar macros de forma programática mediante la API de NerdGraph. Antes de crear o actualizar macros, revise las reglas de nomenclatura, las reglas de expresión y las limitaciones.

Para comenzar, vaya al explorador de la API de NerdGraph. Si necesita ayuda para usar el explorador de la API de NerdGraph, consulte el tutorial del explorador de la API de NerdGraph.

Use la mutación entityManagementCreateNrqlMacro:

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

Variables de ejemplo:

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

Para encontrar el ID de la organización, consulte Buscar el ID de la organización o de la macro.

Usar una macro en una consulta

Para usar una macro en las consultas NRQL, escriba $ seguido del nombre de la macro en el generador de consultas. Por ejemplo, suponga que tiene una macro llamada prod_filter con la expresión appName = 'ProductionApp' AND environment = 'prod'. Puede usarla en una consulta como esta:

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

Cuando se ejecuta la consulta, New Relic reemplaza la macro por su expresión:

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

Sugerencia

Encierre los nombres de macro que contienen caracteres especiales entre acentos graves en el momento de la consulta. Por ejemplo: $`my#Macro`.

Importante

Las macros se insertan en línea antes de la ejecución, lo que afecta la precedencia de los operadores binarios. Por ejemplo, una macro llamada five definida como 1 + 4 y utilizada como $five * 3 se evalúa como 13, no como 15, porque la expresión se convierte en 1 + 4 * 3. Para evitar esto, encierre la expresión entre paréntesis al definir la macro, como en (1 + 4), o encierre la macro entre paréntesis al usarla, como en ($five) * 3. Cualquiera de los enfoques se evalúa correctamente como 15.

Los siguientes ejemplos muestran macros que resuelven problemas de consulta comunes:

Administrar macros

Editar una macro

Desde la página NRQL Macros, seleccione la macro y actualice la expresión, siguiendo las reglas de expresión.

También puede actualizar la expresión de una macro de forma programática mediante NerdGraph. Revise las reglas de expresión antes de actualizarla.

Utilice la mutación entityManagementUpdateNrqlMacro .

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

Variables de ejemplo:

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

Para encontrar el ID de una macro, consulte Encontrar el ID de la organización o de la macro.

Importante

Cuando edita una macro, todas las consultas que usan esa macro utilizan automáticamente la versión actualizada. Revise los cambios para asegurarse de que no rompan las consultas existentes. Debido al almacenamiento en caché, puede haber un ligero retraso antes de que la actualización surta efecto. No puede actualizar el nombre de una macro después de crearla. Si necesita cambiar el nombre, elimine la macro y cree una nueva.

Encontrar el ID de la organización o de la macro

Temas relacionados

Macros de NRQL

Aprenda qué son las macros de NRQL, qué puede hacer con ellas y quién puede usarlas.

Referencia NRQL

Explore la sintaxis, las cláusulas y las funciones de NRQL.

Copyright © 2026 New Relic Inc.

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