OpenTracing ja OpenCensus ühendamine: tee konvergentsini

Autorid: Ted Young, Pritam Shah ja "Tehniliste Spetsifikatsioonide Komitee" (Carlos Alberto, Bogdan Drutu, Sergei Kanzelev ja Yuri Shkuro).

Ühine projekt sai nimeks: http://opentelemetry.io

Väga, väga lühidalt:

• Loome uue ühtse raamatukogude ja spetsifikatsioonide komplekti telemeetria jälgimise võimaluste jaoks. See ühendab projektid OpenTracing ja OpenCensus ning pakub toetatud viisi migreerimiseks.
• Java referentsrakendus on saadaval 24. aprillil, tööd muude keelte rakendustega algavad täies mahus 8. mai 2019. aastal. Tutvu ajakava saab siit.
• September 2019 on planeeritud C#, Golang, Java, NodeJS ja Python olemasolevate projektidega pariteedi saavutamiseks. Meil on ees palju tööd, kuid me suudame selle ühiselt teha. Kui olete huvitatud osalemisest selles projektis, palun registreeruge ja tehke meile teada, kuidas soovite aidata.
• Kui iga keele rakendus on küps, suletakse vastavad projektid OpenTracing ja OpenCensus. See tähendab vana projektide külmutamist, kuid uus projekt jätkab olemasoleva tööriistakomplekti toetamist kaks aastat, säilitades tagasiühildumise.

Projekti ülevaade

Meie liitume! Kõrgeim eesmärk on koguda projektid OpenTracing ja OpenCensus ühte ühisesse projekti.
Uue projekti tuum on komplekt puhtaid ja hästi läbimõeldud liideseid, sealhulgas traditsiooniline teekide kogum, mis rakendab neid liideseid nn SDK-de vormis. Kirsiks tordil on soovituslikud standardid andmete ja juhtmeprotokollide jaoks, sealhulgas infrastruktuuri ühised osad.
Tulemus on terviklik telemeetria süsteem, mis sobib mikroteenuste ja muude kaasaegsete jaotatud süsteemide jälgimiseks, nõudes enamiku peamiste OSS-i ja kommertstoodete põhjalike programmide toetust.

Olulised sündmused

24.04 — Referentskandidaat esitatakse ülevaatamiseks.
8.05 — Koostatakse meeskond, kes hakkab töötama kõigis keeltes.
20.05 — Projekti ametlik käivitus Kubecon Barcelonas.
6.09 — Rakendused C#, Golang, Java, NodeJS ja Python saavutavad pariteedi analoogidega.
6.11 — Projektid OpenTracing ja OpenCensus lõpetatakse ametlikult.
20.11 — Lahkumispidu projektide lõpetamise auks Observability Summitel, Kubecon San Diegos.

Konvergentsi ajakava

Iga keele migratsioon hõlmab tööstuslikule rakendusele valmis SDK koostamist, populaarsed raamatukogud, dokumentatsiooni, CI, tagasipöördumise vahendeid ning OpenCensus ja OpenTracing seotud projektide sulgemist ("päikeseloojang"). Oleme seadnud ambitsioonikaks eesmärgiks septembri 2019 – saavutada pariteet C#, Golangi, Java, NodeJS ja Python keelte jaoks. Me lükkame tagasi "päikeselooja" kuupäeva, kuni kõik keeled on valmis. Eelistatavalt tuleks seda vältida.
Tuleb mõelda oma isiklikule osalusele vaadeldes eesmärke, andke meile sellest teada, täites registreerimisvormi, või tervitades projekti Gitter'i vestlustes OpenTracing ja OpenCensus. Infograafika kujul graafiku vaatamist saab siin.

Eesmärk: esialgne versioon keeltevahelisest spetsifikatsioonist (valmis 8. maiks)

Tähtis on ühiselt töötada, isegi kui töötatakse paralleelselt erinevates keeltes. Keeltevaheline spetsifikatsioon tagab projekti juhised. See kõlab ilmselt, kuid see on garantii, et terviklik süsteem toetab keelt, mis tundub tuttav igas programmeerimiskeeles.

Esialgse versiooni kohustuslikud nõuded keele X jaoks:

• Üldise terminoloogia määratlemine.
• Mudel jaotatud tehingute, statistika ja mõõdikute kirjeldamiseks.
• Tähtsate küsimuste selgitused, mis tekivad elluviimise käigus.

See eesmärk blokeerib muud tööd, esialgne versioon tuleb lõpetada 8. maiks.

Eesmärk: esimene mustand andmespetsiifikatsiooniks (valmis 6. juuliks)

Andmespetsiifikatsioon määratleb andmete üldise formaadi jälgimiseks ja mõõdikute jaoks, mistõttu kõikide protsesside poolt eksporditavad andmed saavad olla töödeldud sama telemeetriainfrastruktuuri poolt sõltumata andmete genereerimise protsessist. Siia kuulub andmeskeem jälgimismudeli jaoks, mis on kirjeldatud keeltevahelises spetsifikatsioonis. Samuti hõlmatakse metainformatsiooni määratlemisi levinud toimingute jaoks, mida jälgimine kasutab püüdmiseks: näiteks HTTP-päringud, vead ja andmebaasi päringud. Need semantilised kokkulepped on näideteks.

