Esta guía explica cómo recopilar métricas de su Cónsul administrado por HCP desplegadamente utilizando el recolector OpenTelemetry. El recolector recopila, procesa y envía telemetry data (incluidos métricas, registros y trazas) a varios servidores de observabilidad, incluido New Relic.
El siguiente ejemplo de configuración aprovecha el receptor Prometheus dentro del recolector. Recupera el servicio métrico directamente de la API de servicio métrico de HCP Consul y los exporta al extremo OpenTelemetry de New Relic.
HCP Consul ofrece dos tipos de observabilidad métrica:
- Métricas del servidor: rastrean el rendimiento del servidor Consul y el uso de recursos.
- Envoy proxy métrica: Estos monitorean la malla de servicios de Envoy dentro de Consul.
Siga los pasos a continuación para recopilar y exportar HCP Consul métrica a New Relic.
Revisa los requisitos
Antes de comenzar, necesitará lo siguiente:
Un docker daemon servicio en ejecución
Una herramienta Docker Compose instalada
Tu New Relic
para la cuenta a la que deseas informar datos
Descargue o clone la configuración de ejemplo
- Descargue la configuración de ejemplo.
- Una vez descargado, ubique el directorio llamado
hcp-consul
dentro de la carpetaother-examples/collector
del repositorio. Este directorio contiene la configuración específica para la recolección de HCP Consul métrica. - (Opcional) Consulte el archivo README para obtener detalles e instrucciones adicionales relacionados con el ejemplo de HCP Consul.
Establezca variables de entorno y ejecute el recolector
En el archivo .env
:
Establecer los valores del token de acceso de HCP y de la URL de acceso
Establezca la variable clave de API de New Relic en su clave de licencia de 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 upInformación de variables de entorno
Si necesita más información sobre las variables de entorno establecidas anteriormente, consulte la documentación en la siguiente tabla.
Variable
Descripción
Documentos
NEW_RELIC_API_KEY
New Relic Ingest clave de API
NEW_RELIC_OTLP_ENDPOINT
El extremo predeterminado de OTLP New Relic de EE. UU. es
https://otlp.nr-data.net:4318
.HCP_ACCESS_TOKEN
Token de administrador de ACL para HCP Consul
HCP_ACCESS_URL
URL para acceder a su servidor Consul específico
Reenviar HCP Cónsul Enviado métrica a New Relic
Para monitor la métrica de HCP Consul Envoy en New Relic, puede configurar el recolector OpenTelemetry integrado en su clúster HCP Consul para reenviar la métrica a su propio recolector. Esto puede incluir el recolector que se ejecuta en este ejemplo.
Agregue un receptor HTTP al recolector de OpenTelemetry. Puede agregar esto al grupo
receivers
en el archivocollector.yaml
de ejemplo:receivers:otlp:protocols:http:Esto agregará un receptor escuchando en
0.0.0.0:4318
.Configure su clúster HCP Consul para reenviar Envoy métrica a este receptor. Esto se puede configurar desde la estrofa
telemetryCollector
en su archivo de configuración de HCP Consul. Por ejemplo:telemetryCollector:enabled: truecustomExporterConfig: |-{"exporter_config": {"otlphttp": {"endpoint": "0.0.0.0:4318","headers": {"authorization": "<auth>"},"timeout": "2s"}}}
Ver tus datos en New Relic
En New Relic, puede ver los datos de su HCP Consul en algunos lugares diferentes:
Navegue hasta el mercado de New Relic y busque "cónsul". Haga clic en uno de los paneles para instalarlo rápidamente en su cuenta.
Navegue hasta el explorador métrica y filtre por
consul
oenvoy
por Envoy métrica. Estos datos se pueden agregar a cualquier alerta o dashboard personalizado.Sugerencia
Para ver todas las métricas disponibles con esta integración del servidor HCP Consul, consulte la documentación aquí.