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 agoCuando 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 agoSugerencia
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.