Cómo instalar y usar el complemento Open Telemetry Jenkins
OpenTelemetry es un marco de observabilidad de código abierto que proporciona una forma consistente de recopilar, procesar y exportar datos de telemetría de sus aplicaciones e infraestructura. Operentelemetry proporciona una forma única en neutral de proveedores de proveedores para instrumentar sus aplicaciones e infraestructura para que pueda obtener información sobre su rendimiento, comportamiento y uso.
Los datos de telemetría incluyen métricas, rastros y registros. Operentelemetry proporciona API y bibliotecas para generar y recopilar constantemente estos datos. Los datos recopilados se pueden exportar a varios sistemas de back -end, como herramientas de monitoreo y análisis de registro, para su posterior análisis y visualización.
Opentelemetry está diseñada para ser extensible, lo que le permite usarla para instrumentar una amplia gama de tecnologías, incluidas aplicaciones nativas de nube, microservicios y aplicaciones monolíticas tradicionales. También es compatible con varios lenguajes de programación, incluyendo Go, Java, .Red, nodo.JS, Python y Ruby.
Este tutorial le enseñará cómo instalar y monitorear sus tuberías de Jenkins utilizando el complemento OpenTelemetry.
Configuración de clúster
No dude en usar su configuración de Jenkins. Para este tutorial, sin embargo, tenemos:
- Un controlador de Jenkins que se ejecuta en Debian 11
- El complemento Ocean Blue instalado en Jenkins
- Docker instalado en nuestro sistema
Instalación del complemento OperElemetry
El primer paso es instalar y configurar el complemento OpenTelemetry en el controlador Jenkins.
Comience iniciando sesión en su controlador y navegando al Panel Jenkins.
A continuación, navegue para administrar Jenkins -> Administrar complementos -> complementos disponibles y busque "OpenElemety."
Una vez instalado, reinicie a Jenkins para aplicar los cambios para el complemento OperentElemetry.
Configuración del proyecto de muestra
Para este proyecto, utilizaremos OperElemetry y Jaegar como el backend. El enlace al proyecto de muestra se muestra a continuación:
https: // github.com/abre-telemetry/opentelemetry-colector-contrib/árbol/main/ejemplos/demostración
Clon el repositorio:
Git clon https: // github.com/abre-telemetry/opentelemetry-colector-contrib.git
Navegue al directorio de ejemplos/demonios:
$ CD OPENTELEMETRY-COLLECTOR-Contrib/Ejemplos/Demo
Ejecute las aplicaciones del cliente y del servidor utilizando el comando Docker-Compose como:
$ Docker -Compose Up -d
Una vez que los contenedores están en funcionamiento, podemos configurar el complemento OpenTelemetry en el controlador Jenkins.
Configurar el complemento OperTelemetry
Abra el tablero de Jenkins y navegue para administrar Jenkins -> Configurar el sistema.
Desplácese hacia abajo hasta llegar a la sección OperElemetry.
Regrese a su terminal y ejecute el comando:
$ Docker-Compose PS
El comando debe enumerar todos los contenedores en ejecución y los detalles de las aplicaciones disponibles.
En nuestro caso, estamos interesados en la aplicación que se ejecuta en el puerto 4317 y a qué puerto está asignado en el exterior.
En nuestro caso, podemos ver que el puerto 4317 en el contenedor se asigna al puerto 4317 en el sistema de host.
A continuación, regrese al tablero de Jenkins y configure el punto final OTLP como http: // localhost: 4317
Reemplace el puerto 4317 con el número de puerto que obtuvo en el comando anterior.
En la sección de autenticación, seleccione "Sin autenticación."
En la sección de visualización, seleccione "Agregar backend de observabilidad de visualización" y elija "Jaeger.
Ingrese la URL de la base de Jaeger desde el contenedor Docker como:
http: //: jaeger_ip>
En nuestro ejemplo, Jeage Port 16686 se asigna al puerto 16686 en el sistema de host. Por lo tanto, la dirección de Jaeger será:
http: // localhost: 16686
Configurar un trabajo de Jenkins
El siguiente paso es configurar un trabajo de muestra de Jenkins. En el tablero de Jenkins, seleccione "Nuevo elemento."Dale al trabajo un nuevo nombre y seleccione el tipo de trabajo como tubería.
En la sección de la tubería, agregue un script de tuberías como se proporciona a continuación:
tubería
agente cualquiera
herramientas
Maven "Maven"
etapas
etapa ('construir')
pasos
git "https: // github.com/Jenkins-Docs/Simple-Java-Maven-App.git "
SH 'MVN -B -DSKIPTESTS PAQUETE CLEAN'
etapa ('test')
pasos
sh 'test mvn'
correo
siempre
Junit 'Target/Surefire-Reports/*.xml '
etapa ('entregar')
pasos
mierda./jenkins/scripts/entregar.mierda
La tubería anterior requiere que tenga Maven configurado en su controlador Jenkins. Consulte nuestro tutorial sobre la configuración de Maven en Jenkins para obtener más información.
Finalmente, haga clic en Guardar para guardar el script de la tubería y haga clic en "Build Now" para iniciar el proceso de compilación.
Para ver el proceso de compilación en Jaeger, haga clic en "Ver Pipeline con Jaeger".
Esto debería abrir la interfaz de usuario de Jaeger con los detalles de la construcción de la tubería.
Conclusión
Este tutorial cubrió la instalación y el uso del complemento OpenTelemetry Jenkins y visualiza las compilaciones de la tubería usando Jeager.