• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Encaminhe seu log usando o agente de infraestrutura

Encaminhar seus logs para o New Relic disponibiliza todos os seus dados de log em um único local, proporcionando uma visibilidade mais profunda dos dados de desempenho do seu aplicativo e da sua plataforma. Com seus logs em um só lugar, você pode coletar, processar, explorar, consultar e alertar sobre erros ou anomalias encontradas em seus dados log .

Screenshot of logs in context for a host

Na interface do seu host, seu log é colocado no contexto do evento para o período de tempo selecionado. Você pode detalhar dados detalhados para qualquer um dos atributos destacados.

A maneira como você encaminha seus logs depende de como você instalou o agente de infraestrutura, pois o agente de infraestrutura ativa o recurso de encaminhamento de logs. É possível instalar o agente de infraestrutura por meio de:

  • Instalação guiada (recomendada para a maioria dos usuários)
  • Instalação manual
  • Tarball do Linux

Importante

A versão Linux do agente de infraestrutura, especificamente a versão 1.42.0, passou do uso do pacote td-agente-bit para o pacote fluent-bit. Essa mudança foi necessária porque o fluente-bit não é mais distribuído no tipo td-agente-bit após a atualização da versão principal 2.x.

Para garantir operações tranquilas e fornecer a opção de reverter para td-agente-bit caso haja algum problema com o pacote fluent-bit, o agente de infraestrutura agora instala ambos os pacotes (td-agente-bit e fluent-bit). Por padrão, o agente está configurado para usar bit fluente.

Consulte Reverter para Fluent Bit 1.9 para obter mais informações sobre como reverter.

Dica

Tem muito registro? Confira nosso tutorial sobre como otimizá-los e gerenciá-los.

Requisito do sistema

Encaminhar log automaticamente com instalação guiada

Ao utilizar nossa instalação guiada para instalar o agente de infraestrutura, o recurso de encaminhamento de logé configurado automaticamente durante o processo de instalação.

Para iniciar sua instalação, escolha seu método de implantação:

Amazon Linux
Amazon Linux
Ansible
Ansible
CentOS
CentOS
Debian
Debian
Red Hat
RHEL
SLES
SLES
Ubuntu
Ubuntu
Windows
Windows

Importante

Para encaminhar log de um contêiner docker, use esta imagem docker como a imagem base a ser usada com a integração de log Kubernetes , ou você pode criar seu próprio contêiner com configuração personalizada para diferentes ambientes.

Habilitar encaminhamento de logs no agente instalado manualmente

Para instalar o agente de infraestrutura manualmente, siga nosso tutorial para instalar o gerenciador de pacote ou confira nosso instalador MSI (Windows).

Etapa 1. Configurar o agente de infraestrutura

Os arquivos de configuração direcionam seu sistema para encaminhar as fontes de log que você deseja que apareçam no New Relic. Você pode adicionar quantos arquivos de configuração desejar. Nosso agente de infraestrutura usa arquivos .yml para configurar a geração de registros. Caso você instale o agente de infraestrutura via integração & agente na interface, o arquivo logging.yml é criado automaticamente.

Para adicionar um novo arquivo de configuração para o recurso de encaminhamento de logs:

  1. Navegue até a pasta de configuração do direcionador de logs:

    • Linux: /etc/newrelic-infra/logging.d/
    • Windows: C:\Program Files\New Relic\newrelic-infra\logging.d\
  2. Crie um arquivo de configuração logging.yml e adicione o parâmetro necessário. O diretório logging.d possui vários arquivos .yml.example que você pode usar como referência ou ponto de partida. Para exemplos do Windows, consulte nosso repositório Github.

    # Log forwarder configuration file example
    # Source: file
    # Available customization parameters: attributes, max_line_kb, pattern
    logs:
    # Basic tailing of a single file
    - name: basic-file
    file: /var/log/logFile.log
    # File with spaces in its path. No need to use quotes.
    - name: file-with-spaces-in-path
    file: /var/log/folder with spaces/logFile.log
    # Specify a list of custom attributes, as key-value pairs, to be included
    # in each log record
    - name: file-with-attributes
    file: /var/log/logFile.log
    attributes:
    application: tomcat
    department: sales
    maintainer: example@mailprovider.com
    # Use wildcards to refer to multiple files having a common extension or
    # prefix. Newly generated files will be automatically detected every 60
    # seconds.
    #
    # WARNING: avoid using wildcards that include the file extension, since
    # it'll cause logs to be forwarded repeatedly if log rotation is enabled.
    - name: log-files-in-folder
    file: /var/log/logF*.log
    # Lines longer than 128 KB will be automatically skipped. Use 'max_line_kb'
    # to increase this limit.
    - name: log-file-with-long-lines
    file: /var/log/logFile.log
    max_line_kb: 256
    # Use 'pattern' to filter records using a regular expression
    - name: only-records-with-warn-and-error
    file: /var/log/logFile.log
    pattern: WARN|ERROR

