• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

HashiCorp Consul monitoramento integração

Nossa HashiCorp Consul integração no host coleta e envia inventário e métricas do seu ambiente data center Consul para New Relic, onde você pode ver a saúde do seu ambiente. Coletamos dados nos níveis do data center 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

Instalar

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

' '

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

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 data center 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.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.