HashiCorp Consul monitoramento integração

Nossa HashiCorp Consul integração no host coleta e envia inventário e métricas do seu ambiente de datacenter Consul para a New Relic, onde você pode ver a saúde do seu ambiente. Coletamos dados nos níveis do datacenter e do agente/nó.

Dica

Observe que também temos uma plataforma HashiCorp Cloud Consul integração.

Compatibilidade e requisitos

Antes da instalação, certifique-se de atender a estes requisitos:

Nossa integração é compatível com HashiCorp Consul 1.0 ou superior.
Se você estiver usando ACL, as credenciais para a integração do Consul deverão ter as políticas agent:read, node:read e service:read.

Começo rápido

Instrumente seu ambiente Consul rapidamente e envie seus dados de telemetria com instalação guiada. Nossa instalação guiada usa nosso agente de infraestrutura e nossa CLI para configurar a integração HashiCorp, e descobre outros aplicativos e fontes log em execução em seu ambiente e então recomenda quais você deve usar.

A instalação guiada funciona com a maioria das configurações. Mas se não atender às suas necessidades, existem outras opções de instalação abaixo.

Pronto para começar? Clique no botão relevante, dependendo da região do data center que você usa. Quando terminar a instalação, retorne a esta documentação para revisar as opções de configuração.

Instalação guiada, região dos EUA

Instalação guiada, região da UE

Instalar

Para instalar a integração HashiCorp Consul, siga as instruções para seu ambiente:

' '

Instale o agente de infraestrutura e substitua a variável INTEGRATION_FILE_NAME por nri-consul.
Mude o diretório para a pasta integração:
```
cd /etc/newrelic-infra/integrations.d
```
Copie o arquivo de configuração de amostra:
```
sudo cp consul-config.yml.sample consul-config.yml
```
Edite o arquivo consul-config.yml conforme descrito nas definições de configuração.

Baixe a imagem do instalador nri-consul .MSI em:
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-consul/nri-consul-amd64.msi
Para instalar a partir do prompt de comando do Windows, execute:
```
msiexec.exe /qn /i PATH\TO\nri-consul-amd64.msi
```
No diretório integração, C:\Program Files\New Relic\newrelic-infra\integrations.d\, crie uma cópia do arquivo de configuração de amostra executando:
```
cp consul-config.yml.sample consul-config.yml
```
Edite o arquivo consul-config.yml conforme descrito nas definições de configuração.

Atualize sua integração

Essa integração não é atualizada automaticamente. Para obter melhores resultados, atualize regularmente o pacote de integração e o agente de infraestrutura.

Tarefas pós-instalação

Quando terminar a instalação, você poderá definir opções de configuração. Algumas configurações são necessárias para que a integração funcione, enquanto outras são opcionais.

Configurar a integração

Se você habilitou essa integração por meio de nossa integração ECS ou Kubernetes, consulte estes documentos:

Para a instalação padrão no host, essa integração vem com um arquivo de configuração YAML, apache-config.yml. Esta configuração é onde você pode colocar as credenciais de login necessárias e configurar como os dados são coletados. Quais opções você altera dependem de sua configuração e preferências. Ele vem com um arquivo de configuração de amostra apache-config.yml.sample que você pode copiar e editar.

Configurações específicas relacionadas ao Consul são definidas usando a seção env do arquivo de configuração. Essas configurações controlam a conexão com sua instância Consul, bem como outras configurações e recursos de segurança.

Importante

Se você ainda estiver usando nossos arquivos de configuração/definição legados, consulte este documento para obter ajuda.

Opções de configuração do Cônsul

A Consul integração recolhe informação métrica e de inventário. Esta tabela mostra a que cada opção de configuração se aplica.

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

