🥇OpenTracing ja OpenCensus ühendamine: teed konvergentsini

Autorid: Ted Young, Pritam Shah ja „Tehniliste Spetsifikatsioonide Komitee” (Carlos Alberto, Bogdan Drutu, Sergey Kanjalev ja Yuri Shkuro).

Koostööprojekt sai nimeks: http://opentelemetry.io

Väga, väga lühidalt:

Loome uue ühtse raamatukogude ja spetsifikatsioonide kogumi telemeetriaga jälgimise võimaldamiseks. See ühendab OpenTracing ja OpenCensus projektid ning pakub toetatud viisi migreerimiseks.
Java referentsrakendus on saadaval 24. aprillil, teiste keelte rakenduste arendamine algab täielikult 8. mail 2019. Ajakava tutvumiseks leiate siit.
Septembriks 2019 on plaanis saavutada pariteet olemasolevate projektidega C#, Golangi, Java, NodeJS ja Pythoni jaoks. Meid ootab suur töö, kuid me saame hakkama, kui töötame paralleelselt. Kui olete huvitatud selle projektiga liitumisest, palun registreeruge ja andke meile teada, kuidas sooviksite kaasa aidata.
Kui igas keeles elluviimine on küps, siis vastavad OpenTracing ja OpenCensus projektid suletakse. See tähendab vanade projektide peatamist, samas kui uus projekt jätkab olemasoleva tööriistade komplekti toetamist kahe aasta jooksul, kasutades tagasipöörduvat ühildavust.

Projekt vaade

Me teeme ühinemist! Kõrgeim eesmärk on koondada OpenTracing ja OpenCensus projektid üheks üldiseks projektiks.
Uue projekti tuum moodustab puhaste ja läbi mõeldud liideste kogumi, sealhulgas traditsioonilise teegi kokkupaneku, mis rakendab neid liideseid nn SDK-dena. Tordil olev kirsiks on soovitatud standardid andmete ja juhtprotokollide jaoks, sealhulgas ühisosad infrastruktuuris.
Tulemuseks on täiendav telemeetriasüsteem, mis sobib mikroserviiside ja teiste kaasaegsete jaotatud süsteemide jälgimiseks, olles ühilduv enamiku põhjalike OSS ja kommertspõhise tarkvaraga.

Peamised sündmused

24.04 — Näidisversioon esitatud ülevaatamiseks.
8.05 — Koostatakse meeskond, mis alustab tööd kõigis keeltes.
20.05 — Projekti ametlik käivitamine Kubecon Barcelonas.
6.09 — C#, Golang, Java, NodeJS ja Pythoni rakendused on jõudnud samale tasemele kui sarnased.
6.11 — Ametlikult on projektid OpenTracing ja OpenCensus lõpetatud.
20.11 — Lahkumispidu Observability Summitil, Kubecon San Diegos, projektide lõpetamiseks.

Konvergentsi ajakava

Iga keele migreerimine hõlmab tootmisvalmis SDK kogumist, populaarsete raamatukogude tööriistakastide loomist, dokumentatsiooni koostamist, CI, tagasipöörduvuse tuge ja seotud OpenCensus ja OpenTracing projektide lõpetamist („päikeseloojang”). Oleme seadnud ambitsioonika eesmärgi, et 2019. aasta septembriks saavutada tasakaal C#, Golang, Java, NodeJS ja Python keelede jaoks. Me edastame „päikeseloojang” kuupäeva seni, kuni kõik keeled on valmis. Kuid me eelistame seda vältida.
Eesmärkide vaatamisel, palun mõelge oma isiklikule osalusele ja andke meile sellest teada, täites registreerimisvormi, või tervitades projekte Gitteri vestlustes OpenTracing ja OpenCensus. Infograafikast saab ajakava vaadata siit.

Eesmärk: esialgne mustand keeltevahelisest spetsifikatsioonist (lõpetamine 8. mail)

Oluline on töötada ühtselt, isegi kui töö käib paralleelselt erinevates keeltes. Keelevaheline spetsifikatsioon tagab projekti juhised. See võib kõlada igavalt, kuid see on garantii tervikliku süsteemi toetamiseks, mis tundub tuttav olenemata programmeerimiskeelest.

Kohustuslikud nõuded esimeseks mustandiks keele jaoks X:

Ühise terminoloogia määratlemine.
Mudeli kirjeldamine jaotatud tehingutest, statistikatest ja mõõdikest.
Selgitused oluliste küsimuste kohta, mis on tekkinud rakendamise käigus.

See eesmärk blokeerib ülejäänud tööd, esimene mustand peab olema lõpetatud 8. maiks.

Eesmärk: andmespetsi fikseerimine (valmis 6. juuliks)

