O plugin Kubernetes da New Relic para encaminhamento de logs simplifica o envio de logs do seu cluster para New Relic Logs. Ele usa uma imagem docker independente e é executado como um DaemonSet, coletando logs perfeitamente para análise centralizada e resolução de problemas. Encaminhar seus registros do Kubernetes para o New Relic fornecerá recursos aprimorados para coletar, processar, explorar, consultar e alertar sobre seus dados log .
Habilite o Kubernetes para gerenciamento de logs
Para encaminhar seu log do Kubernetes para o New Relic com nosso plug-in:
Instale a integração do New Relic Kubernetes seguindo as etapas desta página. Esta integração inclui o plug-in Kubernetes para log.
Opcionalmente, você pode ajustar ainda mais sua instalação na Etapa 4 da instalação guiada usando as inúmeras opções de configuração disponíveis no repositório newrelic-logging. Porém, recomendamos a configuração padrão, pois é válida para a maioria dos usuários.
Importante
Se você estiver usando um segredo Kubernetes para armazenar a chave de licença New Relic , o gráfico
newrelic-logging
usará como padrão o envio de log para os endpoints da API dos EUA. Se a chave de licença pertencer a uma conta UE ou FedRAMP e um segredo for usado para armazenamento de chaves, você deverá atualizar a configuração do endpoint com o valor apropriado nos documentos de referência da API. Aqui está um exemplo de como definir isso para contas da UE:newrelic-logging:enabled: trueendpoint: https://log-api.eu.newrelic.com/log/v1Gere algum tráfego e aguarde alguns minutos e, em seguida, verifique os dados da sua conta .
Este documento ajudou você na instalação?
Instale o plug-in de saída Fluent Bit
New Relic possui um plug-in de saída Fluent Bit para encaminhar seu log para New Relic o gerenciamento de log . Este plug-in também é fornecido em uma imagem docker independente que pode ser instalada em um cluster do Kubernetes na forma de um DaemonSet, também conhecido como plug-in Kubernetes .
Você pode instalá-lo em seu cluster usando nosso gráfico Helm de duas maneiras.
Use nossa instalação guiada
Embora o gráfico newrelic-logging funcione de forma independente, recomendamos instalá-lo como parte do gráfico nri-bundle .
A melhor maneira de instalar isso é através do nosso processo de instalação guiado . Esta instalação guiada pode gerar os comandos do Helm 3 necessários para instalá-lo (consulte "Helm 3").
Instalação manual
Como alternativa, você pode instalá-lo manualmente usando o Helm, executando este comando para instalar o repositório:
$helm repo add newrelic https://helm-charts.newrelic.com
Para atualizar o repositório você pode executar:
$helm repo update newrelic
Clique aqui para obter instruções de desinstalação.
Solucione problemas de plug-in do Kubernetes para encaminhamento de instalação de logs
Às vezes, apesar de instalar corretamente o plug-in Kubernetes para encaminhamento de logs (newrelic-logging
Helm chart), você pode encontrar problemas de desempenho que afetam a entrega correta do log. Nessas circunstâncias, observar a métrica interna do direcionador de logs pode ser útil para entender a causa de um potencial gargalo.
O gráfico do Helm newrelic-logging
fornece uma configuração de configuração para permitir a coleta dessas métricas para um determinado cluster do Kubernetes. Também fornecemos um modelo dashboard no formato JSON para exibir facilmente todas essas métricas no New Relic.
Para configurar seu cluster do Kubernetes para enviar as métricas internas do direcionador de logs e representá-los em um dashboard, siga estes passos:
Instale o gráfico do Helm com a seguinte configuração extra:
newrelic-logging:fluentBit:sendMetrics: trueVocê só precisa ativar a configuração
newrelic-logging.fluentBit.sendMetrics
quando houver resolução de problemas em um cluster do Kubernetes. Recomendamos habilitá-lo para um único cluster do Kubernetes por vez para facilitar a resolução de problemas.Baixe este arquivo de modelo de dashboard. Abra-o em um editor de texto e substitua todas as ocorrências
YOUR_ACCOUNT_ID
(49 no total) pelo ID da sua conta New Relic.Importe o dashboard resultante no formato JSON seguindo estas instruções.
O dashboard importado estará disponível na página do seu dashboard como
Kubernetes Fluent Bit monitoring
.
Detalhes adicionais da métrica
O newrelic-logging
gráfico Helm usa Fluent Bit junto com o New Relic plug-in newrelic-fluent-bit-output do para enviar log ao New Relic. A opção fluentBit.sendMetrics
configuração permite a coleta de suas métricas individuais:
- Métrica interna do Fluent Bit: emitida pelo Fluent Bit no formato Prometheus e entregue ao New Relic Prometheus Export endpoint. Eles podem ser facetados por
cluster_name
,node_name
epod_name
. - Métrica interna do plug-in newrelic-fluent-bit-output: coletada pelo plug-in de saída e enviada para New Relic API da métrica. Essas métricas contêm apenas a dimensão
cluster_name
, portanto, podem ser restritas a um cluster específico, mas não a um host ou pod específico. Eles são úteis para avaliar a latência geral ao entregar o log à New Relic Logs API ou para observar possíveis problemas de empacotamento.
Capturamos a métrica interna do Fluent Bit usando seu plug-in prometheus_scrape INPUT em conjunto com seu plug-in prometheus_remote_write OUTPUT. Todas as métricas counter
do Prometheus são, na verdade, contadores cumulativos, mas realizamos automaticamente uma conversão delta quando elas são ingeridas no New Relic para facilitar a consulta posterior usando NRQL . Você pode encontrar mais detalhes aqui.
Ver dados log
Se tudo estiver configurado corretamente e seus dados estiverem sendo coletados, você deverá ver os dados de log em ambos os locais:
- Nossa interface de registros
- Nossas ferramentas para executar a consulta NRQL. Por exemplo, você pode executar uma consulta como esta:
SELECT * FROM Log
Se nenhum dado aparecer após você ativar nossos recursos de gerenciamento de logs, siga nossos procedimentos padrão de resolução de problemas de log.
Desativar encaminhamento de logs
Para desativar os recursos de encaminhamento de logs, você pode desinstalar o plug-in Kubernetes seguindo as etapas descritas aqui. Você não precisa fazer mais nada no New Relic.
Qual é o próximo?
Explore os dados de registro em sua plataforma com nossa interface de registros.
- Obtenha visibilidade mais profunda dos dados de desempenho do seu aplicativo e da sua plataforma encaminhando seu log com nossos recursos logs contextualizados .
- Configure o alerta.
- consulte seus dados e crie dashboard.