Contexto	Descrição	Padrão	Aplica-se a
HOSTNAME	Nome do host ou IP onde o Consul está rodando.	host local	MI
PORT	Porto onde o Cônsul está escutando.	8.500	MI
TOKEN	Token ACL se a autenticação token estiver habilitada.	N/A	MI
ENABLE_SSL	Conecte-se usando SSL.	false	MI
CA_BUNDLE_FILE	Arquivo de pacote da Autoridade de Certificação Alternativa.	N/A	MI
CA_BUNDLE_DIR	Diretório de pacote da Autoridade de Certificação Alternativa.	N/A	MI
TRUST_SERVER_CERTIFICATE	Se definido como verdadeiro, o certificado do servidor NÃO será verificado para SSL.	false	MI
FAN_OUT	Se verdadeiro, tentará coletar métricas de todos os outros nós no cluster Consul.	verdadeiro	M
CHECK_LEADERSHIP	Verifique a liderança no servidor cônsul. Isso deve ser desabilitado no cônsul no modo cliente.	verdadeiro	M
TIMEOUT	Tempo limite para cada uma das chamadas do cliente cônsul.	30 anos	MI
METRICS	Defina como `true` para ativar a coleta somente de métricas.	false
INVENTORY	Defina como `true` para ativar a coleta somente de inventário.	false

Os valores para estas configurações podem ser definidos de diversas maneiras:

Adicionando o valor diretamente no arquivo de configuração. Esta é a forma mais comum.
Substituindo os valores das variáveis de ambiente usando a notação {{}} . Isso requer o agente de infraestrutura v1.14.0+. Leia mais aqui ou veja o exemplo abaixo.
Usando gerenciamento de segredos. Use isto para proteger informações confidenciais, como senhas que seriam expostas em texto simples no arquivo de configuração. Para obter mais informações, consulte Gerenciamento de segredos.

Etiquetas

Você pode decorar ainda mais sua métrica usando etiquetas. Os rótulos permitem adicionar atributo (pares de valores principais) à sua métrica, que você pode usar para consultar, filtrar ou agrupar sua métrica.

Nosso arquivo de configuração de amostra padrão inclui exemplos de rótulos, mas, como não são obrigatórios, você pode remover, modificar ou adicionar novos de sua escolha.

labels:
   env: production
   role: load_balancer

Exemplo de configuração

Esta é a configuração básica usada para coletar métricas e inventário do seu localhost:

integrations:
  - name: nri-consul
    env:
      HOSTNAME: localhost
      PORT: 8500
    interval: 15s
    labels:
      environment: production
    inventory_source: config/consul

Esta configuração coleta métricas a cada 30 segundos e inventário a cada 60 segundos com timeout:

integrations:
  - name: nri-consul
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 8500
      TIMEOUT: 10s
    interval: 15s
    labels:
      environment: production

  - name: nri-consul
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 8500
      TIMEOUT: 10s
    interval: 60s
    labels:
      environment: production
    inventory_source: config/consul

Nesta configuração estamos utilizando a variável de ambiente CONSUL_HOST para preencher a configuração nome do host da integração:

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: {{CONSUL_HOST}}
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer

Nesta configuração utilizamos um token ACL para conectar e não estamos coletando métricas de outros nós cônsul conectados (FAN_OUT: false):

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: localhost
      PORT: 8500
      TOKEN: my_token
      FAN_OUT: false
    interval: 15s
    labels:
      env: production
      role: load_balancer

Nesta configuração estamos monitorando vários servidores Consul a partir da mesma integração. Para a primeira instância (HOSTNAME: 1st_consul_host) estamos coletando métrica e inventário enquanto para a segunda instância (HOSTNAME: 2nd_consul_host) coletaremos apenas métrica.

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: 1st_consul_host
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-consul
    env:
      INVENTORY: "true"
      HOSTNAME: 1st_consul_host
      PORT: 8500
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/consul

  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: 2nd_consul_host
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer

Encontre e use dados

Os dados desta integração podem ser encontrados em: one.newrelic.com > Infrastructure > Third-party services > Apache.

Os dados do Apache são anexados aos tipos de evento ConsulDatacenterSamplee ConsulAgentSample . Você pode consultar esses dados para fins de resolução de problemas ou para criar gráficos e dashboards personalizados.

Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.

Dados métricos

A HashiCorp Consul integração coleta os seguintes dados métricos atributo:

Métrica de amostra de datacenter Consul

Estes atributos estão anexados ao tipo de evento ConsulDatacenterSample :

Métrica	Descrição
`consul.catalog.nodes_critical`	O número de nós com status de serviço `critical` daqueles registrados.
`consul.catalog.nodes_passing`	O número de nós com status de serviço `passing` daqueles registrados.
`consul.catalog.nodes_up`	O número de nós.
`consul.catalog.nodes_warning`	O número de nós com status de serviço `warning` daqueles registrados.
`consul.catalog.total_nodes`	O número de nós registrados no cluster cônsul.
`consul.memberlist.msg.suspect`	O número de vezes que um agente suspeita que outro falhou durante a investigação durante o protocolo de fofoca.
`consul.raft.apply`	O número de transações de jangadas ocorrendo.
`consul.raft.commitTime.avg`	O tempo médio que leva para confirmar uma nova entrada no log da balsa no líder.
`consul.raft.commitTime.count`	O número de amostras de `raft.commitTime`.
`consul.raft.commitTime.max`	O tempo máximo necessário para confirmar uma nova entrada no log da balsa no líder.
`consul.raft.commitTime.median`	O tempo médio necessário para confirmar uma nova entrada no log da balsa no líder.
`consul.raft.leader.dispatchLog.avg`	O tempo médio que leva para o líder gravar entradas de log no disco.
`consul.raft.leader.dispatchLog.count`	O número de amostras de `raft.leader.dispatchLog`.
`consul.raft.leader.dispatchLog.max`	O tempo máximo que o líder leva para gravar entradas de log no disco.
`consul.raft.leader.dispatchLog.median`	O tempo médio que leva para o líder gravar entradas de log no disco.
`consul.raft.leader.lastContact.avg`	O tempo médio decorrido desde a última vez que o líder pôde verificar seu contrato com os seguidores.
`consul.raft.leader.lastContact.count`	O número de amostras de `raft.leader.lastContact`.
`consul.raft.leader.lastContact.max`	O tempo máximo decorrido desde a última vez que o líder pôde verificar seu contrato com os seguidores.
`consul.raft.leader.lastContact.median`	O tempo médio decorrido desde a última vez que o líder pôde verificar seu contrato com os seguidores.
`consul.raft.state.candidate`	O número de eleições de líderes iniciadas.
`consul.raft.state.leader`	O número de eleições de líderes concluídas.
`consul.serf.member.flap`	O número de vezes que um agente é marcado como morto e depois se recupera rapidamente.

Cônsul agente amostra métrica

Estes atributos estão anexados ao tipo de evento ConsulAgentSample :

