HashiCorp Cónsul monitoreo integración

Nuestra integración en el host HashiCorp Consul recopila y envía inventario y métrica desde su entorno de centro de datos Consul a New Relic, donde puede ver el estado de su entorno. Recopilamos datos tanto a nivel del centro de datos como de agente/nodo.

Sugerencia

Tenga en cuenta que también contamos con una plataforma HashiCorp Cloud Consul integración.

Compatibilidad y requisitos

Antes de la instalación, asegúrese de cumplir con estos requisitos:

Nuestra integración es compatible con HashiCorp Consul 1.0 o superior.
Si utiliza ACL, las credenciales para la integración de Consul deben tener las políticas agent:read, node:read y service:read.

Inicio rápido

Instrumente su entorno Cónsul rápidamente y envíe sus telemetry data con instalación guiada. Nuestra instalación guiada utiliza nuestro agente de infraestructura y nuestra CLI para configurar la integración de HashiCorp, descubre otras aplicaciones y fuentes log que se ejecutan en su entorno y luego recomienda cuáles debería utilizar.

La instalación guiada funciona con la mayoría de las configuraciones. Pero si no se adapta a sus necesidades, existen otras opciones de instalación a continuación.

¿Listo para comenzar? Haga clic en el botón correspondiente, según la región del centro de datos que utilice. Cuando haya terminado con la instalación, regrese a esta documentación para revisar las opciones de configuración.

Instalación guiada, región de EE. UU.

Instalación guiada, región de la UE

Instalar

Para instalar la integración de HashiCorp Consul, siga las instrucciones para su entorno:

' '

Instale el agente de infraestructura y reemplace la variable INTEGRATION_FILE_NAME con nri-consul.
Cambiar directorio a la carpeta de integración:
```
cd /etc/newrelic-infra/integrations.d
```
Copie el archivo de configuración de muestra:
```
sudo cp consul-config.yml.sample consul-config.yml
```
Edite el archivo consul-config.yml como se describe en los ajustes de configuración.

Descargue la imagen del instalador nri-consul .MSI desde:
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-consul/nri-consul-amd64.msi
Para instalar desde el símbolo del sistema de Windows, ejecute:
```
msiexec.exe /qn /i PATH\TO\nri-consul-amd64.msi
```
En el directorio de integración, C:\Program Files\New Relic\newrelic-infra\integrations.d\, cree una copia del archivo de configuración de muestra ejecutando:
```
cp consul-config.yml.sample consul-config.yml
```
Edite el archivo consul-config.yml como se describe en los ajustes de configuración.

Actualiza tu integración

Esta integración no se actualiza automáticamente. Para obtener mejores resultados, actualice periódicamente el paquete de integración y el agente de infraestructura.

Tareas posteriores a la instalación

Cuando haya terminado con la instalación, puede establecer las opciones de configuración. Se requieren algunas configuraciones para que la integración funcione, mientras que otras son opcionales.

Configurar la integración

Si habilitó esta integración a través de nuestra integración ECS o Kubernetes, consulte esos documentos:

Para la instalación estándar en el host, esta integración viene con un archivo de configuración YAML, apache-config.yml. Esta configuración es donde puede colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan los datos. Las opciones que cambie dependen de su configuración y preferencias. Viene con un archivo de configuración de muestra apache-config.yml.sample que puedes copiar y editar.

Las configuraciones específicas relacionadas con Consul se definen usando la sección env del archivo de configuración. Estas configuraciones controlan la conexión a su instancia de Consul, así como otras configuraciones y características de seguridad.

Importante

Si todavía utiliza nuestros archivos de configuración/definición legacy, consulte este documento para obtener ayuda.

Opciones de configuración del cónsul

El Cónsul integración recopila información tanto métrica como de inventario. Esta tabla muestra a qué se aplica cada opción de configuración.

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

Configuración	Descripción	Por defecto	Se aplica a
HOSTNAME	Nombre de host o IP donde se está ejecutando Consul.	host local	M/I
PORT	Puerto en el que el cónsul está escuchando.	8500	M/I
TOKEN	Token ACL si la autenticación token está habilitada.	N/A	M/I
ENABLE_SSL	Conéctese mediante SSL.	false	M/I
CA_BUNDLE_FILE	Archivo de paquete de autoridad de certificación alternativa.	N/A	M/I
CA_BUNDLE_DIR	Directorio de paquete de autoridad de certificación alternativa.	N/A	M/I
TRUST_SERVER_CERTIFICATE	Si se establece en verdadero, el certificado del servidor NO se verifica para SSL.	false	M/I
FAN_OUT	Si es cierto, intentará recopilar métrica de todos los demás nodos en el clúster Consul.	verdadero	M
CHECK_LEADERSHIP	Verifique el liderazgo en el servidor del cónsul. Esto debería estar deshabilitado en el cónsul en modo cliente.	verdadero	M
TIMEOUT	Tiempo de espera para cada una de las llamadas del cliente cónsul.	30 años	M/I
METRICS	Establezca en `true` para habilitar la recopilación solo métrica.	false
INVENTORY	Configúrelo en `true` para habilitar la recopilación solo de inventario.	false