Andmete spetsifikatsioon määratleb üldise andmeformaadi jälgimiste ja mõõtmete jaoks, võimaldades kõigi protsesside eksportitud andmete töötlemist sama teavitusinfrastruktuuri abil, sõltumata andmete genereerimise protsessist. Siia kuulub jälgimise andmeskeem, mis on kirjeldatud keelevahelises spetsifikatsioonis. Samuti on kaasatud metaandmete määratlemine tavaliste toimingute jaoks, millega jälgimine kasu saab: näiteks HTTP-päringud, vead ja andmebaasi päringud. Need semantilised kokkulepped on näidiseks.

Esimene mustand põhineb praegusel OpenCensus andmeformaadil ja sisaldab järgmist:

Andmeskeem, mis rakendab keelevahendite spetsifikatsiooni.
Metaandmete määratlemine tavaliste toimingute jaoks.
JSON ja Protobuf määratlemine.
Normatiivsete klientide rakendamine.

Palun pange tähele, et olemas on ka traadigeelne protokoll, mis edastab jälgimisi samas ribas ja mille me sooviksime samuti standardiseerida. Edastusformaat Trace-Context arendatakse läbi W3C.

Eesmärk: pariteet kõigis peamistes toetatud keeltes (valmis 6. septembriks)

Me peame saavutama pariteedi praeguse keele ökosüsteemi osas, asendades vanad projektid uutega.

Liideste määratlemine jälgimiseks, mõõdikute kogumiseks ja konteksti levitamiseks, tuginedes keeltevahelisele spetsifikatsioonile.
Töökorras SDK, mis rakendab neid liideseid ja ekspordib Trace-Data. Kui võimalik, luuakse SDK olemasoleva OpenCensus'i rakenduse üleviiduna.
Tööriistad populaarselt raamatukogudelt, mis on praegu kaetud OpenTracing ja OpenCensus'i poolt.

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

Uues SDK-s on OpenTracing'i olemasolevate liideste tagasipööratavad tööriistad. Need võimaldavad vanematel OpenTracing'i tööriistadel töötada koos uute tööriistadega samas protsessis, mis võimaldab kasutajatel järk-järgult oma töid üle viia.
Uue SDK valmimisel koostame värskendusplaani praegustele OpenCensus'i kasutajatele. Nagu OpenTracing'i puhul, saavad vanad tööriistad jätkuvalt töötada koos uute tööriistadega.
Novembri alguseks lõpetatakse OpenTracing ja OpenCensus muudatuste vastuvõtt. Tagasiühilduvus vanade tööriistadega säilitatakse kahe aasta jooksul.

Parima klassi SDK loomine igas keeles nõuab tohutut pingutust, ja just seda me kõige rohkem vajame.

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

Iga avatud lähtekoodiga projekti edusammude kriitiline tegur on dokumentatsioon. Me tahame, et meil oleks esmaklassiline dokumentatsioon ja koolitusvahendid, meie tehnilised kirjanikud on projekti kõige aktiivsemad arendajad. Arendajate õpetamine tarkvara õige jälgimise jaoks on üks kõige olulisemaid mõju, mida me soovime maailmas avaldada.

Alustamiseks on vajalikud järgmised dokumentatsiooni osad:

Projektiga tutvumine.
Jälgitavus 101.
Kuidas alustada.
Keele juhendid (erinevalt igaühe kohta).

Kutsume kirjutajaid igasugusest tasemest! Meie uus veebisait põhineb Hugo'l, kasutades tavalist markeeringut, seega on väga lihtne panustada.

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

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

Raamatukogude, pluginjate, paigaldajate ja muude komponentide lihtne leidmine.
Registry komponentide lihtne haldamine.
Saate uurida, millised SDK funktsioonid on iga keele jaoks saadaval.

Kui teid huvitab disain, kasutajaliides ja UX — meil on suurepärane projekt isiklikuks osalemiseks.

Eesmärk: infrastruktuur tarkvara testimiseks ja väljalaskmiseks (lõpetamine 6. septembriks)

Et jätkata usaldusväärse ja turvalise koodi tarnimist, on meil projekti kohustus luua kvaliteetsed torud tarkvara testimiseks ja väljalaskmiseks. Andke meile teada, kui saate hoolitseda testimise, jõudluse mõõtmise ja tarkvara väljalaskmise torude eest. Täpsustame tootmise valmisoleku taset, ning testimisstruktuuri küpsus on meie jaoks peamine määrav tegur.

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

Me kavatseme vanade projektide sulgemist alustada 6. septembril, kui uus projekt nendega pariteeti saavutab. Kahe kuu pärast, kui kõik keeled saavutavad pariteedi, plaanime projektide OpenTracing ja OpenCensus sulgemist. Seda tuleks mõista järgmiselt: