Se você tiver APM, poderá relatar dados de eventos personalizados. Você pode então consultar e visualizar seus dados no New Relic.
Considerações de dados
O agente do New Relic envia dados de eventos para o New Relic como parte do ciclo de coleta normal a cada cinco segundos para versões do agente que suportam streaming em tempo real.
O envio de muitos eventos pode aumentar a sobrecarga de memória do agente. A New Relic impõe um limite máximo de 833 eventos personalizados a cada 5 segundos. Além disso, postagens com tamanho superior a 1 MB (10 ^ 6 bytes) não serão registradas, independentemente do limite do evento personalizado.
Você também pode enviar eventos personalizados utilizando a API de eventos (sem necessidade de APM). Porém, esteja ciente de que eventos personalizados enviados com a API do agente não são compatíveis com o modo de alta segurança.
Para registrar um evento personalizado, siga os procedimentos do seu agente de idiomas da New Relic. Para adicionar um atributo personalizado ao evento APM, você deve primeiro habilitá-los para seu agente APM e depois fazer uma chamada de API para registrar o atributo. Siga os procedimentos de atributo personalizado específicos do agente.
Ao criar seu próprio evento personalizado e atributo, siga os requisitos de dados para:
Para adicionar um evento personalizado aos aplicativos monitorados pelo agente Go, use RecordCustomEvent. Você pode então adicionar um atributo personalizado para seu aplicativo Go.
A coleção de eventos personalizados está habilitada por padrão no agente Java versão 3.13.0 ou superior. Para enviar evento personalizado, ligue para recordCustomEvent. Por exemplo:
O primeiro argumento define o nome do seu tipo de evento, e o segundo argumento é um mapa com o atributo do seu evento personalizado. O atributo do evento deve ser strings ou números. Certifique-se de limitar o número de nomes de tipos de eventos exclusivos criados e de não gerar esses nomes dinamicamente. Para restrições sobre nomes de tipos de eventos, consulte nossa documentação sobre limites e caracteres restritos e palavras reservadas NRQL.
Você pode alterar o número máximo de eventos registrados pelo agente Java por meio de um parâmetro de configuração em newrelic.yml.
Especifique o número máximo de eventos a serem registrados por minuto como um número inteiro. Por exemplo, se você deseja enviar menos que o padrão de 10.000 eventos:
custom_insights_events:
max_samples_stored:5000
Para desativar totalmente o evento personalizado, adicione o seguinte ao seu newrelic.yml:
Para versões do agente Java anteriores a 4.1.0, use a seguinte configuração YAML:
custom_insights_events.enabled:true
custom_insights_events.max_samples_stored:5000
A coleção de eventos personalizados está habilitada por padrão no agente .NET versão 4.6.29.0 ou superior. Para enviar evento personalizado basta ligar para RecordCustomEvent(). Por exemplo:
var eventAttributes =newDictionary<String, Object>();
O primeiro argumento define o nome do seu tipo de evento e o segundo argumento é um IEnumerable com o atributo do seu evento personalizado. Certifique-se de limitar o número de nomes de tipos de eventos exclusivos criados e de não gerar esses nomes dinamicamente. Para restrições sobre nomes de tipos de eventos, consulte nossa documentação sobre limites e caracteres restritos e palavras reservadas NRQL.
Você pode desativar totalmente o evento personalizado definindo customEvents.enabled como false em newrelic.config.
A coleção de eventos personalizados é habilitada por padrão no agente Node.js versão 1.15.0 ou superior. Para enviar evento personalizado, basta chamar a API relevante. Por exemplo:
recordCustomEvent(eventType, attributes)
Use recordCustomEvent() para registrar uma métrica baseada em evento, geralmente associada a uma duração específica. O eventType deve ser uma sequência alfanumérica com menos de 255 caracteres. O atributo deve ser objeto de pares chave e valor. As chaves devem ter menos de 255 caracteres e os valores devem ser string, número ou booleano. Para restrições sobre nomes de tipos de eventos, consulte nossa documentação sobre limites e caracteres restritos e palavras reservadas NRQL.
Para desabilitar totalmente o evento personalizado, adicione custom_insights_events.enabled: false a newrelic.js.
A coleção de eventos personalizados está habilitada por padrão no agente PHP versão 4.18 ou superior. Para enviar um evento personalizado, basta chamar a função API relevante. Por exemplo:
O primeiro argumento define o nome do seu tipo de evento, e o segundo argumento é um array com o atributo do seu evento customizado. Certifique-se de limitar o número de nomes de tipos de eventos exclusivos criados e de não gerar esses nomes dinamicamente. Para restrições sobre nomes de tipos de eventos, consulte nossa documentação sobre limites e caracteres restritos e palavras reservadas NRQL.
Por padrão, o número máximo de eventos personalizados registrados por minuto é 10.000. Esta configuração não pode ser alterada.
Para desabilitar totalmente o evento personalizado, adicione newrelic.custom_insights_events.enabled = false ao seu newrelic.ini e reinicie o agente.
A coleção de eventos personalizados está habilitada por padrão no agente Python versão 2.60.0.46 ou superior. Para enviar evento personalizado, basta chamar a API relevante. Por exemplo:
O event_type define o nome (ou tipo) do evento personalizado. atributo do evento personalizado deve ser passado como um dicionário por meio do argumento de palavra-chave params . Certifique-se de limitar o número de nomes de tipos de eventos exclusivos criados e de não gerar esses nomes dinamicamente. Para limites e restrições em event_type e params, consulte nossa documentação sobre limites e caracteres restritos e palavras reservadas
Se chamada fora do contexto de uma solicitação da Web de monitoramento ou de uma tarefa em segundo plano, a chamada será ignorada, a menos que o argumento da palavra-chave application seja fornecido e um objeto de aplicativo correspondente ao aplicativo no qual a exceção deve ser registrada seja fornecido. Um objeto de aplicativo adequado pode ser obtido usando a função newrelic.agent.application() .
Para desativar completamente o evento personalizado, defina custom_insights_events.enabled como False no arquivo de configuração newrelic.ini .
A coleção de eventos personalizados está habilitada por padrão no agente Ruby versão 3.9.8.273 ou superior. Para enviar evento personalizado, basta chamar a API relevante. Por exemplo:
O primeiro argumento define o nome do seu tipo de evento, e o segundo argumento é um hash aplicar com o atributo do seu evento personalizado. Certifique-se de limitar o número de nomes de tipos de eventos exclusivos criados e de não gerar esses nomes dinamicamente. Para restrições sobre nomes de tipos de eventos, consulte nossa documentação sobre limites e caracteres restritos e palavras reservadas NRQL.
Você pode alterar o número máximo de eventos registrados pelo agente Ruby por meio de um parâmetro de configuração em newrelic.yml:
Especifique o número máximo de eventos a serem registrados por minuto como um número inteiro. Por exemplo, se você deseja enviar até 5.000 eventos por minuto, adicione:
Para desabilitar totalmente o evento personalizado, adicione custom_insights_events.enabled: false a newrelic.yml.
Carimbo de data/hora
Você não pode especificar um timestamp em eventos coletados e registrados por meio do agente. O agente atribuirá automaticamente um timestamp ao evento com base em quando eles foram registrados por meio da API.