Gerenciar ou desabilitar o logs contextualizados APM
Impacto do registro automático
Por padrão, nosso agente decora automaticamente seu log do aplicativo com metadados importantes New Relic e encaminha esses logs para New Relic. Para saber mais sobre como esse recurso funciona e quais versões do agente o possuem habilitado, consulte Logs contextualizados APM.
Damos a você a opção de gerenciar o encaminhamento de seu registro para New Relic em nível de conta. Isso pode ser útil pelos seguintes motivos:
Para cumprir as políticas da sua organização.
Por motivos de segurança e conformidade, você deseja controlar quais logs serão encaminhados.
Você deseja evitar custos desnecessários de ingestão de dados.
O design dos recursos do sistema não permite o aumento da sobrecarga da função de transferência de log.
Observe que se um agente APM tiver o modo de alta segurança habilitado, isso desabilitará o encaminhamento de log do aplicativo.
Opções para gerenciar configurações de registro automático
Você pode desativar (ou reativar) o encaminhamento automático de logs em toda a sua conta por meio da APM log interface de configurações ou da API. Você também pode ativar ou desativar a coleta log para um agente específico por meio da configuração do agente.
Importante
A configuração do lado do servidor para encaminhamento de logs de aplicativos é atualmente suportada apenas pelo agente Java (versão 8.19.0 ou posterior). Para mais informações, consulte Configuração do agente do lado do servidor.
Na interface Data management, a página da interface Log settings é onde você pode ativar ou desativar o logAPM (decoração log e encaminhamento de logs) para uma conta.
Para organizações com uma estrutura de conta pai/filho, o modo como isso funciona pode variar. Mais detalhes sobre as configurações da conta pai/filho estão abaixo.
Configurações da conta pai
No nível da conta pai, você pode optar por ativar ou desativar o encaminhamento de logs APM . Qualquer conta infantil que não tenha feito suas próprias alterações na configuração padrão (ativada) herdará automaticamente todas as alterações feitas na conta principal. As contas infantis que aplicaram suas próprias alterações não serão afetadas pelas alterações nas contas principais.
As contas pai também podem optar por bloquear ou desbloquear as configurações de encaminhamento de logs APM . O bloqueio força todas as contas filhas a herdarem a configuração ativada ou desativada da conta pai, independentemente de terem atualizado anteriormente sua própria configuração ativada ou desativada. O desbloqueio permite que contas infantis substituam a configuração ativada ou desativada da conta pai.
Configurações da conta infantil
No nível da conta filha, você pode ativar ou desativar o encaminhamento de logs, desde que a conta pai não tenha bloqueado essa configuração. Quando a conta pai bloqueia o encaminhamento de logs APM , uma conta filha herdará a configuração ativada ou desativada da conta pai e não poderá fazer alterações.
No menu do usuário na interface New Relic , clique em Manage your data > Log settings.
Clique no menu de reticências ... no lado direito da linha da conta.
Clique no botão de confirmação para ativar ou desativar e bloquear ou desbloquear o registro automático (contas principais) ou ativar ou desativar apenas (contas infantis).
Após a desativação por meio da interface New Relic , pode levar vários minutos para o agente reiniciar e interromper o encaminhamento automático de logs.
Use o dataManagementUpdateFeatureSettings no NerdGraph API Explorer: one.newrelic.com > All capabilities > Apps > NerdGraph API explorer. Consulte o exemplo preenchido e a documentação relacionada na interface GraphiQL.
Quando você desabilita ou habilita por meio da API NerdGraph, as alterações devem entrar em vigor imediatamente.
Query example:
{
actor{
account(id:YOUR_ACCOUNT_ID_){
dataManagement{
featureSettings{
enabled
key
name
locked
}
}
}
}
}
Mutation example:
Use esta mutação para atualizar cada conta individualmente.
mutation{
dataManagementUpdateFeatureSettings(
accountId:YOUR_ACCOUNT_ID
setting:{
enabled:false
locked:true
featureSetting:{key:"apm_log_forwarding"}
}
){
enabled
key
name
locked
}
}
Se desejar desabilitar o encaminhamento automático de logs para algum agente e habilitá-lo para outros, você pode ajustar as configurações de configuração do lado do cliente de cada agente. Em primeiro lugar, o agente nunca irá instrumentar os dados log ; em vez disso, eles removerão completamente o log. Você precisará usar a configuração do lado do cliente se precisar reduzir a sobrecarga.
As configurações de configuração do lado do cliente funcionam de forma totalmente independente da configuração no lado do servidor. A configuração para desabilitar o log automático tem precedência mesmo que a configuração no lado do servidor tenha precedência para o agente (como Ruby) em outras situações. Somente o agente que leu o arquivo de configuração alterado será impactado.
Importante
Observe que a desativação do encaminhamento de logs não afeta as métricas de registro, que são exibidas no gráfico Logs na página Summary do APM . Para mais detalhes, veja log métrica.
Para obter mais informações sobre as opções de configuração de encaminhamento de logs, consulte os procedimentos para um agente específico:
Se precisar de ajuda para atualizar várias contas (por exemplo, uma conta pai com várias contas filhas), entre em contato com seu representante de conta New Relic. Se você não tiver um representante de conta, obtenha suporte em support.newrelic.com.
Quando o encaminhamento automático de logs estiver desativado por meio de API ou interface, todos os agentes de idioma que podem enviar log por padrão terão o registro desativado a partir de agora para essa conta.
Desativar log significa que nenhum dado log será encaminhado; todos os outros aspectos da inspeção log permanecem os mesmos. Para desabilitar completamente todas as atividades relacionadas ao registro em log no agente, altere a configuração do lado do cliente do agente para desabilitar os logs.
Não haverá alteração na ingestão de dados, mas a ingestão de dados log diminuirá. Para obter mais informações sobre como gerenciar seus dados no New Relic, consulte nossa documentação de ingestão de dados.
