🥇Sammanslagning av OpenTracing och OpenCensus: vägen mot konvergens

Författare: Ted Yang, Pritam Shah och "Tekniska specifikationskommittén" (Carlos Alberto, Bogdan Drutu, Sergey Kanjelyev och Yuri Shkuro).

Det gemensamma projektet har fått namnet: http://opentelemetry.io

Väldigt, väldigt kort:

Vi skapar en ny enhetlig uppsättning bibliotek och specifikationer för att möjliggöra övervakning av telemetri. Den kommer att förena projekten OpenTracing och OpenCensus samt erbjuda ett stödfullständigt sätt för migrering.
Referensimplementationen i Java kommer att finnas tillgänglig den 24 april, och arbetet med implementationerna på andra språk kommer börja fullt ut den 8 maj 2019. Bekanta dig med schemat här.
Paritet med befintliga projekt för C#, Golang, Java, NodeJS och Python är planerad senast september 2019. Vi har mycket arbete framför oss, men vi klarar det om vi arbetar parallellt. Om du är intresserad av att delta i detta projekt, vänligen registrera dig och låt oss veta hur du vill bidra.
När implementationen på varje språk har mognat kommer de relevanta projekten OpenTracing och OpenCensus att stängas. Detta innebär att gamla projekt kommer att frysas, medan det nya projektet fortsätter att stödja det befintliga verktyget under två år, med bakåtkompatibilitet.

Projektöversikt

Vi genomför en sammanslagning! Det högsta målet är att samla projekten OpenTracing och OpenCensus i ett gemensamt projekt.
Kärnan i det nya projektet kommer att vara en uppsättning rena och genomtänkta gränssnitt, inklusive den traditionella sammanställningen av bibliotek som implementerar dessa gränssnitt i form av så kallade SDK. Kicken kommer att vara rekommenderade standarder för data och trådade protokoll, inklusive gemensamma delar av infrastrukturen.
Resultatet kommer att bli ett fullständigt telemetrisystem lämpligt för övervakning av mikrotjänster och andra typer av moderna distribuerade system, kompatibelt med de flesta stora OSS och kommersiella grundprogram.

Huvudhändelser

24.04 — Referenskandidaten tillhandahålls för granskning.
8.05 — Ett team formas som börjar arbeta på alla språk.
20.05 — Det officiella lanseringen av projektet på Kubecon Barcelona.
6.09 — Implementationer på C#, Golang, Java, NodeJS och Python når paritet med motsvarigheterna.
6.11 — Den officiella avslutningen av projekten OpenTracing och OpenCensus.
20.11 — Avskedsfest för avslutningen av projekten på Observability Summit, Kubecon San Diego.

Tidslinje för konvergens

Migration for each language involves assembling an SDK ready for production deployment, tools for popular libraries, documentation, CI, backward compatibility tools, and closing related OpenCensus and OpenTracing projects (the "sunset"). We set an ambitious goal for September 2019 — to achieve parity for C#, Golang, Java, NodeJS, and Python. We will shift the "sunset" date until all languages are ready. However, it is preferable to avoid this.
When reviewing goals, please consider your personal involvement and let us know by filling out the registration form, or by greeting in the Gitter chats of the OpenTracing och OpenCensus. You can view the timeline in infographic format här.

Goal: first draft of the cross-language specification (completion by May 8)

It is important to work cohesively, even when working in parallel across different languages. The cross-language specification provides guidance for the project. It sounds prosaic, but it guarantees support for a coherent system that feels familiar regardless of programming language.

Mandatory requirements for the first draft of the specification for language X:

Definitions of common terminology.
A model for describing distributed transactions, statistics, and metrics.
Clarifications on important issues that have arisen during implementation.

This goal blocks other work, the first draft must be completed by May 8.

Goal: first draft for the data specification (completion by July 6)

The data specification defines a common data format for traces and metrics, allowing data exported from all processes to be processed by the same telemetry infrastructure regardless of the data generation process. This includes a data schema for the tracing model as described in the cross-language specification. It also includes definitions of metadata for common operations that tracing uses to capture: for example, HTTP requests, errors, and database queries. These semantic agreements are examples.

The first draft is based on the current OpenCensus data format and will contain the following:

A data schema implementing the cross-language specification.
Definitions of metadata for common operations.
Definitions for JSON and Protobuf.
Reference client implementation.

Vi ber er att notera att det också finns ett trådat protokoll som sprider spårningar i intrabandsformat, och som vi också skulle vilja standardisera. Spridningsformatet Trace-Context utvecklas genom W3C.

Mål: Paritet över alla huvudstödda språk (färdigställande senast den 6 september)

Vi måste uppnå paritet för det nuvarande språkekosystemet genom att ersätta gamla projekt med nya.

Definitioner av gränssnitt för spårning, mätningar och kontextspridning baserat på ett språköverskridande specifikation.
Ett färdigt SDK som implementerar dessa gränssnitt och exporterar Trace-Data. Om möjligt kommer SDK:n att skapas genom att överföra en befintlig implementation från OpenCensus.
Verktyg för populära bibliotek som för närvarande omfattas av OpenTracing och OpenCensus.

Vi värdesätter också bakåtkompatibilitet och vill säkerställa en smidig övergång från befintliga projekt.

Det nya SDK:t kommer att innehålla verktyg för bakåtkompatibilitet med nuvarande OpenTracing-gränssnitt. Dessa kommer att göra att föråldrade OpenTracing-verktyg kan fungera ihop med nya verktyg i samma process, vilket låter användarna gradvis överföra sina lösningar.
När det nya SDK:t är klart kommer en uppdateringsplan att skapas för nuvarande användare av OpenCensus. Precis som med OpenTracing kommer föråldrade verktyg att kunna fortsätta fungera tillsammans med nya.
Till november kommer både OpenTracing och OpenCensus att stängas för ändringar. Bakåtkompatibilitet med föråldrade verktyg kommer att stödjas under två år.

Att skapa ett bästa i sitt slag SDK för varje språk kräver enormt arbete, och det är just här vi behöver mest hjälp.

Mål: Grundläggande dokumentation (färdigställande senast den 6 september)

En kritisk framgångsfaktor för alla öppen källkod-projekt är dokumentationen. Vi vill ha förstklassig dokumentation och utbildningsresurser, våra tekniska författare är de mest aktiva utvecklarna i projektet. Att lära utvecklare om korrekt observationsmetodik för mjukvara är en av de viktigaste påverkan vi vill ha på världen.

Följande delar av dokumentationen är minimalt nödvändiga för att komma igång:

Projektöversikt.
Observabilitet 101.
Komma igång.
Språkguider (var och en för sig).

Vi bjuder in skribenter på alla nivåer! Vår nya webbplats är baserad på Hugo och använder vanlig markup, så det är ganska enkelt att bidra.

Mål: Registry v1.0 (färdigställande senast den 6 juli)

Registry – en annan kritisk komponent, en förbättrad version OpenTracing Registry.

Lätt att hitta bibliotek, plugins, installatörer och andra komponenter.
Enkelt att hantera komponenterna i Registry.
Du kan ta reda på vilka SDK-funktioner som är tillgängliga på varje språk.

Om du är intresserad av design, gränssnitt och UX – vi har ett utmärkt projekt för personlig medverkan.

Mål: Infrastruktur för testning och distribution av programvara (färdigställande senast den 6 september)

För att vi ska kunna fortsätta leverera säker kod som man kan lita på har vi en projektåtagande att skapa kvalitativa pipelines för testning och distribution av programvara. Vänligen meddela oss om du kan ta hand om pipelines för testning, prestationsmätning och programvarudistribution. Vi markerar tydligt produktionsberedskapsnivån, och mognaden av testinfrastrukturen kommer att vara en avgörande faktor för oss.

Mål: Avslut av projekten OpenTracing och OpenCensus (färdigställande senast den 6 november)

Vi planerar att påbörja avstängning av gamla projekt den 6 september, om det nya projektet uppnår paritet med dem. Två månader senare, vid paritet för alla språk, planerar vi att avsluta projekten OpenTracing och OpenCensus. Detta ska förstås som att:

arkiven kommer att frysas, inga ytterligare ändringar kommer att göras.
för det nuvarande verktyget är en tvåårig supportperiod planerad.
användare kommer att kunna uppgradera till den nya SDK:n med det tidigare verktyget.
det kommer att vara möjligt med gradvis uppgradering.