O agente processa automaticamente novos arquivos de configuração sem precisar reiniciar o serviço de monitoramento de infraestrutura. A única exceção a isso é ao definir uma configuração personalizada do Fluent Bit.

Etapa 2. Definir parâmetro de encaminhamento de logs

É necessário configurar um name e um parâmetro de origem de log no arquivo de configuração de encaminhamento de logs .yml . Para começar, defina um name do log ou logs que você deseja encaminhar para o New Relic.

O que você usa para a origem do log depende do local de origem dos seus logs. As opções disponíveis para a origem de log incluem:

Passo 3. Definir atributo chave

Embora esses parâmetros de configuração não sejam obrigatórios, ainda recomendamos que você aplique essas configurações ao seu arquivo logging.yml para aproveitar ao máximo o encaminhamento de logs.

Exemplo de arquivo de configuração

Aqui está um exemplo de arquivo de configuração logging.d no formato YAML. Para obter mais exemplos de configuração, consulte o repositório do agente de infraestrutura.

Passo 4. Visualize seus dados log

Se tudo estiver configurado corretamente e seus dados estiverem sendo coletados, você deverá ver o log e os dados de telemetria relacionados nestes locais:

  • Nossa interface de registros
  • Na interface da infraestrutura, na tabela de hosts, clique no botão ícone para um host específico e clique em View logs.
  • Nossas ferramentas para executar a consulta NRQL. Por exemplo, você pode executar uma consulta como esta:
SELECT * FROM Log

Habilite o registro para sua integração no host

Com o agente de infraestrutura instalado, você pode ativar a análise automática de log e encaminhamento para nossa integração no host mais popular em uma única etapa. Para ativar esse recurso, renomeie o arquivo on-host-log.yml.example para on-host-log.yml. Uma vez feito isso, o log da sua integração será automaticamente analisado e enviado para a New Relic.

Esta opção está disponível para nossa plataforma Linux suportada.

Para ativar o recurso de encaminhamento de logs de integração no host:

Habilitar encaminhamento de logs no agente instalado usando tarball do Linux

Nosso processo personalizado de instalação do Linux para monitoramento de infraestrutura permite personalizar todos os aspectos do processo de instalação e colocar arquivos e pastas em sua máquina. Se você escolher o processo de instalação assistida ou manual do tarball, siga estas etapas para implementar o recurso de direcionar de logs:

  1. Crie os seguintes diretórios:

    • /var/db/newrelic-infra/newrelic-integrations/logging
    • /etc/newrelic-infra/logging.d
  2. Baixe e instale o pacote fluente-bit (RPM) do New Relic executando um comando semelhante a:

    bash
    $
    yum localinstall fluent-bit-<some-version>.rpm
  3. Baixe o plug-in fluentbit da New Relic e salve-o como /var/db/newrelic-infra/newrelic-integrations/logging/out_newrelic.so.

  4. Baixe ou copie o arquivo parsers.conf deste repositório Github e salve-o como /var/db/newrelic-infra/newrelic-integrations/logging/parsers.conf.

Este documento ajudou você na instalação?

Resolução de problemas

Se você encontrar problemas ao configurar seu direcionador de logs, tente estas dicas de resolução de problemas.

Qual é o próximo?

Explore os dados de registro em sua plataforma com nossa interface de registros.

Desativar encaminhamento de logs

Para desativar os recursos de encaminhamento de log , vá para o diretório logging.d e remova os arquivos com a extensão .yml que foram originalmente adicionados durante o processo de configuração .

  • Linux: /etc/newrelic-infra/logging.d/
  • Windows: C:\Program Files\New Relic\newrelic-infra\logging.d\
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.