Log pode representar log do aplicativo, evento gerado pela máquina ou log do sistema. OpenTelemetry definiu um modelo de dados de log para representar dados de log.
Você pode enviar log usando as ferramentas OpenTelemetry, correlacioná-los com o aplicativo e visualizá-los no New Relic.
Enviar registro para New Relic
O coletor OpenTelemetry e o repositório OpenTelemetry coletor Contrib contêm vários componentes para consumir dados de log. O padrão geral é configurar o coletor para:
- Receba logs de qualquer um dos receptores log . Algumas das opções de receptor incluem Filelog Receiver, Fluent Forward Receiver e Syslog Receiver.
- Log do processo, potencialmente anotando-os com informações de recursos. Algumas das opções de processador incluem Processador de Detecção de Recursos e Processador de Recursos.
- Exporte o log para o New Relic por meio do exportador OTLP.
Correlacione seu log do aplicativo
Log do aplicativo são mais úteis se estiverem correlacionados com outros dados de telemetria produzidos pelo aplicativo. A convenção semântica OpenTelemetry para serviços especifica service.name
como um campo obrigatório. Todos os dados métricos, trace e log do aplicativo enviados ao New Relic com o mesmo service.name
são associados à mesma entidade.
As especificidades de como o log é anotado com o atributo de recurso service.name
dependem do ambiente do aplicativo:
- O aplicativo pode produzir um log JSON estruturado, que você pode configurar para incluir
service.name
como outro campo. - Você pode implantar o aplicativo junto com uma instância de agente coletor dedicada, que pode ser configurada com um processador de recursos para anotar o log com o atributo
service.name
.
Opcionalmente, contexto de aplicação adicional do trace (às vezes chamado de contexto de execução) pode ser propagado para mensagem do log. A configuração e a disponibilidade dependem do idioma e framework de registro usada pelo aplicativo. A estratégia geral é configurar o aplicativo para escrever logs JSON estruturados e configurá-lo para extrair o contexto do trace em campos especificados do contexto do trace na mensagem do log disponível. Para obter mais detalhes, consulte OpenTelemetry na interface: página de log.
O exemplo de logs contextualizados with Log4j2 no GitHub demonstra um exemplo funcional de ponta a ponta para um aplicativo Java simples usando Log4j2.
Ver registro do OpenTelemetry
Aqui estão duas maneiras de visualizar o log:
- Veja nossa interface de logs.
- Se o seu log estiver correlacionado com um aplicativo, visualize-os no contexto do aplicativo.
O campo de tempo
O campo timeUnixNano
é opcional de acordo com a especificação OpenTelemetry para dados log . Quando timeUnixNano
não estiver presente, o New Relic usará a hora em que os dados foram recebidos para o timestamp dos Logs do New Relic.