Monitor Jenkins com o plug-in OpenTelemetry visualizando jobs e execuções de pipeline como rastreamento distribuído. Você também pode instalar o início rápido para obter um dashboard pré-construído para monitor seu pipeline Jenkins.
Pré-requisitos
Você precisa primeiro instalar o plug-in OpenTelemetry do Jenkins:
- Log no Jenkins.
- No dashboard, clique em Manage Jenkins.
- Em Configuração do sistema, clique em Plugins.
- Clique na guia Available plugins e procure por OpenTelemetry.
- Marque a caixa de seleção OpenTelemetry e Install without restart.
- Assim que a instalação for concluída, clique em Manage Jenkins.
- Em System Configuration, clique em System.
- Role para baixo e procure uma seção chamada OpenTelemetry. Se você não consegue ver, reinicie o Jenkins.
Configuração
Você precisa de um New Relic OTLP endpoint e um para configurar o OpenTelemetry plug-in Jenkins para enviar dados ao New Relic.
- Insira um endpoint OTLP. Por exemplo,
https://otlp.nr-data.net:4317
. - Para autenticação, selecione Header Authentication: a. No campo Header Name , insira api-key. b. No campo Header Value , insira um texto secreto contendo sua chave de licença de ingestão do New Relic.
- Salve as alterações.
Se você não tiver um texto secreto criado com sua chave de licença do New Relic, clique no botão + Add e selecione Jenkins Credentials Provider para criar um. Você pode manter os valores padrão, exceto kind e secret e description é opcional.
- No dropdown Kind, selecione Secret text.
- No campo secret , insira sua chave de licença de ingestão do New Relic.
- Opcionalmente, adicione uma descrição para indicar para que serve o texto secreto.
Validação
Execute um trabalho ou crie um novo pipeline para ver os dados do Jenkins no New Relic. Veja como construir um pipeline:
- Log no Jenkins e clique em New Item.
- Insira um nome de item, clique em Pipeline e depois em OK.
- Role para baixo até a seção Pipeline .
- Use o script Pipeline e selecione uma opção no dropdown try sample Pipeline... .
- Clique em Salvar.
- No pipeline recém-criado, clique em Build Now.
- Cheguei a one.newrelic.com > All capabilities > APM & services > Services - OpenTelemetry > jenkins.
- Clique em Distributed tracing para visualizar jobs e execuções de pipeline.
- Clique em Logs para ver o registro do console Jenkins. Se não houver log, verifique se a variável de ambiente
OTEL_LOGS_EXPORTER="otlp"
está definida.
Instale o dashboard de início rápido do Jenkins
Depois de enviar os dados do pipeline Jenkins para o New Relic, você também pode monitor facilmente seus trabalhos e execuções de pipeline com o dashboard pré-construído do New Relic Instant observabilidade. Comece em minutos com um dashboard pré-construído para ver as principais métricas em uma visão consolidada:
- Acesse o início rápido do Jenkins em New Relic Instant observabilidade e clique em + Install now.
- Selecione uma conta e clique em Begin installation.
- Se você já tiver concluído a validação, selecione done para passar para a próxima etapa.
- O quickstart implantar os recursos em sua conta. Clique em see your data para acessar o dashboard.
Importante
O plug-in Jenkins OpenTelemetry não é mantido pela New Relic, portanto, se você tiver algum problema com a instrumentação, crie um novo problema no repositório GitHub do plug-in.