Los valores para estas configuraciones se pueden definir de varias maneras:

Agregando el valor directamente en el archivo de configuración. Esta es la forma más común.
Reemplazar los valores de las variables de entorno usando la notación {{}} . Esto requiere el agente de infraestructura v1.14.0+. Lea más aquí o vea el ejemplo a continuación.
Utilizando la gestión de secretos. Utilícelo para proteger información confidencial, como contraseñas que quedarían expuestas en texto sin formato en el archivo de configuración. Para obtener más información, consulte Gestión de secretos.

Etiquetas

Puedes decorar aún más tu métrica usando etiquetas. Las etiquetas le permiten agregar atributos (pares de valores principales) a su métrica, que luego puede usar para consultar, filtrar o agrupar su métrica.

Nuestro archivo de configuración de muestra predeterminado incluye ejemplos de etiquetas pero, como no son obligatorias, puede eliminar, modificar o agregar nuevas de su elección.

labels:
   env: production
   role: load_balancer

Configuración de ejemplo

Esta es la configuración básica utilizada para recopilar métricas e inventario de su localhost:

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

Esta configuración recopila métrica cada 30 segundos e inventario cada 60 segundos con tiempo de espera:

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

En esta configuración estamos usando la variable de entorno CONSUL_HOST para completar la configuración del nombre de host de la integración:

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

En esta configuración usamos un token ACL para conectarnos y no recopilamos métricas de otros nodos cónsules 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

En esta configuración estamos monitoreando múltiples servidores Consul desde una misma integración. Para la primera instancia (HOSTNAME: 1st_consul_host) estamos recolectando métrica e inventario mientras que para la segunda instancia (HOSTNAME: 2nd_consul_host) solo recolectaremos 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

Buscar y utilizar datos

Los datos de esta integración se pueden encontrar en: one.newrelic.com > Infrastructure > Third-party services > Apache.

Los datos de Apache se adjuntan a los tipos de evento ConsulDatacenterSampley ConsulAgentSample . Puede consultar estos datos para fines de resolución de problemas o para crear gráficos y paneles personalizados.

Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.

Datos métricos

La integración HashiCorp Consul recopila los siguientes datos métricos del atributo:

Muestra cónsul datacenter métrica

Estos atributos están adjuntos al tipo de evento ConsulDatacenterSample :

Métrica	Descripción
`consul.catalog.nodes_critical`	La cantidad de nodos con estado de servicio `critical` de los registrados.
`consul.catalog.nodes_passing`	La cantidad de nodos con estado de servicio `passing` de los registrados.
`consul.catalog.nodes_up`	El número de nodos.
`consul.catalog.nodes_warning`	La cantidad de nodos con estado de servicio `warning` de los registrados.
`consul.catalog.total_nodes`	El número de nodos registrados en el clúster del cónsul.
`consul.memberlist.msg.suspect`	La cantidad de veces que un agente sospecha que otro falló mientras investigaba durante el protocolo de chismes.
`consul.raft.apply`	El número de transacciones de balsa que se producen.
`consul.raft.commitTime.avg`	El tiempo promedio que se tarda en realizar una nueva entrada en el log de la balsa en el líder.
`consul.raft.commitTime.count`	El número de muestras de `raft.commitTime`.
`consul.raft.commitTime.max`	El tiempo máximo que lleva confirmar una nueva entrada en el log de balsa del líder.
`consul.raft.commitTime.median`	El tiempo medio que se tarda en realizar una nueva entrada en el log de la balsa en el líder.
`consul.raft.leader.dispatchLog.avg`	El tiempo promedio que le toma al líder escribir entradas log en el disco.
`consul.raft.leader.dispatchLog.count`	El número de muestras de `raft.leader.dispatchLog`.
`consul.raft.leader.dispatchLog.max`	El tiempo máximo que le toma al líder escribir entradas log en el disco.
`consul.raft.leader.dispatchLog.median`	El tiempo medio que le toma al líder escribir entradas log en el disco.
`consul.raft.leader.lastContact.avg`	El tiempo promedio transcurrido desde la última vez que el líder pudo verificar su contrato de arrendamiento con sus seguidores.
`consul.raft.leader.lastContact.count`	El número de muestras de `raft.leader.lastContact`.
`consul.raft.leader.lastContact.max`	El tiempo máximo transcurrido desde que el líder pudo verificar por última vez su contrato de arrendamiento con sus seguidores.
`consul.raft.leader.lastContact.median`	La mediana del tiempo transcurrido desde la última vez que el líder pudo comprobar su contrato de arrendamiento con sus seguidores.
`consul.raft.state.candidate`	El número de elecciones de líderes iniciadas.
`consul.raft.state.leader`	El número de elecciones de líderes completadas.
`consul.serf.member.flap`	La cantidad de veces que un agente es marcado como muerto y luego se recupera rápidamente.

Cónsul agente muestra métrica

Estos atributos están adjuntos al tipo de evento ConsulAgentSample :

