Ao investigar questões complexas ou compartilhar insights com sua equipe, você frequentemente se vê alternando entre diferentes ferramentas, copiando consultas, fazendo capturas de tela e lutando para manter o contexto enquanto tenta construir uma narrativa completa a partir dos seus dados. Os dashboards tradicionais são ótimos para monitoramento, mas deixam a desejar quando você precisa documentar investigações, criar análises pós-incidente detalhadas ou construir um fluxo de trabalho analítico passo a passo.
Os notebooks resolvem esse problema ao fornecer uma maneira dinâmica e organizada de contar uma história completa com seus dados. São documentos estruturados e orientados por dados que permitem combinar consulta, visualizações e texto descritivo em um único recurso compartilhável, eliminando a necessidade de alternar entre várias ferramentas ou perder contexto importante durante a análise.
Casos de uso
Use notebooks para aprimorar seu fluxo de trabalho e transformar dados brutos em histórias acionáveis:
- Consulte, analise e visualize dados: consulte todos os seus dados de observabilidade (logs, métricas, eventos) e crie visualizações para obter uma melhor compreensão do desempenho do seu sistema.
- Crie post-mortems e documentos de eventos de alerta: Colabore com sua equipe para documentar investigações e criar um registro claro e reutilizável para post-mortems de eventos de alerta e análise de causa raiz.
- Crie fluxos de trabalho e manuais de procedimentos reutilizáveis: Crie e compartilhe guias passo a passo para análises complexas.
- Adicione contexto e narrativa: Use Markdown para adicionar facilmente títulos detalhados, notas e explicações às suas consultas e gráficos, transformando pontos de dados desconexos em uma história coesa.
Comece a usar cadernos.
Agora que você entende os conceitos básicos de cadernos, está pronto para começar a criar e gerenciar seus próprios cadernos.
Acesse os cadernos
Para acessar os cadernos:
- Acesse one.newrelic.com.
- Abra o console Query your data no menu lateral na parte inferior da página.
- Clique em Notebooks no cabeçalho "Criador de consulta" para ver uma lista de todos os cadernos criados pela sua organização.
Acesse os notebooks indo em Query your data > Notebooks
Blocos de caderno
Os blocos são as unidades de construção fundamentais de um caderno. São seções individuais que você adiciona para estruturar sua análise e narrativa.
Blocos de consulta
Use blocos de consulta para escrever consultasNRQL e visualizar os resultados. Todos os tipos de gráficos de consulta única e personalizações disponíveis no criador de consulta padrão são suportados em cadernos.
Blocos de texto
Use Markdown para adicionar texto formatado, títulos, contexto, explicações e texto descritivo para contar a história da sua investigação.
Ações de bloqueio
Cada bloco pode ser manipulado para organizar seu documento:
- Duplicate: crie uma cópia do bloco
- Delete: Remova o bloco do seu caderno
- Move Up/Down: reordene os blocos dentro do seu notebook
- Move to Top/Bottom: mova blocos rapidamente para o início ou fim
Permissões de notebooks
Antes de começar a criar cadernos, é importante entender como funcionam as permissões e quem terá acesso a eles.
organização associação
Cada caderno é um recurso que pertence à organização em que foi criado. Essa associação é permanente e não pode ser alterada. Os cadernos não podem ser partilhados entre diferentes organizações. Se a organização for excluída, o bloco de notas também será excluído. Se um usuário mudar para uma organização diferente, ele não terá acesso aos notebooks da organização anterior.
Modelo de permissões atual
O New Relic Notebooks usa funções personalizadas com recursos CRUD para controlar o acesso. Existem dois níveis de acesso: no nível da organização (definido por um administrador) e no nível do caderno (definido por caderno pelo seu criador).
Permissões em nível de organização
Estes são concedidos via funções personalizadas na interface de administração do New Relic.
Função | Capacidades | O que permite |
|---|---|---|
Acesso total |
| Criar, ler, editar e excluir qualquer caderno na organização |
Criador |
| Criar novos cadernos (apenas cadernos próprios) |
Funções no nível do caderno
Estas são atribuídas em um caderno específico, normalmente pelo criador do caderno.
Função | Permissão | O que permite |
|---|---|---|
Proprietário |
| Ler, editar, excluir e gerenciar permissões — atribuídas automaticamente ao criador |
Editor |
| Editar o notebook |
Leitor |
| Visualizar o notebook (somente leitura) |
Como funciona em conjunto
- Um administrador concede a um usuário a função de Creator no nível da organização — isso permite que ele crie cadernos.
- Quando um usuário cria um notebook, ele se torna automaticamente seu Owner.
- O proprietário pode então compartilhar o caderno com outras pessoas, concedendo-lhes as funções de Editor ou Reader naquele caderno específico.
- Usuários que precisam de acesso a todos os notebooks em toda a organização (por exemplo, administradores) recebem a função de Full access em vez disso.
Qual é o próximo?
Agora que você entende o básico sobre cadernos, você pode:
- Saiba mais sobre blocos no caderno
- Use variáveis em cadernos para criar runbooks dinâmicos e parametrizados
- Gerencie notebooks de forma programática com a API de armazenamento de blob para notebooks
Você também pode explorar recursos relacionados:
- Dashboards para a criação de visualizações de dados persistentes
- criador de consulta para criação de consulta individual
- Gráficos para entender as opções de visualização