Métrica	Descrição
`agent.aclCacheHit`	ACL ocorrência sem cache.
`agent.aclCacheMiss`	Faltas no cache da ACL.
`agent.kvStores`	O número de amostras de `kvs.apply`.
`agent.kvStoresAvgInMilliseconds`	O tempo médio necessário para concluir uma atualização no armazenamento KV.
`agent.kvStoresMaxInMilliseconds`	O tempo máximo necessário para concluir uma atualização no armazenamento KV.
`agent.kvStoresMedianInMilliseconds`	O tempo médio necessário para concluir uma atualização no armazenamento KV.
`agent.peers`	O número de pares no conjunto de pares.
`agent.staleQueries`	Consulta atendida dentro do limite obsoleto permitido.
`agent.txnAvgInMilliseconds`	O tempo médio necessário para aplicar uma operação de transação.
`agent.txnMaxInMilliseconds`	O tempo máximo necessário para aplicar uma operação de transação.
`agent.txnMedianInMilliseconds`	O tempo médio necessário para aplicar uma operação de transação.
`agent.txns`	O número de amostras de `txn.apply`.
`client.rpcFailed`	Medida de solicitações RPC com falha.
`client.rpcLoad`	Medida de quanto um agente está carregando os servidores Consul.
`client.rpcRateLimited`	Medida de solicitações RPC que têm taxa limitada.
`net.agent.maxLatencyInMilliseconds`	Latência máxima deste nó para todos os outros.
`net.agent.medianLatencyInMilliseconds`	Latência mediana deste nó para todos os outros.
`net.agent.minLatencyInMilliseconds`	Latência mínima deste nó para todos os outros.
`net.agent.p25LatencyInMilliseconds`	Latência P25 deste nó para todos os outros.
`net.agent.p75LatencyInMilliseconds`	Latência P75 deste nó para todos os outros.
`net.agent.p90LatencyInMilliseconds`	Latência P90 deste nó para todos os outros.
`net.agent.p95LatencyInMilliseconds`	Latência P95 deste nó para todos os outros.
`net.agent.p99LatencyInMilliseconds`	Latência P99 deste nó para todos os outros.
`runtime.allocations`	Contagem cumulativa de objetos heap alocados.
`runtime.allocationsInBytes`	Os bytes atuais alocados pelo processo Consul.
`runtime.frees`	Contagem cumulativa de objetos heap liberados.
`runtime.gcCycles`	O número de ciclos de GC concluídos.
`runtime.gcPauseInMilliseconds`	Nanossegundos cumulativos em pausas de parar o mundo do GC desde o início do Consul.
`runtime.goroutines`	O número de rotinas de corrida.
`runtime.heapObjects`	O número de objetos alocados no heap
`runtime.virtualAddressSpaceInBytes`	Tamanho total do espaço de endereço virtual reservado pelo tempo de execução go.

Dados de inventário

A integração HashiCorp Consul captura o parâmetro de configuração e as configurações atuais dos nós do agente Consul. Ele coleta os resultados dos /v1/agent/self endpoints REST da API. Ele extrai as seções Config e DebugConfig dessa resposta.

Dica

Note: seções aninhadas em Config e DebugConfig não são coletadas.

Os dados estão disponíveis na página Inventário, na origem config/consul . Para obter mais informações sobre dados de inventário, consulte Compreender os dados de integração.

Verifique o código-fonte

Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.

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

HashiCorp Consul monitoramento integração

Dica

Compatibilidade e requisitos

Começo rápido

Instalar

SEC

Kubernetes

Linux

Windows

Atualize sua integração

Tarefas pós-instalação

Configurar a integração

Importante

Opções de configuração do Cônsul

Etiquetas

Exemplo de configuração

Configuração básica

Configuração básica com diferentes intervalos métricos/inventário

Substituição de variáveis de ambiente

Métrica somente com token e sem Fan Out

Monitoramento Multi-instância

Encontre e use dados

Dados métricos

Métrica de amostra de datacenter Consul

Cônsul agente amostra métrica

Dados de inventário

Dica

Verifique o código-fonte

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

HashiCorp Consul monitoramento integração

Dica

Compatibilidade e requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Começo rápido

Instalar

Kubernetes

Linux

Windows

Atualize sua integração

Tarefas pós-instalação

Configurar a integração

Importante

Opções de configuração do Cônsul

Etiquetas

Exemplo de configuração

Configuração básica

Configuração básica com diferentes intervalos métricos/inventário

Substituição de variáveis de ambiente

Métrica somente com token e sem Fan Out

Monitoramento Multi-instância

Encontre e use dados

Dados métricos

Métrica de amostra de datacenter Consul

Cônsul agente amostra métrica

Dados de inventário

Dica

Verifique o código-fonte

Compatibilidade e requisitos