OpenTelemetry para Kubernetes

visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.

A observabilidade do OpenTelemetry para Kubernetes fornece configuração completa e de código aberto combinada com uma interface de usuário Kubernetes de alto nível que já é compatível com nossa instrumentação proprietária do Kubernetes. Nossa interface K8s foi projetada para ser independente do provedor, permitindo que você selecione a instrumentação OpenTelemetry ou New Relic com base em suas necessidades.

Este documento descreve o processo de monitoramento de um cluster do Kubernetes usando OpenTelemetry. Envolve a instalação do gráfico Helm nr-k8s-otel-collector dentro do cluster e a implantação do coletor necessário para permitir observabilidade de primeira classe.

Ao integrar os componentes Kubernetes ao coletor OpenTelemetry , podemos transmitir métricas, eventos e log diretamente para New Relic. Esses sinais de telemetria aprimoram automaticamente nossas experiências prontas para uso, como o navegadorKubernetes , dashboard de visão geral, o eventoKubernetes ou a página de resumo do Kubernetes APM .

Como funciona?

O gráfico nr-k8s-otel-collector Helm implanta estes coletores OpenTelemetry :

Deamonset coletor: implantado em cada nó trabalhador e responsável por coletar métricas do host subjacente no nó, o cAdvisor, o Kubelet, e coletar log dos contêineres.
Implantação coletor: implantar no nó mestre e responsável pela coleta de métricas da métrica estadual do Kube e cluster do evento Kubernetes .

Requisitos

Para enviar dados de telemetria do Kubernetes para o New Relic, precisamos de um coletor OpenTelemetry. Nossa distribuição New Relic do OpenTelemetry (NRDOT) já está configurada para monitor automaticamente um cluster do Kubernetes. Isso é feito implantando todos os componentes necessários por meio de nosso nr-k8s-otel-collector gráfico Helm.

Se você mudar para um coletor OpenTelemetry diferente, certifique-se de que ele tenha todos os componentes principais necessários:

Dica

Interessado em usar nossa observabilidade do Kubernetes OpenTelemetry, mas não quer instalar nosso gráfico Helm?

Certifique-se de que seu coletor inclua os componentes destacados anteriormente.
Siga as instruções de configuração fornecidas neste documento para configurar seu coletor adequadamente.

Instale seu cluster do Kubernetes com OpenTelemetry

Para colocar o OpenTelemetry em funcionamento em seu cluster, siga estas etapas:

Baixe o arquivo de valores do gráfico Helm e adapte-o para atender aos seus requisitos específicos.
- O nome do cluster e são obrigatórios.
- Confira a lista completa de parâmetros de configuração.
Instale o gráfico Helm junto com o arquivo de valores.
bash
```
$helm repo add newrelic https://helm-charts.newrelic.com
$helm upgrade nr-k8s-otel-collector newrelic/nr-k8s-otel-collector -f your-custom-values.yaml -n newrelic --create-namespace --install
```
Certifique-se de que o pod tenha sido ativado com sucesso.
bash
```
$kubectl get pods -n newrelic --watch
```
Certifique-se de que New Relic esteja obtendo os dados necessários, incluindo métricas, eventos e log, executando a consulta correta. Consulte Introdução ao criador de consulta para obter mais informações.
```
FROM Metric SELECT * WHERE k8s.cluster.name='<CLUSTER_NAME>'
FROM InfrastructureEvent SELECT * WHERE k8s.cluster.name='<CLUSTER_NAME>'
FROM Log SELECT * WHERE k8s.cluster.name='<CLUSTER_NAME>'
```
Se você estiver usando um cluster do GKE AutoPilot, será necessário aplicar a configuração a seguir no arquivo values.yaml para garantir a compatibilidade e a funcionalidade adequada do coletor OpenTelemetry .
```
privileged: false
receivers:
    filelog:
        enabled: false
daemonset:
    containerSecurityContext:
        privileged: false
```

Desinstale seu cluster do Kubernetes com OpenTelemetry

Para interromper o monitoramento de um cluster do Kubernetes com OpenTelemetry, execute este comando:

bash

$helm uninstall nr-k8s-otel-collector -n newrelic

Reduza a ingestão de dados

A opção LowDataMode está habilitada por padrão para ingerir apenas as métricas exigidas pela nossa interface Kubernetes.

Se você precisar reduzir ainda mais a ingestão de dados, aumente o intervalo de raspagem nos valores do gráficonr-k8s-otel-collector para cada componente implantado.

Métrica

Encontre e use dados

Confira estes documentos para saber mais sobre como encontrar dados:

Explore seu cluster do Kubernetes para saber o status do seu cluster, desde o plano de controle até os nós e pod.
Página de resumo doKubernetes APM que oferece insights sobre sua integração Kubernetes junto com seu aplicativo de monitor.

Resolução de problemas

Confira o log do pod coletor que está apresentando problemas. Execute este comando:

bash

$kubectl logs <otel-pod-name> -n newrelic

Você também pode definir o parâmetro verboseLog como true no gráfico do Helm nr-k8s-otel-collector .

Erros comuns

Confira a seção Erros comuns em nosso repositório GitHub.

Apoiar

Se você tiver problemas com a observabilidade do OpenTelemetry para Kubernetes:

Dê uma olhada na seção de problemas no GitHub para problemas semelhantes ou considere abrir um novo problema.
Entre em contato com o suporte da New Relic para obter assistência.

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