Introdução ao evento personalizado e atributo

Uma das maneiras de reportar dados personalizados ao New Relic é usando evento personalizado e/ou atributo personalizado.

Requisitos

Para requisitos e práticas recomendadas de formatação de eventos e atributos, consulte nossos documentos sobre limites de dados e requisitos.

Evite limites de taxa

Relatar um grande número de eventos personalizados e/ou atributos pode causar degradação no desempenho da consulta. Também pode resultar na aproximação ou ultrapassagem dos limites da taxa de coleta de dados. Para um desempenho ideal, primeiro pense em quais dados você deseja analisar e depois crie apenas o evento e/ou atributo necessário para atender a esses objetivos específicos.

Esteja ciente dos seguintes requisitos de dados e assinatura para inserir e acessar dados personalizados:

• Certifique-se de seguir os limites e requisitos em relação aos tipos de dados de evento/atributo, sintaxe de nomenclatura e tamanho.
• A quantidade de dados aos quais você tem acesso ao longo do tempo depende da sua política de retenção de dados.

Exemplos de casos de uso

Duas soluções populares para relatar dados personalizados são relatar evento personalizado e atributo personalizado. Existem várias maneiras de fazer isso, dependendo da implementação e das ferramentas do New Relic, e entraremos em mais detalhes sobre isso posteriormente neste documento. Mas primeiro, aqui estão alguns casos de uso comuns que explicam por que você usaria evento personalizado ou atributo personalizado.

Casos de uso para atributo personalizado

Atributo personalizado são frequentemente usados para adicionar contexto comercial e operacional importante a um evento existente. Por exemplo, para New Relic monitoramento de browser, você pode criar um atributo personalizado para rastrear o nome de usuário associado a uma solicitação lenta ou com falha. Isso permitiria que você criasse gráficos de consulta e personalizados para analisar esses dados.

Atributo personalizado são uma boa opção quando você está usando uma solução New Relic (como APM, browser, monitoramento de mobile, infraestrutura e monitoramento sintético) e deseja decorar eventos existentes com seus próprios metadados.

Casos de uso para evento personalizado

Enquanto adicionar atributo personalizado adiciona metadados a um evento existente, um evento personalizado cria um tipo de evento totalmente novo. Crie um evento personalizado para definir, visualizar e receber alertas sobre dados adicionais, assim como faria com qualquer dado que fornecemos de nosso agente principal. evento personalizado pode ser inserido através de nossa API do agente ou diretamente através de nossa API de evento.

Evento data é um dos quatro principais tipos de dados da New Relic. Recomendamos a leitura dessa definição para entender o que queremos dizer com “evento” e por que esse tipo de dados é mais usado para relatar tipos específicos de atividades.

Os casos de uso para eventos personalizados variam amplamente. Basicamente são utilizados para qualquer tipo de atividade que uma organização considere importante e que ainda não esteja sendo monitorada. Por exemplo:

• Um evento pode representar uma atividade que envolve múltiplas ações, como um cliente comprando uma determinada combinação de produtos.
• Um evento pode registrar atividades de backup. Por exemplo, você pode configurar relatórios de eventos que representam backups de produção da instância SOLR em uma tabela de eventos, com um timestamp de data/hora de quando ocorreu, qual cluster e a duração.

Usar evento personalizado

Depois de criar um evento personalizado, você poderá usá-lo em uma consulta NRQL padrão da mesma forma que usaria qualquer outro evento.

SELECT *
FROM YourCustomEvent

Você também pode utilizar evento personalizado com a métrica e o explorador de eventos , encontrando seu evento personalizado na interface e selecionando-o para escrever sua consulta.

Enviar evento personalizado e atributo

Os métodos de envio de evento personalizado e atributo incluem:

Para outras opções de geração de relatórios de dados personalizados, consulte Dados personalizados.