Monitor Jenkins con el complemento OpenTelemetry visualizando trabajos y ejecuciones de canalizaciones como rastreo distribuido. También puede instalar el inicio rápido para obtener un dashboard prediseñado para monitor su canalización de Jenkins.
Requisitos previos
Primero debe instalar el complemento OpenTelemetry de Jenkins:
- Log en Jenkins.
- Desde el dashboard, haga clic en Manage Jenkins.
- En Configuración del sistema, haga clic en Plugins.
- Haga clic en la pestaña Available plugins y busque OpenTelemetry.
- Seleccione la casilla de verificación OpenTelemetry y Install without restart.
- Una vez completada la instalación, haga clic en Manage Jenkins.
- En System Configuration, haga clic en System.
- Desplácese hacia abajo y busque una sección llamada OpenTelemetry. Si no puede verlo, reinicie Jenkins.
Configuración
Necesita un New Relic extremo OTLP y un para configurar el complemento Jenkins OpenTelemetry para enviar datos a New Relic.
- Introduzca un extremo OTLP. Por ejemplo,
https://otlp.nr-data.net:4317
. - Para autenticación, seleccione Header Authentication: a. En el campo Header Name , ingrese api-key. b. En el campo Header Value , ingrese un texto secreto que contenga su clave de licencia de ingesta de New Relic.
- Guarde los cambios.
Si no tiene un texto secreto creado con su clave de licencia de New Relic, haga clic en el botón + Add y seleccione Jenkins Credentials Provider para crear uno. Puede mantener los valores predeterminados excepto kind y secret y el description es opcional.
- En el menú desplegable Kind , seleccione Secret text.
- En el campo secret , ingrese su clave de licencia de ingesta de New Relic.
- Opcionalmente, agregue una descripción para indicar para qué sirve el texto secreto.
Validación
Ejecute un trabajo o cree una nueva canalización para ver los datos de Jenkins en New Relic. A continuación se explica cómo construir una tubería:
- Log en Jenkins y haga clic en New Item.
- Introduzca un nombre de elemento, haga clic en Pipeline y luego OK.
- Desplácese hasta el final de la sección Pipeline .
- Utilice la script Pipeline y seleccione una opción del menú desplegable try sample Pipeline....
- Clic en Guardar.
- En la canalización recién creada, haga clic en Build Now.
- Llegué a one.newrelic.com > All capabilities > APM & services > Services - OpenTelemetry > jenkins.
- Haga clic en Distributed tracing para visualizar trabajos y ejecuciones de canalizaciones.
- Haga clic en Logs para ver el log de su consola Jenkins. Si no hay ningún log, verifique que la variable de entorno
OTEL_LOGS_EXPORTER="otlp"
esté configurada.
Instale el dashboard de inicio rápido de Jenkins
Después de haber enviado los datos de su canalización de Jenkins a New Relic, también puede monitor fácilmente sus trabajos y ejecuciones de canalización con el dashboard prediseñado de New Relic Instant observabilidad. Comience en minutos con un dashboard prediseñado para ver las métricas clave en una vista consolidada:
- Vaya al inicio rápido de Jenkins en Observabilidad instantánea de New Relic y haga clic en + Install now.
- Seleccione una cuenta y haga clic en Begin installation.
- Si ya completó la validación, seleccione done para pasar al siguiente paso.
- El inicio rápido desplegar los recursos a su cuenta. Haga clic en see your data para acceder al dashboard.
Importante
Si el nombre de su servicio (OTEL_SERVICE_NAME
) está configurado como algo distinto de jenkins
, actualice las condiciones WHERE
de entity.name
en el dashboard prediseñado para usar el nombre de servicio configurado.
Importante
New Relic no mantiene el complemento Jenkins OpenTelemetry, por lo que si tiene algún problema con la instrumentación, cree un nuevo problema en el repositorio de GitHub del complemento.