Variáveis em notebooks: crie runbooks dinâmicos e repetíveis

Com as variáveis de notebook, você pode configurar parâmetros dinâmicos que se propagam por várias consultas em blocos de consulta. Ao contrário das variáveis de template de dashboard, que filtram uma visualização estática, as variáveis de notebook atuam como parâmetros injetados que orientam a lógica subjacente de todo o seu documento.

Acesse one.newrelic.com > All capabilities > Notebooks.

Por que usar variáveis em notebooks?

As variáveis de notebook permitem criar experiências interativas, como:

• Runbooks parametrizados onde um engenheiro insere um hostName ou transactionId específico para gerar instantaneamente um relatório de integridade do sistema de destino.
• Modelos de post-mortem que podem ser atualizados com timestamps, regiões ou nomes de aplicativos específicos para analisar um incidente.
• Limites interativos onde os usuários podem ajustar variáveis como errorThreshold ou latencyTarget para ver como diferentes parâmetros afetam os dados visualizados.

Os principais benefícios incluem:

• Criando runbooks executáveis: as variáveis transformam seus notebooks de páginas estáticas em ferramentas interativas. Você pode criar fluxos de trabalho adaptáveis para investigações de eventos de alerta, análise de desempenho e colaboração em equipe.
• Padronização do compartilhamento de conhecimento: como um documento salvo, você pode compartilhar fluxos de trabalho analíticos com colegas. Os usuários não precisam reescrever consultas NRQL complexas — eles simplesmente mudam para um novo valor de variável a partir de suas variáveis predefinidas e executam o fluxo de trabalho.

Defina uma variável de notebook

Defina uma variável que você injetará em seus blocos de consulta NRQL para parametrizar a recuperação e as visualizações de dados.

Para definir uma variável:

1. A partir de um notebook aberto, localize a barra de variáveis na parte superior da interface.
2. Clique em + Add variable.
3. Configure o tipo de variável (por exemplo, entrada de texto, dropdown ou numérico) e forneça um valor padrão.

Regras de nomenclatura de variáveis

Ao nomear sua variável, tenha o seguinte em mente:

• O nome é a string exata que você usará em seus blocos de notebook, cercada por {{...}}. Por exemplo, se você nomear a variável como targetApp, você a referenciará em seus blocos de consulta como {{targetApp}}.
• Os nomes das variáveis diferenciam maiúsculas de minúsculas e devem ser exclusivos em um notebook.
• Escolha nomes descritivos que tornem seu runbook autoexplicativo para outros usuários (por exemplo, failingHost em vez de var1).

Use uma variável em um bloco de consulta

Uma vez definida, referencie sua variável em qualquer lugar em uma consulta NRQL usando a sintaxe {{variableName}}:

SELECT average(cpuPercent) FROM SystemSample WHERE hostname = {{failingHost}} TIMESERIES

SELECT latest(cpuPercent) FROM ProcessSample WHERE hostname = {{failingHost}} FACET processDisplayName

Quando você executa a consulta, o valor da variável que você definiu na barra de variáveis é substituído na consulta em tempo de execução. Alterar o valor da variável e executar novamente a consulta atualiza instantaneamente todos os blocos que fazem referência a essa variável.

Automatize a resposta a incidentes com runbooks

O aplicativo mais poderoso para variáveis de notebook é a criação de runbooks executáveis para resposta a incidentes. Ao combinar variáveis de notebook com os fluxos de trabalho doNew Relic , você pode automatizar a transferência entre o acionamento de um alerta e o início da investigação.

Estruturar seu runbook

Um runbook parametrizado bem estruturado geralmente segue este padrão:

Qual é o próximo?

• Comece a usar os notebooks para obter uma visão geral do recurso de notebooks
• Blocos no notebook para saber mais sobre blocos de consulta e texto
• API de armazenamento de blobs para notebooks para gerenciar notebooks de forma programática
• Variáveis de template: filtrar dashboards dinamicamente para o recurso de dashboard equivalente