Esialgne versioon põhineb praegusel OpenCensus andmeformaatidel ja sisaldab järgmist:

• Andmeskeem, mis rakendab keeltevahelist spetsifikatsiooni.
• Metainformatsiooni määratlemised levinud toimingute jaoks.
• JSON ja Protobuf määratlemised.
• Standardsete klientide rakendamine.

Palun pange tähele, et on olemas ka traadiga protokoll, mis levitab jälgimist ristmikult, ja mille me soovime samuti standardiseerida. Levitusformaat Trace-Context arendatakse W3C kaudu.

Eesmärk: tasakaal kõigis peamistes toetatavates keeltes (valmimine 6. septembriks)

Peame saavutama tasakaalu praeguses keele ökosüsteemis, asendades vanad projektid uute vastu.

• Jälgimise, mõõtmise ja konteksti levitamise liidese määratlemine keelevahelise spetsifikatsiooni alusel.
• Töökorras SDK, mis rakendab neid liideseid, eksportides Trace-Data. Vajadusel luuakse SDK olemasoleva rakenduse üleviimise teel OpenCensus'ist.
• Tööriistakomplekt populaarsetele raamatukogudele, mis on praegu hõlmatud OpenTracing ja OpenCensus.

Hindame ka tagasipöördumisühtsust ja soovime tagada sujuva ülemineku olemasolevatelt projektidelt.

• Uues SDK-s on olemas tagasipöördumisühtsuse vahendid praeguste OpenTracing-i liideste jaoks. Need võimaldavad vanadel OpenTracing-i tööriistadel töötada koos uute tööriistadega samas protsessis, mis lubab kasutajatel järk-järgult oma tööd üle viia.
• Uue SDK valmimise ajal luuakse uus plaan olemasolevatele OpenCensus-i kasutajatele. Nagu OpenTracing puhul, saavad vanad tööriistad jätkata tööd koos uute tööriistadega.
• Novembriks ei aktsepteerita enam muudatusi ei OpenTracing-is ega OpenCensus-is. Tagasipöördumisühtsus vanade tööriistadega säilitada järgneva kahe aasta jooksul.

Parima kvaliteediga SDK loomine iga keele jaoks nõuab tohutult tööd, ja just seda vajame kõige enam.

Eesmärk: põhidokumentatsioon (valmimine 6. septembriks)

Iga avatud lähtekoodiga projekti eduka teguri on dokumentatsioon. Soovime, et meil oleks esmaklassiline dokumentatsioon ja koolitustooted, meie tehnilised kirjanikud on projekti kõige aktiivsemad arendajad. Arendajate koolitamine tarkvara õigeks jälgimiseks on üks kõige olulisemaid mõjusid, mida soovime maailmale avaldada.

Alustamiseks on hädavajalikud järgmised dokumentatsiooni osad:

• Projekti suunised.
• Jälgimine 101.
• Alustamine.
• Keeleded keeltest (igal ühel eraldi).

Kutsume igasuguse tasemega kirjanikke! Meie uus veebisait põhineb Hugo'l, kasutades lihtsat märgendust, nii et on väga lihtne panustada.

Eesmärk: Registry v1.0 (valmise saamine 6. juuliks)

Registry — veel üks kriitiliselt oluline komponent, täiustatud versioon OpenTracing Registry.

• Sirvige raamatukogusid, pluginaid, installereid ja muid komponente kergesti.
• Registry komponentide lihtne haldamine.
• Saate teada, millised SDK funktsioonid on saadaval igas keeles.

Kui teid huvitab disain, liides ja UX – meil on suurepärane projekt, kus saate isiklikult osaleda.

Eesmärk: tarkvara testimise ja väljaandmise infrastruktuuri loomine (valmise saamine 6. septembriks)

Kuna soovime jätkata usaldusväärse ja turvalise koodi tarnimist, on meil projektipõhine kohustus luua kvaliteetsed testimise ja väljaandmise konveierid. Palun andke meile teada, kui saate tegeleda testimise, jõudluse mõõtmise ja tarkvara väljaandmise konveieritega. Me määratleme tootmise valmiduse taseme ning testimisinfra küpsus on meie jaoks peamine tegur.

Eesmärk: OpenTracing ja OpenCensus projektide lõpetamine (valmise saamine 6. novembriks)

Planeerime vanade projektide sulgemise algust 6. septembril, kui uus projekt saavutab nendega pariteedi. Kaks kuud hiljem, kui kõik keeled saavutavad pariteedi, plaanime lõpetada OpenTracing ja OpenCensus projektid. See tuleks mõista nii:

• reposiit toetavad ning muudatusi ei toimu enam.
• praegusele tööriistakomplektile on kavandatud kaheaastane toetuse aeg.
• kasutajad saavad uuendada uuele SDK-le, kasutades vana tööriistakomplekti.
• järk-järgult uuendamine on võimalik.

Liituge

Oleme igasuguse abi eest tänulikud, kuna see on tohutu projekt. Kui olete huvitatud jälgimisest – nüüd on õige aeg!

• Täida registreerimisvormi otse osalemiseks ja meeskonda liitumiseks.
• Võtke meiega ühendust kanalitel OpenTracing ja OpenCensus Gitter.
• Tutvuge Java viidene versioon, mis on töös.

Allikas: habr.com