Como usuário do New Relic, é possível que você precise escrever consultas NRQL complexas repetidamente em vários dashboards. Lembrar e reescrever várias linhas de uma consulta todas as vezes é uma tarefa demorada e propensa a erros. Quando seus dados mudam e as consultas precisam ser ajustadas, você deve atualizar manualmente cada instância dessa consulta em toda a sua organização, o que se torna uma carga de manutenção significativa.
As macros do NRQL resolvem esse problema permitindo que você salve uma expressão do NRQL como um atalho nomeado e reutilizável. Você referencia uma macro em uma consulta com o símbolo $ seguido pelo seu nome, por exemplo $prod_filter, e a New Relic substitui a expressão salva antes que a consulta seja executada. Você pode usar macros no criador de consulta e no dashboards.
O que você pode fazer com as macros
Você pode usar macros NRQL para:
- Criar expressões reutilizáveis: converta uma expressão da sua consulta NRQL em uma macro com um nome descritivo, para que você não precise redigitar ou lembrar a expressão completa toda vez.
- Reutilize expressões em várias contas: as macros são entidades no nível da organização. Qualquer conta na sua organização pode usar uma macro sem redefini-la, e todos os usuários com a função apropriada podem acessar e usar todas as macros criadas dentro da organização.
- Atualizar consultas centralmente: quando você edita uma macro, todas as consultas que usam essa macro refletem a alteração automaticamente, sem que você precise encontrar e atualizar cada consulta individualmente.
Pré-requisitos
Para usar macros NRQL, você precisa:
- Acesso à conta: acesso a uma conta na organização onde você deseja usar macros. As macros são entidades no nível da organização, portanto, uma vez criadas, estão disponíveis em todas as contas da sua organização.
- Conhecimento de NRQL: conhecimento básico da sintaxe do NRQL, já que a expressão de uma macro é uma expressão NRQL.
Permissões de macro
Antes de criar ou usar macros, é importante entender como as permissões funcionam e quem tem acesso às suas macros.
organização associação
Cada macro é um recurso que pertence à organização na qual foi criada. Essa associação é permanente e não pode ser alterada. As macros não podem ser compartilhadas entre diferentes organizações. Se a organização for excluída, a macro também será excluída. Se um usuário mudar para uma organização diferente, ele não terá acesso às macros da sua organização anterior.
Modelo de permissões atual
As macros do New Relic usam funções integradas com recursos CRUD para controlar o acesso. O acesso à macro é restrito ao nível da organização, definido por um administrador.
Permissões em nível de organização
São concedidos por funções de sistema padrão na interface de administração do New Relic.
Função | Capacidades | O que permite |
|---|---|---|
Organization product admin ou Organization manager |
| Criar, ler, atualizar e excluir qualquer macro na organização |
Organization read only |
| Ler qualquer macro na organização |
Próximos passos
Para criar, usar ou gerenciar macros, consulte Criar e gerenciar macros.