Hvordan installere og bruke åpen telemetri Jenkins -plugin

OpenLemetry er et rammeverk for åpen kildekode som gir en konsekvent måte å samle inn, behandle og eksportere telemetri-data fra applikasjoner og infrastruktur. OpenLemetry gir en enkelt, leverandørnøytral måte å instrulere applikasjoner og infrastruktur, slik at du kan få innsikt i ytelsen, atferden og bruken.

Telemetri -data inkluderer beregninger, spor og logger. OpenLemetry gir APIer og biblioteker for å generere og konsekvent samle inn disse dataene. De innsamlede dataene kan deretter eksporteres til forskjellige backend -systemer, for eksempel overvåknings- og logganalyseverktøy, for videre analyse og visualisering.

OpenTelemetry er designet for å være utvidbar, slik at du kan bruke den til å instrulere et bredt spekter av teknologier, inkludert sky-innfødte applikasjoner, mikroservices og tradisjonelle monolitiske applikasjoner. Den støtter også forskjellige programmeringsspråk, inkludert Go, Java, .Nett, node.JS, Python og Ruby.

Denne opplæringen vil lære deg hvordan du installerer og overvåker Jenkins -rørledningene dine ved hjelp av OpenLemetry -plugin.

Klyngeoppsett

Bruk gjerne Jenkins -konfigurasjonen din. For denne opplæringen har vi imidlertid:

1. En Jenkins -kontroller som kjører på Debian 11
2. Blue Ocean Plugin installert på Jenkins
3. Docker installert på systemet vårt

Installere OpenTelemetry -plugin

Det første trinnet er å installere og konfigurere OpenTelemetry -plugin på Jenkins -kontrolleren.

Begynn med å logge deg på kontrolleren din og navigere til Jenkins -dashbordet.

Naviger deretter for å administrere Jenkins -> Administrer plugins -> Tilgjengelige plugins og søk etter “OpenLemetry.”

Når den er installert, kan du starte Jenkins for å bruke endringene for OpenTelemetry -plugin.

Sette opp prøveprosjekt

For dette prosjektet vil vi bruke OpenLemetry og Jaegar som backend. Koblingen til prøveprosjektet vises nedenfor:

https: // github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/eksempler/demo

Klon depotet:

git klon https: // github.com/open-telemetry/opentelemetry-Collector-Contrerib.git

Naviger inn i eksemplene/demonkatalogen:

$ CD OpenTelemetry-Collector-Contrerib/Eksempler/Demo

Kjør klient- og serverapplikasjonene ved å bruke Docker-Compose-kommandoen som:

$ docker -compose up -d

Når containerne er i gang, kan vi sette opp OpenTelemetry -plugin på Jenkins -kontrolleren.

Konfigurer OpenTelemetry -plugin

Åpne Jenkins -dashbordet og naviger for å administrere Jenkins -> Konfigurasjonssystem.

Bla ned til du kommer til OpenTelemetry -delen.

Gå tilbake til terminalen din og kjør kommandoen:

$ Docker-Compose Ps

Kommandoen skal liste opp alle løpsbeholderne og detaljene for tilgjengelige applikasjoner.

I vårt tilfelle er vi interessert i at applikasjonen kjører på port 4317 og til hvilken port den er kartlagt på utsiden.

I vårt tilfelle kan vi se at port 4317 på beholderen er kartlagt til port 4317 på vertssystemet.

Neste, gå tilbake til Jenkins -dashbordet og sett OTLP -endepunktet som http: // localhost: 4317

Erstatt port 4317 med portnummeret du hentet i forrige kommando.

I godkjenningsdelen velger du “Ingen autentisering.”

I visualiseringsseksjonen velger du "Legg til visualiseringsobservasjonsbackend" og velg "Jaeger.

Skriv inn Jaeger Base URL fra Docker -beholderen som:

http: //: jaeger_ip>

I vårt eksempel er Jeager Port 16686 kartlagt til Port 16686 på vertssystemet. Derfor vil Jaeger -adressen være:

http: // localhost: 16686

Sette opp en Jenkins -jobb

Neste trinn er å sette opp en prøve Jenkins -jobb. Velg “Nytt element på Jenkins Dashboard.”Gi jobben et nytt navn og velg jobbtypen som rørledning.

I rørledningen, legg til et rørledningsskript som angitt nedenfor:

rørledning
agent noen
verktøy
Maven "Maven"

Stadier
scene ('build')
trinn
git "https: // github.com/jenkins-docs/simple-java-maven-app.Git "
sh 'mvn -b -dskiptests ren pakke'


scene ('test')
trinn
SH 'MVN Test'

post
alltid
Junit 'Target/Surefire-Reports/*.xml '



scene ('levere')
trinn
sh './jenkins/manus/levere.sh '

Rørledningen ovenfor krever at du har Maven konfigurert på Jenkins -kontrolleren din. Sjekk opplæringen vår om å sette opp Maven på Jenkins for å lære mer.

Til slutt klikker du på Lagre for å lagre rørledningsskriptet og klikk på "Bygg nå" for å starte byggeprosessen.

For å se byggeprosessen i Jaeger, klikker du på "Vis rørledning med Jaeger".

Dette skal åpne Jaeger UI med detaljene i rørledningsbyggingen.

Konklusjon

Denne opplæringen dekket å installere og bruke OpenTelemetry Jenkins -plugin og visualisere rørledningen Builds ved hjelp av Jeager.