Coletor para monitoramento do HCP Consul métrica

Este guia explica como coletar métricas de sua implantação Consul gerenciada por HCP usando o coletor OpenTelemetry. O coletor coleta, processa e envia dados de telemetria (incluindo métricas, log e rastreamento) para vários backends de observabilidade, incluindo New Relic.

O exemplo de configuração abaixo aproveita o receptor Prometheus dentro do coletor. Ele recupera métricas de serviço diretamente da API de métricas de serviço do HCP Consul e as exporta para o endpoint OpenTelemetry da New Relic.

O HCP Consul oferece dois tipos de métricas de observabilidade:

Métricas do servidor: rastreiam o desempenho do servidor Consul e o uso de recursos.
Métricas de proxy Envoy: Monitoram a malha de serviço Envoy dentro do Consul.

Siga as etapas abaixo para coletar e exportar HCP Consul métrica para New Relic.

Revise os requisitos

Antes de começar, você precisará do seguinte:

Um serviço docker daemon em execução
Uma ferramenta Docker Compose instalada
Seu token de administrador HCP Consul ACL
Sua New Relic
da conta para a qual você deseja relatar dados

Baixe ou clone a configuração de exemplo

Baixe o exemplo de configuração.
Após o download, localize o diretório denominado hcp-consul na pasta other-examples/collector do repositório. Este diretório contém a configuração específica para coleta de métricas do HCP Consul.
(Opcional) Consulte o README para obter detalhes e instruções adicionais relacionados ao exemplo do HCP Consul.

Defina variáveis de ambiente e execute o coletor

No arquivo .env :

Defina os valores do token de acesso do HCP e do URL de acesso

Defina a variável chave de API do New Relic para sua chave de licença do New Relic

bash

$# Open the HCP Consul example directory
$  cd newrelic-opentelemetry-examples/other-examples/collector/hcp-consul
$
$  # Set environment variables.
$
$  # run the collector in docker
$  docker compose up

Informações variáveis de ambiente

Se precisar de mais informações sobre as variáveis de ambiente definidas acima, consulte a documentação na tabela a seguir.

Variável	Descrição	Documentos
`NEW_RELIC_API_KEY`	New Relic	Saiba mais sobre chave de API
`NEW_RELIC_OTLP_ENDPOINT`	O endpoint OTLP padrão da New Relic dos EUA é `https://otlp.nr-data.net:4318`.	Revise a configuração do endpoint OTLP
`HCP_ACCESS_TOKEN`	Token de administrador ACL para HCP Consul	Crie um token de administrador ACL
`HCP_ACCESS_URL`	URL para acessar seu servidor Consul específico	Localize sua URL de acesso

Encaminhar métrica do HCP Consul Envoy para a New Relic

Para monitor a métrica do HCP Consul Envoy no New Relic, você pode configurar o coletor OpenTelemetry integrado ao cluster do HCP Consul para encaminhar a métrica para seu próprio coletor. Isso pode incluir o coletor em execução neste exemplo.

Adicione um receptor HTTP ao coletor OpenTelemetry. Você pode adicionar isso ao grupo receivers no arquivo collector.yaml de exemplo:
```
receivers:
    otlp:
      protocols:
        http:
```
Isso adicionará um receptor escutando em 0.0.0.0:4318.

Configure seu cluster HCP Consul para encaminhar a métrica do Envoy para este receptor. Isso pode ser configurado na sub-rotina telemetryCollector no arquivo de configuração do HCP Consul. Por exemplo:

telemetryCollector:
      enabled: true
      customExporterConfig: |-
        {
          "exporter_config": {
            "otlphttp": {
              "endpoint": "0.0.0.0:4318",
              "headers": {
                "authorization": "<auth>"
              },
              "timeout": "2s"
            }
          }
        }

Visualize seus dados no New Relic

No New Relic, você pode visualizar seus dados do HCP Consul em alguns locais diferentes:

Navegue até o mercado New Relic e pesquise “cônsul”. Clique em um dos painéis para instalá-lo rapidamente em sua conta.
Navegue até o explorador de métricas e filtre por consul ou envoy por métrica do Envoy. Esses dados podem ser adicionados a qualquer alerta ou dashboard personalizado.
Dica
Para visualizar todas as métricas disponíveis com esta integração do servidor HCP Consul, consulte a documentação aqui.

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