Métrica	Descripción
`agent.aclCacheHit`	ACL activado de caché.
`agent.aclCacheMiss`	Falta la caché de ACL.
`agent.kvStores`	El número de muestras de `kvs.apply`.
`agent.kvStoresAvgInMilliseconds`	El tiempo promedio que lleva completar una actualización en la tienda KV.
`agent.kvStoresMaxInMilliseconds`	El tiempo máximo que lleva completar una actualización de la tienda KV.
`agent.kvStoresMedianInMilliseconds`	El tiempo medio que lleva completar una actualización en la tienda KV.
`agent.peers`	El número de pares en el conjunto de pares.
`agent.staleQueries`	Se realizó consulta dentro del umbral viciado permitido.
`agent.txnAvgInMilliseconds`	El tiempo promedio que lleva aplicar una operación de transacción.
`agent.txnMaxInMilliseconds`	El tiempo máximo que lleva aplicar una operación de transacción.
`agent.txnMedianInMilliseconds`	El tiempo medio que lleva aplicar una operación de transacción.
`agent.txns`	El número de muestras de `txn.apply`.
`client.rpcFailed`	Medida de solicitudes RPC fallidas.
`client.rpcLoad`	Medida de cuánto está cargando un agente los servidores de Consul.
`client.rpcRateLimited`	Medida de solicitudes de RPC que tienen una tasa limitada.
`net.agent.maxLatencyInMilliseconds`	Latencia máxima de este nodo a todos los demás.
`net.agent.medianLatencyInMilliseconds`	Latencia mediana de este nodo a todos los demás.
`net.agent.minLatencyInMilliseconds`	Latencia mínima de este nodo a todos los demás.
`net.agent.p25LatencyInMilliseconds`	Latencia P25 de este nodo a todos los demás.
`net.agent.p75LatencyInMilliseconds`	Latencia P75 de este nodo a todos los demás.
`net.agent.p90LatencyInMilliseconds`	Latencia P90 de este nodo a todos los demás.
`net.agent.p95LatencyInMilliseconds`	Latencia P95 de este nodo a todos los demás.
`net.agent.p99LatencyInMilliseconds`	Latencia P99 de este nodo a todos los demás.
`runtime.allocations`	Recuento acumulado de objetos del montón asignados.
`runtime.allocationsInBytes`	Los bytes actuales asignados por el proceso Cónsul.
`runtime.frees`	Recuento acumulado de objetos del montón liberados.
`runtime.gcCycles`	El número de ciclos de GC completados.
`runtime.gcPauseInMilliseconds`	Los nanosegundos acumulados en GC detienen el mundo desde que comenzó Consul.
`runtime.goroutines`	El número de rutinas de carrera.
`runtime.heapObjects`	El número de objetos asignados en el montón.
`runtime.virtualAddressSpaceInBytes`	Tamaño total del espacio de direcciones virtuales reservado por el tiempo de ejecución de go.

Datos de inventario

La integración HashiCorp Consul captura el parámetro de configuración y la configuración actual de los nodos del agente Consul. Recopila los resultados de los /v1/agent/self REST extremos de API. Extrae las secciones Config y DebugConfig de esa respuesta.

Sugerencia

Note: Las secciones anidadas dentro de Config y DebugConfig no se recopilan.

Los datos están disponibles en la página Inventario, en la fuente config/consul . Para obtener más información sobre los datos de inventario, consulte Comprender los datos de integración.

Comprueba el código fuente

Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.

Te ofrecemos esta traducción automática para facilitar la lectura.

HashiCorp Cónsul monitoreo integración

Sugerencia

Compatibilidad y requisitos

Inicio rápido

Instalar

ECS

Kubernetes

Linux

Windows

Actualiza tu integración

Tareas posteriores a la instalación

Configurar la integración

Importante

Opciones de configuración del cónsul

Etiquetas

Configuración de ejemplo

Configuración básica

Configuración básica con diferentes intervalos métricos/de inventario.

Reemplazo de variables de entorno

Solo métrica con token y sin Fan Out

Monitoreo multiinstancia

Buscar y utilizar datos

Datos métricos

Muestra cónsul datacenter métrica

Cónsul agente muestra métrica

Datos de inventario

Sugerencia

Comprueba el código fuente

Te ofrecemos esta traducción automática para facilitar la lectura.

HashiCorp Cónsul monitoreo integración

Sugerencia

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

Inicio rápido

Instalar

Kubernetes

Linux

Windows

Actualiza tu integración

Tareas posteriores a la instalación

Configurar la integración

Importante

Opciones de configuración del cónsul

Etiquetas

Configuración de ejemplo

Configuración básica

Configuración básica con diferentes intervalos métricos/de inventario.

Reemplazo de variables de entorno

Solo métrica con token y sin Fan Out

Monitoreo multiinstancia

Buscar y utilizar datos

Datos métricos

Muestra cónsul datacenter métrica

Cónsul agente muestra métrica

Datos de inventario

Sugerencia

Comprueba el código fuente

Compatibilidad y requisitos